]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #98503 - RalfJung:scope-race, r=m-ou-se
[rust.git] / RELEASES.md
1 Version 1.62.0 (2022-06-30)
2 ==========================
3
4 Language
5 --------
6
7 - [Stabilize `#[derive(Default)]` on enums with a `#[default]` variant][94457]
8 - [Stop validating some checks in dead code after functions with uninhabited return types][93313]
9 - [Fix constants not getting dropped if part of a diverging expression][94775]
10 - [Support unit struct/enum variant in destructuring assignment][95380]
11 - [Remove mutable_borrow_reservation_conflict lint and allow the code pattern][96268]
12
13 Compiler
14 --------
15
16 - [linker: Stop using whole-archive on dependencies of dylibs][96436]
17 - [Make `unaligned_references` lint deny-by-default][95372]
18   This lint is also a future compatibility lint, and is expected to eventually
19   become a hard error.
20 - [Only add codegen backend to dep info if -Zbinary-dep-depinfo is used][93969]
21 - [Reject `#[thread_local]` attribute on non-static items][95006]
22 - [Add tier 3 `aarch64-pc-windows-gnullvm` and `x86_64-pc-windows-gnullvm` targets\*][94872]
23 - [Implement a lint to warn about unused macro rules][96150]
24 - [Promote `x86_64-unknown-none` target to Tier 2\*][95705]
25
26 \* Refer to Rust's [platform support page][platform-support-doc] for more
27    information on Rust's tiered platform support.
28
29 Libraries
30 ---------
31
32 - [Windows: Use a pipe relay for chaining pipes][95841]
33 - [Replace Linux Mutex and Condvar with futex based ones.][95035]
34 - [Replace RwLock by a futex based one on Linux][95801]
35 - [std: directly use pthread in UNIX parker implementation][96393]
36
37 Stabilized APIs
38 ---------------
39
40 - [`bool::then_some`]
41 - [`f32::total_cmp`]
42 - [`f64::total_cmp`]
43 - [`Stdin::lines`]
44 - [`windows::CommandExt::raw_arg`]
45 - [`impl<T: Default> Default for AssertUnwindSafe<T>`]
46 - [`From<Rc<str>> for Rc<[u8]>`][rc-u8-from-str]
47 - [`From<Arc<str>> for Arc<[u8]>`][arc-u8-from-str]
48 - [`FusedIterator for EncodeWide`]
49 - [RDM intrinsics on aarch64][stdarch/1285]
50
51 Clippy
52 ------
53
54 - [Create clippy lint against unexpectedly late drop for temporaries in match scrutinee expressions][94206]
55
56 Cargo
57 -----
58
59 - Added the `cargo add` command for adding dependencies to `Cargo.toml` from
60   the command-line.
61   [docs](https://doc.rust-lang.org/nightly/cargo/commands/cargo-add.html)
62 - Package ID specs now support `name@version` syntax in addition to the
63   previous `name:version` to align with the behavior in `cargo add` and other
64   tools. `cargo install` and `cargo yank` also now support this syntax so the
65   version does not need to passed as a separate flag.
66 - The `git` and `registry` directories in Cargo's home directory (usually
67   `~/.cargo`) are now marked as cache directories so that they are not
68   included in backups or content indexing (on Windows).
69 - Added automatic `@` argfile support, which will use "response files" if the
70   command-line to `rustc` exceeds the operating system's limit.
71
72 Compatibility Notes
73 -------------------
74
75 - `cargo test` now passes `--target` to `rustdoc` if the specified target is
76   the same as the host target.
77   [#10594](https://github.com/rust-lang/cargo/pull/10594)
78 - [rustdoc: Remove .woff font files][96279]
79 - [Enforce Copy bounds for repeat elements while considering lifetimes][95819]
80
81 Internal Changes
82 ----------------
83
84 - [Unify ReentrantMutex implementations across all platforms][96042]
85
86 These changes provide no direct user facing benefits, but represent significant
87 improvements to the internals and overall performance of rustc
88 and related tools.
89
90 [93313]: https://github.com/rust-lang/rust/pull/93313/
91 [93969]: https://github.com/rust-lang/rust/pull/93969/
92 [94206]: https://github.com/rust-lang/rust/pull/94206/
93 [94457]: https://github.com/rust-lang/rust/pull/94457/
94 [94775]: https://github.com/rust-lang/rust/pull/94775/
95 [94872]: https://github.com/rust-lang/rust/pull/94872/
96 [95006]: https://github.com/rust-lang/rust/pull/95006/
97 [95035]: https://github.com/rust-lang/rust/pull/95035/
98 [95372]: https://github.com/rust-lang/rust/pull/95372/
99 [95380]: https://github.com/rust-lang/rust/pull/95380/
100 [95431]: https://github.com/rust-lang/rust/pull/95431/
101 [95705]: https://github.com/rust-lang/rust/pull/95705/
102 [95801]: https://github.com/rust-lang/rust/pull/95801/
103 [95819]: https://github.com/rust-lang/rust/pull/95819/
104 [95841]: https://github.com/rust-lang/rust/pull/95841/
105 [96042]: https://github.com/rust-lang/rust/pull/96042/
106 [96150]: https://github.com/rust-lang/rust/pull/96150/
107 [96268]: https://github.com/rust-lang/rust/pull/96268/
108 [96279]: https://github.com/rust-lang/rust/pull/96279/
109 [96393]: https://github.com/rust-lang/rust/pull/96393/
110 [96436]: https://github.com/rust-lang/rust/pull/96436/
111 [96557]: https://github.com/rust-lang/rust/pull/96557/
112
113 [`bool::then_some`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then_some
114 [`f32::total_cmp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.total_cmp
115 [`f64::total_cmp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.total_cmp
116 [`Stdin::lines`]: https://doc.rust-lang.org/stable/std/io/struct.Stdin.html#method.lines
117 [`impl<T: Default> Default for AssertUnwindSafe<T>`]: https://doc.rust-lang.org/stable/std/panic/struct.AssertUnwindSafe.html#impl-Default
118 [rc-u8-from-str]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#impl-From%3CRc%3Cstr%3E%3E
119 [arc-u8-from-str]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#impl-From%3CArc%3Cstr%3E%3E
120 [stdarch/1285]: https://github.com/rust-lang/stdarch/pull/1285
121 [`windows::CommandExt::raw_arg`]: https://doc.rust-lang.org/stable/std/os/windows/process/trait.CommandExt.html#tymethod.raw_arg
122 [`FusedIterator for EncodeWide`]: https://doc.rust-lang.org/stable/std/os/windows/ffi/struct.EncodeWide.html#impl-FusedIterator
123
124 Version 1.61.0 (2022-05-19)
125 ==========================
126
127 Language
128 --------
129
130 - [`const fn` signatures can now include generic trait bounds][93827]
131 - [`const fn` signatures can now use `impl Trait` in argument and return position][93827]
132 - [Function pointers can now be created, cast, and passed around in a `const fn`][93827]
133 - [Recursive calls can now set the value of a function's opaque `impl Trait` return type][94081]
134
135 Compiler
136 --------
137
138 - [Linking modifier syntax in `#[link]` attributes and on the command line, as well as the `whole-archive` modifier specifically, are now supported][93901]
139 - [The `char` type is now described as UTF-32 in debuginfo][89887]
140 - The [`#[target_feature]`][target_feature] attribute [can now be used with aarch64 features][90621]
141 - X86 [`#[target_feature = "adx"]` is now stable][93745]
142
143 Libraries
144 ---------
145
146 - [`ManuallyDrop<T>` is now documented to have the same layout as `T`][88375]
147 - [`#[ignore = "…"]` messages are printed when running tests][92714]
148 - [Consistently show absent stdio handles on Windows as NULL handles][93263]
149 - [Make `std::io::stdio::lock()` return `'static` handles.][93965] Previously, the creation of locked handles to stdin/stdout/stderr would borrow the handles being locked, which prevented writing `let out = std::io::stdout().lock();` because `out` would outlive the return value of `stdout()`. Such code now works, eliminating a common pitfall that affected many Rust users.
150 - [`Vec::from_raw_parts` is now less restrictive about its inputs][95016]
151 - [`std::thread::available_parallelism` now takes cgroup quotas into account.][92697] Since `available_parallelism` is often used to create a thread pool for parallel computation, which may be CPU-bound for performance, `available_parallelism` will return a value consistent with the ability to use that many threads continuously, if possible. For instance, in a container with 8 virtual CPUs but quotas only allowing for 50% usage, `available_parallelism` will return 4.
152
153 Stabilized APIs
154 ---------------
155
156 - [`Pin::static_mut`]
157 - [`Pin::static_ref`]
158 - [`Vec::retain_mut`]
159 - [`VecDeque::retain_mut`]
160 - [`Write` for `Cursor<[u8; N]>`][cursor-write-array]
161 - [`std::os::unix::net::SocketAddr::from_pathname`]
162 - [`std::process::ExitCode`] and [`std::process::Termination`]. The stabilization of these two APIs now makes it possible for programs to return errors from `main` with custom exit codes.
163 - [`std::thread::JoinHandle::is_finished`]
164
165 These APIs are now usable in const contexts:
166
167 - [`<*const T>::offset` and `<*mut T>::offset`][ptr-offset]
168 - [`<*const T>::wrapping_offset` and `<*mut T>::wrapping_offset`][ptr-wrapping_offset]
169 - [`<*const T>::add` and `<*mut T>::add`][ptr-add]
170 - [`<*const T>::sub` and `<*mut T>::sub`][ptr-sub]
171 - [`<*const T>::wrapping_add` and `<*mut T>::wrapping_add`][ptr-wrapping_add]
172 - [`<*const T>::wrapping_sub` and `<*mut T>::wrapping_sub`][ptr-wrapping_sub]
173 - [`<[T]>::as_mut_ptr`][slice-as_mut_ptr]
174 - [`<[T]>::as_ptr_range`][slice-as_ptr_range]
175 - [`<[T]>::as_mut_ptr_range`][slice-as_mut_ptr_range]
176
177 Cargo
178 -----
179
180 No feature changes, but see compatibility notes.
181
182 Compatibility Notes
183 -------------------
184
185 - Previously native static libraries were linked as `whole-archive` in some cases, but now rustc tries not to use `whole-archive` unless explicitly requested. This [change][93901] may result in linking errors in some cases. To fix such errors, native libraries linked from the command line, build scripts, or [`#[link]` attributes][link-attr] need to
186   - (more common) either be reordered to respect dependencies between them (if `a` depends on `b` then `a` should go first and `b` second)
187   - (less common) or be updated to use the [`+whole-archive`] modifier.
188 - [Catching a second unwind from FFI code while cleaning up from a Rust panic now causes the process to abort][92911]
189 - [Proc macros no longer see `ident` matchers wrapped in groups][92472]
190 - [The number of `#` in `r#` raw string literals is now required to be less than 256][95251]
191 - [When checking that a dyn type satisfies a trait bound, supertrait bounds are now enforced][92285]
192 - [`cargo vendor` now only accepts one value for each `--sync` flag][cargo/10448]
193 - [`cfg` predicates in `all()` and `any()` are always evaluated to detect errors, instead of short-circuiting.][94295] The compatibility considerations here arise in nightly-only code that used the short-circuiting behavior of `all` to write something like `cfg(all(feature = "nightly", syntax-requiring-nightly))`, which will now fail to compile. Instead, use either `cfg_attr(feature = "nightly", ...)` or nested uses of `cfg`.
194 - [bootstrap: static-libstdcpp is now enabled by default, and can now be disabled when llvm-tools is enabled][94832]
195
196 Internal Changes
197 ----------------
198
199 These changes provide no direct user facing benefits, but represent significant
200 improvements to the internals and overall performance of rustc
201 and related tools.
202
203 - [debuginfo: Refactor debuginfo generation for types][94261]
204 - [Remove the everybody loops pass][93913]
205
206 [88375]: https://github.com/rust-lang/rust/pull/88375/
207 [89887]: https://github.com/rust-lang/rust/pull/89887/
208 [90621]: https://github.com/rust-lang/rust/pull/90621/
209 [92285]: https://github.com/rust-lang/rust/pull/92285/
210 [92472]: https://github.com/rust-lang/rust/pull/92472/
211 [92697]: https://github.com/rust-lang/rust/pull/92697/
212 [92714]: https://github.com/rust-lang/rust/pull/92714/
213 [92911]: https://github.com/rust-lang/rust/pull/92911/
214 [93263]: https://github.com/rust-lang/rust/pull/93263/
215 [93745]: https://github.com/rust-lang/rust/pull/93745/
216 [93827]: https://github.com/rust-lang/rust/pull/93827/
217 [93901]: https://github.com/rust-lang/rust/pull/93901/
218 [93913]: https://github.com/rust-lang/rust/pull/93913/
219 [93965]: https://github.com/rust-lang/rust/pull/93965/
220 [94081]: https://github.com/rust-lang/rust/pull/94081/
221 [94261]: https://github.com/rust-lang/rust/pull/94261/
222 [94295]: https://github.com/rust-lang/rust/pull/94295/
223 [94832]: https://github.com/rust-lang/rust/pull/94832/
224 [95016]: https://github.com/rust-lang/rust/pull/95016/
225 [95251]: https://github.com/rust-lang/rust/pull/95251/
226 [`+whole-archive`]: https://doc.rust-lang.org/stable/rustc/command-line-arguments.html#linking-modifiers-whole-archive
227 [`Pin::static_mut`]: https://doc.rust-lang.org/stable/std/pin/struct.Pin.html#method.static_mut
228 [`Pin::static_ref`]: https://doc.rust-lang.org/stable/std/pin/struct.Pin.html#method.static_ref
229 [`Vec::retain_mut`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.retain_mut
230 [`VecDeque::retain_mut`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.retain_mut
231 [`std::os::unix::net::SocketAddr::from_pathname`]: https://doc.rust-lang.org/stable/std/os/unix/net/struct.SocketAddr.html#method.from_pathname
232 [`std::process::ExitCode`]: https://doc.rust-lang.org/stable/std/process/struct.ExitCode.html
233 [`std::process::Termination`]: https://doc.rust-lang.org/stable/std/process/trait.Termination.html
234 [`std::thread::JoinHandle::is_finished`]: https://doc.rust-lang.org/stable/std/thread/struct.JoinHandle.html#method.is_finished
235 [cargo/10448]: https://github.com/rust-lang/cargo/pull/10448/
236 [cursor-write-array]: https://doc.rust-lang.org/stable/std/io/struct.Cursor.html#impl-Write-4
237 [link-attr]: https://doc.rust-lang.org/stable/reference/items/external-blocks.html#the-link-attribute
238 [ptr-add]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.add
239 [ptr-offset]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.offset
240 [ptr-sub]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.sub
241 [ptr-wrapping_add]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_add
242 [ptr-wrapping_offset]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_offset
243 [ptr-wrapping_sub]: https://doc.rust-lang.org/stable/std/primitive.pointer.html#method.wrapping_sub
244 [slice-as_mut_ptr]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_mut_ptr
245 [slice-as_mut_ptr_range]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_mut_ptr_range
246 [slice-as_ptr_range]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.as_ptr_range
247 [target_feature]: https://doc.rust-lang.org/reference/attributes/codegen.html#the-target_feature-attribute
248
249
250 Version 1.60.0 (2022-04-07)
251 ==========================
252
253 Language
254 --------
255 - [Stabilize `#[cfg(panic = "...")]` for either `"unwind"` or `"abort"`.][93658]
256 - [Stabilize `#[cfg(target_has_atomic = "...")]` for each integer size and `"ptr"`.][93824]
257
258 Compiler
259 --------
260 - [Enable combining `+crt-static` and `relocation-model=pic` on `x86_64-unknown-linux-gnu`][86374]
261 - [Fixes wrong `unreachable_pub` lints on nested and glob public reexport][87487]
262 - [Stabilize `-Z instrument-coverage` as `-C instrument-coverage`][90132]
263 - [Stabilize `-Z print-link-args` as `--print link-args`][91606]
264 - [Add new Tier 3 target `mips64-openwrt-linux-musl`\*][92300]
265 - [Add new Tier 3 target `armv7-unknown-linux-uclibceabi` (softfloat)\*][92383]
266 - [Fix invalid removal of newlines from doc comments][92357]
267 - [Add kernel target for RustyHermit][92670]
268 - [Deny mixing bin crate type with lib crate types][92933]
269 - [Make rustc use `RUST_BACKTRACE=full` by default][93566]
270 - [Upgrade to LLVM 14][93577]
271
272 \* Refer to Rust's [platform support page][platform-support-doc] for more
273    information on Rust's tiered platform support.
274
275 Libraries
276 ---------
277 - [Guarantee call order for `sort_by_cached_key`][89621]
278 - [Improve `Duration::try_from_secs_f32`/`f64` accuracy by directly processing exponent and mantissa][90247]
279 - [Make `Instant::{duration_since, elapsed, sub}` saturating][89926]
280 - [Remove non-monotonic clocks workarounds in `Instant::now`][89926]
281 - [Make `BuildHasherDefault`, `iter::Empty` and `future::Pending` covariant][92630]
282
283 Stabilized APIs
284 ---------------
285 - [`Arc::new_cyclic`][arc_new_cyclic]
286 - [`Rc::new_cyclic`][rc_new_cyclic]
287 - [`slice::EscapeAscii`][slice_escape_ascii]
288 - [`<[u8]>::escape_ascii`][slice_u8_escape_ascii]
289 - [`u8::escape_ascii`][u8_escape_ascii]
290 - [`Vec::spare_capacity_mut`][vec_spare_capacity_mut]
291 - [`MaybeUninit::assume_init_drop`][assume_init_drop]
292 - [`MaybeUninit::assume_init_read`][assume_init_read]
293 - [`i8::abs_diff`][i8_abs_diff]
294 - [`i16::abs_diff`][i16_abs_diff]
295 - [`i32::abs_diff`][i32_abs_diff]
296 - [`i64::abs_diff`][i64_abs_diff]
297 - [`i128::abs_diff`][i128_abs_diff]
298 - [`isize::abs_diff`][isize_abs_diff]
299 - [`u8::abs_diff`][u8_abs_diff]
300 - [`u16::abs_diff`][u16_abs_diff]
301 - [`u32::abs_diff`][u32_abs_diff]
302 - [`u64::abs_diff`][u64_abs_diff]
303 - [`u128::abs_diff`][u128_abs_diff]
304 - [`usize::abs_diff`][usize_abs_diff]
305 - [`Display for io::ErrorKind`][display_error_kind]
306 - [`From<u8> for ExitCode`][from_u8_exit_code]
307 - [`Not for !` (the "never" type)][not_never]
308 - [_Op_`Assign<$t> for Wrapping<$t>`][wrapping_assign_ops]
309 - [`arch::is_aarch64_feature_detected!`][is_aarch64_feature_detected]
310
311 Cargo
312 -----
313 - [Port cargo from `toml-rs` to `toml_edit`][cargo/10086]
314 - [Stabilize `-Ztimings` as `--timings`][cargo/10245]
315 - [Stabilize namespaced and weak dependency features.][cargo/10269]
316 - [Accept more `cargo:rustc-link-arg-*` types from build script output.][cargo/10274]
317 - [cargo-new should not add ignore rule on Cargo.lock inside subdirs][cargo/10379]
318
319 Misc
320 ----
321 - [Ship docs on Tier 2 platforms by reusing the closest Tier 1 platform docs][92800]
322 - [Drop rustc-docs from complete profile][93742]
323 - [bootstrap: tidy up flag handling for llvm build][93918]
324
325 Compatibility Notes
326 -------------------
327 - [Remove compiler-rt linking hack on Android][83822]
328 - [Mitigations for platforms with non-monotonic clocks have been removed from
329   `Instant::now`][89926]. On platforms that don't provide monotonic clocks, an
330   instant is not guaranteed to be greater than an earlier instant anymore.
331 - [`Instant::{duration_since, elapsed, sub}` do not panic anymore on underflow,
332   saturating to `0` instead][89926]. In the real world the panic happened mostly
333   on platforms with buggy monotonic clock implementations rather than catching
334   programming errors like reversing the start and end times. Such programming
335   errors will now results in `0` rather than a panic.
336 - In a future release we're planning to increase the baseline requirements for
337   the Linux kernel to version 3.2, and for glibc to version 2.17. We'd love
338   your feedback in [PR #95026][95026].
339
340 Internal Changes
341 ----------------
342
343 These changes provide no direct user facing benefits, but represent significant
344 improvements to the internals and overall performance of rustc
345 and related tools.
346
347 - [Switch all libraries to the 2021 edition][92068]
348
349 [83822]: https://github.com/rust-lang/rust/pull/83822
350 [86374]: https://github.com/rust-lang/rust/pull/86374
351 [87487]: https://github.com/rust-lang/rust/pull/87487
352 [89621]: https://github.com/rust-lang/rust/pull/89621
353 [89926]: https://github.com/rust-lang/rust/pull/89926
354 [90132]: https://github.com/rust-lang/rust/pull/90132
355 [90247]: https://github.com/rust-lang/rust/pull/90247
356 [91606]: https://github.com/rust-lang/rust/pull/91606
357 [92068]: https://github.com/rust-lang/rust/pull/92068
358 [92300]: https://github.com/rust-lang/rust/pull/92300
359 [92357]: https://github.com/rust-lang/rust/pull/92357
360 [92383]: https://github.com/rust-lang/rust/pull/92383
361 [92630]: https://github.com/rust-lang/rust/pull/92630
362 [92670]: https://github.com/rust-lang/rust/pull/92670
363 [92800]: https://github.com/rust-lang/rust/pull/92800
364 [92933]: https://github.com/rust-lang/rust/pull/92933
365 [93566]: https://github.com/rust-lang/rust/pull/93566
366 [93577]: https://github.com/rust-lang/rust/pull/93577
367 [93658]: https://github.com/rust-lang/rust/pull/93658
368 [93742]: https://github.com/rust-lang/rust/pull/93742
369 [93824]: https://github.com/rust-lang/rust/pull/93824
370 [93918]: https://github.com/rust-lang/rust/pull/93918
371 [95026]: https://github.com/rust-lang/rust/pull/95026
372
373 [cargo/10086]: https://github.com/rust-lang/cargo/pull/10086
374 [cargo/10245]: https://github.com/rust-lang/cargo/pull/10245
375 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269
376 [cargo/10274]: https://github.com/rust-lang/cargo/pull/10274
377 [cargo/10379]: https://github.com/rust-lang/cargo/pull/10379
378
379 [arc_new_cyclic]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.new_cyclic
380 [rc_new_cyclic]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.new_cyclic
381 [slice_escape_ascii]: https://doc.rust-lang.org/stable/std/slice/struct.EscapeAscii.html
382 [slice_u8_escape_ascii]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.escape_ascii
383 [u8_escape_ascii]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.escape_ascii
384 [vec_spare_capacity_mut]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.spare_capacity_mut
385 [assume_init_drop]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_drop
386 [assume_init_read]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_read
387 [i8_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.abs_diff
388 [i16_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.abs_diff
389 [i32_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.abs_diff
390 [i64_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.abs_diff
391 [i128_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.abs_diff
392 [isize_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.abs_diff
393 [u8_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.abs_diff
394 [u16_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.abs_diff
395 [u32_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.abs_diff
396 [u64_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.abs_diff
397 [u128_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.abs_diff
398 [usize_abs_diff]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.abs_diff
399 [display_error_kind]: https://doc.rust-lang.org/stable/std/io/enum.ErrorKind.html#impl-Display
400 [from_u8_exit_code]: https://doc.rust-lang.org/stable/std/process/struct.ExitCode.html#impl-From%3Cu8%3E
401 [not_never]: https://doc.rust-lang.org/stable/std/primitive.never.html#impl-Not
402 [wrapping_assign_ops]: https://doc.rust-lang.org/stable/std/num/struct.Wrapping.html#trait-implementations
403 [is_aarch64_feature_detected]: https://doc.rust-lang.org/stable/std/arch/macro.is_aarch64_feature_detected.html
404
405 Version 1.59.0 (2022-02-24)
406 ==========================
407
408 Language
409 --------
410
411 - [Stabilize default arguments for const parameters and remove the ordering restriction for type and const parameters][90207]
412 - [Stabilize destructuring assignment][90521]
413 - [Relax private in public lint on generic bounds and where clauses of trait impls][90586]
414 - [Stabilize asm! and global_asm! for x86, x86_64, ARM, Aarch64, and RISC-V][91728]
415
416 Compiler
417 --------
418
419 - [Stabilize new symbol mangling format, leaving it opt-in (-Csymbol-mangling-version=v0)][90128]
420 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
421 - [Fix sparc64 ABI for aggregates with floating point members][91003]
422 - [Warn when a `#[test]`-like built-in attribute macro is present multiple times.][91172]
423 - [Add support for riscv64gc-unknown-freebsd][91284]
424 - [Stabilize `-Z emit-future-incompat` as `--json future-incompat`][91535]
425 - [Soft disable incremental compilation][94124]
426
427 This release disables incremental compilation, unless the user has explicitly
428 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
429 This is due to a known and relatively frequently occurring bug in incremental
430 compilation, which causes builds to issue internal compiler errors. This
431 particular bug is already fixed on nightly, but that fix has not yet rolled out
432 to stable and is deemed too risky for a direct stable backport.
433
434 As always, we encourage users to test with nightly and report bugs so that we
435 can track failures and fix issues earlier.
436
437 See [94124] for more details.
438
439 [94124]: https://github.com/rust-lang/rust/issues/94124
440
441 Libraries
442 ---------
443
444 - [Remove unnecessary bounds for some Hash{Map,Set} methods][91593]
445
446 Stabilized APIs
447 ---------------
448
449 - [`std::thread::available_parallelism`][available_parallelism]
450 - [`Result::copied`][result-copied]
451 - [`Result::cloned`][result-cloned]
452 - [`arch::asm!`][asm]
453 - [`arch::global_asm!`][global_asm]
454 - [`ops::ControlFlow::is_break`][is_break]
455 - [`ops::ControlFlow::is_continue`][is_continue]
456 - [`TryFrom<char> for u8`][try_from_char_u8]
457 - [`char::TryFromCharError`][try_from_char_err]
458   implementing `Clone`, `Debug`, `Display`, `PartialEq`, `Copy`, `Eq`, `Error`
459 - [`iter::zip`][zip]
460 - [`NonZeroU8::is_power_of_two`][is_power_of_two8]
461 - [`NonZeroU16::is_power_of_two`][is_power_of_two16]
462 - [`NonZeroU32::is_power_of_two`][is_power_of_two32]
463 - [`NonZeroU64::is_power_of_two`][is_power_of_two64]
464 - [`NonZeroU128::is_power_of_two`][is_power_of_two128]
465 - [`NonZeroUsize::is_power_of_two`][is_power_of_two_usize]
466 - [`DoubleEndedIterator for ToLowercase`][lowercase]
467 - [`DoubleEndedIterator for ToUppercase`][uppercase]
468 - [`TryFrom<&mut [T]> for [T; N]`][tryfrom_ref_arr]
469 - [`UnwindSafe for Once`][unwindsafe_once]
470 - [`RefUnwindSafe for Once`][refunwindsafe_once]
471 - [armv8 neon intrinsics for aarch64][stdarch/1266]
472
473 Const-stable:
474
475 - [`mem::MaybeUninit::as_ptr`][muninit_ptr]
476 - [`mem::MaybeUninit::assume_init`][muninit_init]
477 - [`mem::MaybeUninit::assume_init_ref`][muninit_init_ref]
478 - [`ffi::CStr::from_bytes_with_nul_unchecked`][cstr_from_bytes]
479
480 Cargo
481 -----
482
483 - [Stabilize the `strip` profile option][cargo/10088]
484 - [Stabilize future-incompat-report][cargo/10165]
485 - [Support abbreviating `--release` as `-r`][cargo/10133]
486 - [Support `term.quiet` configuration][cargo/10152]
487 - [Remove `--host` from cargo {publish,search,login}][cargo/10145]
488
489 Compatibility Notes
490 -------------------
491
492 - [Refactor weak symbols in std::sys::unix][90846]
493   This may add new, versioned, symbols when building with a newer glibc, as the
494   standard library uses weak linkage rather than dynamically attempting to load
495   certain symbols at runtime.
496 - [Deprecate crate_type and crate_name nested inside `#![cfg_attr]`][83744]
497   This adds a future compatibility lint to supporting the use of cfg_attr
498   wrapping either crate_type or crate_name specification within Rust files;
499   it is recommended that users migrate to setting the equivalent command line
500   flags.
501 - [Remove effect of `#[no_link]` attribute on name resolution][92034]
502   This may expose new names, leading to conflicts with preexisting names in a
503   given namespace and a compilation failure.
504 - [Cargo will document libraries before binaries.][cargo/10172]
505 - [Respect doc=false in dependencies, not just the root crate][cargo/10201]
506 - [Weaken guarantee around advancing underlying iterators in zip][83791]
507 - [Make split_inclusive() on an empty slice yield an empty output][89825]
508 - [Update std::env::temp_dir to use GetTempPath2 on Windows when available.][89999]
509 - [unreachable! was updated to match other formatting macro behavior on Rust 2021][92137]
510
511 Internal Changes
512 ----------------
513
514 These changes provide no direct user facing benefits, but represent significant
515 improvements to the internals and overall performance of rustc
516 and related tools.
517
518 - [Fix many cases of normalization-related ICEs][91255]
519 - [Replace dominators algorithm with simple Lengauer-Tarjan][85013]
520 - [Store liveness in interval sets for region inference][90637]
521
522 - [Remove `in_band_lifetimes` from the compiler and standard library, in preparation for removing this
523   unstable feature.][91867]
524
525 [91867]: https://github.com/rust-lang/rust/issues/91867
526 [83744]: https://github.com/rust-lang/rust/pull/83744/
527 [83791]: https://github.com/rust-lang/rust/pull/83791/
528 [85013]: https://github.com/rust-lang/rust/pull/85013/
529 [89825]: https://github.com/rust-lang/rust/pull/89825/
530 [89999]: https://github.com/rust-lang/rust/pull/89999/
531 [90128]: https://github.com/rust-lang/rust/pull/90128/
532 [90207]: https://github.com/rust-lang/rust/pull/90207/
533 [90521]: https://github.com/rust-lang/rust/pull/90521/
534 [90586]: https://github.com/rust-lang/rust/pull/90586/
535 [90637]: https://github.com/rust-lang/rust/pull/90637/
536 [90833]: https://github.com/rust-lang/rust/pull/90833/
537 [90846]: https://github.com/rust-lang/rust/pull/90846/
538 [91003]: https://github.com/rust-lang/rust/pull/91003/
539 [91172]: https://github.com/rust-lang/rust/pull/91172/
540 [91255]: https://github.com/rust-lang/rust/pull/91255/
541 [91284]: https://github.com/rust-lang/rust/pull/91284/
542 [91535]: https://github.com/rust-lang/rust/pull/91535/
543 [91593]: https://github.com/rust-lang/rust/pull/91593/
544 [91728]: https://github.com/rust-lang/rust/pull/91728/
545 [91878]: https://github.com/rust-lang/rust/pull/91878/
546 [91896]: https://github.com/rust-lang/rust/pull/91896/
547 [91926]: https://github.com/rust-lang/rust/pull/91926/
548 [91984]: https://github.com/rust-lang/rust/pull/91984/
549 [92020]: https://github.com/rust-lang/rust/pull/92020/
550 [92034]: https://github.com/rust-lang/rust/pull/92034/
551 [92137]: https://github.com/rust-lang/rust/pull/92137/
552 [92483]: https://github.com/rust-lang/rust/pull/92483/
553 [cargo/10088]: https://github.com/rust-lang/cargo/pull/10088/
554 [cargo/10133]: https://github.com/rust-lang/cargo/pull/10133/
555 [cargo/10145]: https://github.com/rust-lang/cargo/pull/10145/
556 [cargo/10152]: https://github.com/rust-lang/cargo/pull/10152/
557 [cargo/10165]: https://github.com/rust-lang/cargo/pull/10165/
558 [cargo/10172]: https://github.com/rust-lang/cargo/pull/10172/
559 [cargo/10201]: https://github.com/rust-lang/cargo/pull/10201/
560 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269/
561
562 [cstr_from_bytes]: https://doc.rust-lang.org/stable/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked
563 [muninit_ptr]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
564 [muninit_init]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
565 [muninit_init_ref]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
566 [unwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-UnwindSafe
567 [refunwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-RefUnwindSafe
568 [tryfrom_ref_arr]: https://doc.rust-lang.org/stable/std/convert/trait.TryFrom.html#impl-TryFrom%3C%26%27_%20mut%20%5BT%5D%3E
569 [lowercase]: https://doc.rust-lang.org/stable/std/char/struct.ToLowercase.html#impl-DoubleEndedIterator
570 [uppercase]: https://doc.rust-lang.org/stable/std/char/struct.ToUppercase.html#impl-DoubleEndedIterator
571 [try_from_char_err]: https://doc.rust-lang.org/stable/std/char/struct.TryFromCharError.html
572 [available_parallelism]: https://doc.rust-lang.org/stable/std/thread/fn.available_parallelism.html
573 [result-copied]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.copied
574 [result-cloned]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.cloned
575 [asm]: https://doc.rust-lang.org/stable/core/arch/macro.asm.html
576 [global_asm]: https://doc.rust-lang.org/stable/core/arch/macro.global_asm.html
577 [is_break]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_break
578 [is_continue]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_continue
579 [try_from_char_u8]: https://doc.rust-lang.org/stable/std/primitive.char.html#impl-TryFrom%3Cchar%3E
580 [zip]: https://doc.rust-lang.org/stable/std/iter/fn.zip.html
581 [is_power_of_two8]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU8.html#method.is_power_of_two
582 [is_power_of_two16]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU16.html#method.is_power_of_two
583 [is_power_of_two32]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU32.html#method.is_power_of_two
584 [is_power_of_two64]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU64.html#method.is_power_of_two
585 [is_power_of_two128]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU128.html#method.is_power_of_two
586 [is_power_of_two_usize]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroUsize.html#method.is_power_of_two
587 [stdarch/1266]: https://github.com/rust-lang/stdarch/pull/1266
588
589 Version 1.58.1 (2022-01-19)
590 ===========================
591
592 * Fix race condition in `std::fs::remove_dir_all` ([CVE-2022-21658])
593 * [Handle captured arguments in the `useless_format` Clippy lint][clippy/8295]
594 * [Move `non_send_fields_in_send_ty` Clippy lint to nursery][clippy/8075]
595 * [Fix wrong error message displayed when some imports are missing][91254]
596 * [Fix rustfmt not formatting generated files from stdin][92912]
597
598 [CVE-2022-21658]: https://www.cve.org/CVERecord?id=CVE-2022-21658
599 [91254]: https://github.com/rust-lang/rust/pull/91254
600 [92912]: https://github.com/rust-lang/rust/pull/92912
601 [clippy/8075]: https://github.com/rust-lang/rust-clippy/pull/8075
602 [clippy/8295]: https://github.com/rust-lang/rust-clippy/pull/8295
603
604 Version 1.58.0 (2022-01-13)
605 ==========================
606
607 Language
608 --------
609
610 - [Format strings can now capture arguments simply by writing `{ident}` in the string.][90473] This works in all macros accepting format strings. Support for this in `panic!` (`panic!("{ident}")`) requires the 2021 edition; panic invocations in previous editions that appear to be trying to use this will result in a warning lint about not having the intended effect.
611 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
612 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
613
614 Compiler
615 --------
616
617 - [Add LLVM CFI support to the Rust compiler][89652]
618 - [Stabilize -Z strip as -C strip][90058]. Note that while release builds already don't add debug symbols for the code you compile, the compiled standard library that ships with Rust includes debug symbols, so you may want to use the `strip` option to remove these symbols to produce smaller release binaries. Note that this release only includes support in rustc, not directly in cargo.
619 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
620 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
621 - [Update the minimum external LLVM to 12][90175]
622 - [Add `x86_64-unknown-none` at Tier 3*][89062]
623 - [Build musl dist artifacts with debuginfo enabled][90733]. When building release binaries using musl, you may want to use the newly stabilized strip option to remove these debug symbols, reducing the size of your binaries.
624 - [Don't abort compilation after giving a lint error][87337]
625 - [Error messages point at the source of trait bound obligations in more places][89580]
626
627 \* Refer to Rust's [platform support page][platform-support-doc] for more
628    information on Rust's tiered platform support.
629
630 Libraries
631 ---------
632
633 - [All remaining functions in the standard library have `#[must_use]` annotations where appropriate][89692], producing a warning when ignoring their return value. This helps catch mistakes such as expecting a function to mutate a value in place rather than return a new value.
634 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
635 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
636 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
637 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
638 - [Implement `Termination` for `Result<Infallible, E>`][88601]. This allows writing `fn main() -> Result<Infallible, ErrorType>`, for a program whose successful exits never involve returning from `main` (for instance, a program that calls `exit`, or that uses `exec` to run another program).
639
640 Stabilized APIs
641 ---------------
642
643 - [`Metadata::is_symlink`]
644 - [`Path::is_symlink`]
645 - [`{integer}::saturating_div`]
646 - [`Option::unwrap_unchecked`]
647 - [`Result::unwrap_unchecked`]
648 - [`Result::unwrap_err_unchecked`]
649 - [`File::options`]
650
651 These APIs are now usable in const contexts:
652
653 - [`Duration::new`]
654 - [`Duration::checked_add`]
655 - [`Duration::saturating_add`]
656 - [`Duration::checked_sub`]
657 - [`Duration::saturating_sub`]
658 - [`Duration::checked_mul`]
659 - [`Duration::saturating_mul`]
660 - [`Duration::checked_div`]
661
662 Cargo
663 -----
664
665 - [Add --message-format for install command][cargo/10107]
666 - [Warn when alias shadows external subcommand][cargo/10082]
667
668 Rustdoc
669 -------
670
671 - [Show all Deref implementations recursively in rustdoc][90183]
672 - [Use computed visibility in rustdoc][88447]
673
674 Compatibility Notes
675 -------------------
676
677 - [Try all stable method candidates first before trying unstable ones][90329]. This change ensures that adding new nightly-only methods to the Rust standard library will not break code invoking methods of the same name from traits outside the standard library.
678 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
679 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
680 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
681 - [Refactor weak symbols in std::sys::unix][90846]. This optimizes accesses to glibc functions, by avoiding the use of dlopen. This does not increase the [minimum expected version of glibc](https://doc.rust-lang.org/nightly/rustc/platform-support.html). However, software distributions that use symbol versions to detect library dependencies, and which take weak symbols into account in that analysis, may detect rust binaries as requiring newer versions of glibc.
682 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
683
684 Internal Changes
685 ----------------
686
687 These changes provide no direct user facing benefits, but represent significant
688 improvements to the internals and overall performance of rustc
689 and related tools.
690
691 - [Implement coherence checks for negative trait impls][90104]
692 - [Add rustc lint, warning when iterating over hashmaps][89558]
693 - [Optimize live point computation][90491]
694 - [Enable verification for 1/32nd of queries loaded from disk][90361]
695 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
696
697 [87337]: https://github.com/rust-lang/rust/pull/87337/
698 [87467]: https://github.com/rust-lang/rust/pull/87467/
699 [87704]: https://github.com/rust-lang/rust/pull/87704/
700 [88041]: https://github.com/rust-lang/rust/pull/88041/
701 [88447]: https://github.com/rust-lang/rust/pull/88447/
702 [88601]: https://github.com/rust-lang/rust/pull/88601/
703 [89062]: https://github.com/rust-lang/rust/pull/89062/
704 [89174]: https://github.com/rust-lang/rust/pull/89174/
705 [89551]: https://github.com/rust-lang/rust/pull/89551/
706 [89558]: https://github.com/rust-lang/rust/pull/89558/
707 [89580]: https://github.com/rust-lang/rust/pull/89580/
708 [89652]: https://github.com/rust-lang/rust/pull/89652/
709 [90041]: https://github.com/rust-lang/rust/pull/90041/
710 [90058]: https://github.com/rust-lang/rust/pull/90058/
711 [90104]: https://github.com/rust-lang/rust/pull/90104/
712 [90117]: https://github.com/rust-lang/rust/pull/90117/
713 [90175]: https://github.com/rust-lang/rust/pull/90175/
714 [90183]: https://github.com/rust-lang/rust/pull/90183/
715 [90297]: https://github.com/rust-lang/rust/pull/90297/
716 [90329]: https://github.com/rust-lang/rust/pull/90329/
717 [90361]: https://github.com/rust-lang/rust/pull/90361/
718 [90417]: https://github.com/rust-lang/rust/pull/90417/
719 [90473]: https://github.com/rust-lang/rust/pull/90473/
720 [90491]: https://github.com/rust-lang/rust/pull/90491/
721 [90733]: https://github.com/rust-lang/rust/pull/90733/
722 [90833]: https://github.com/rust-lang/rust/pull/90833/
723 [90846]: https://github.com/rust-lang/rust/pull/90846/
724 [91026]: https://github.com/rust-lang/rust/pull/91026/
725 [91207]: https://github.com/rust-lang/rust/pull/91207/
726 [91255]: https://github.com/rust-lang/rust/pull/91255/
727 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
728 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
729 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
730 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
731 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
732 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
733 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
734 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
735 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
736 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
737
738 Version 1.57.0 (2021-12-02)
739 ==========================
740
741 Language
742 --------
743
744 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
745 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
746 - [Allow panicking in constant evaluation.][89508]
747 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
748
749 Compiler
750 --------
751
752 - [Create more accurate debuginfo for vtables.][89597]
753 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
754 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
755 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
756 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
757
758 \* Refer to Rust's [platform support page][platform-support-doc] for more
759    information on Rust's tiered platform support.
760
761 Libraries
762 ---------
763
764 - [Avoid allocations and copying in `Vec::leak`][89337]
765 - [Add `#[repr(i8)]` to `Ordering`][89507]
766 - [Optimize `File::read_to_end` and `read_to_string`][89582]
767 - [Update to Unicode 14.0][89614]
768 - [Many more functions are marked `#[must_use]`][89692], producing a warning
769   when ignoring their return value. This helps catch mistakes such as expecting
770   a function to mutate a value in place rather than return a new value.
771
772 Stabilised APIs
773 ---------------
774
775 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
776 - [`[T; N]::as_slice`][`array::as_slice`]
777 - [`collections::TryReserveError`]
778 - [`HashMap::try_reserve`]
779 - [`HashSet::try_reserve`]
780 - [`String::try_reserve`]
781 - [`String::try_reserve_exact`]
782 - [`Vec::try_reserve`]
783 - [`Vec::try_reserve_exact`]
784 - [`VecDeque::try_reserve`]
785 - [`VecDeque::try_reserve_exact`]
786 - [`Iterator::map_while`]
787 - [`iter::MapWhile`]
788 - [`proc_macro::is_available`]
789 - [`Command::get_program`]
790 - [`Command::get_args`]
791 - [`Command::get_envs`]
792 - [`Command::get_current_dir`]
793 - [`CommandArgs`]
794 - [`CommandEnvs`]
795
796 These APIs are now usable in const contexts:
797
798 - [`hint::unreachable_unchecked`]
799
800 Cargo
801 -----
802
803 - [Stabilize custom profiles][cargo/9943]
804
805 Compatibility notes
806 -------------------
807
808 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
809   This will break some builds that set `#![deny(dead_code)]`.
810
811 Internal changes
812 ----------------
813 These changes provide no direct user facing benefits, but represent significant
814 improvements to the internals and overall performance of rustc
815 and related tools.
816
817 - [Added an experimental backend for codegen with `libgccjit`.][87260]
818
819 [85200]: https://github.com/rust-lang/rust/pull/85200/
820 [86191]: https://github.com/rust-lang/rust/pull/86191/
821 [87220]: https://github.com/rust-lang/rust/pull/87220/
822 [87260]: https://github.com/rust-lang/rust/pull/87260/
823 [88321]: https://github.com/rust-lang/rust/pull/88321/
824 [88529]: https://github.com/rust-lang/rust/pull/88529/
825 [88690]: https://github.com/rust-lang/rust/pull/88690/
826 [88952]: https://github.com/rust-lang/rust/pull/88952/
827 [89337]: https://github.com/rust-lang/rust/pull/89337/
828 [89507]: https://github.com/rust-lang/rust/pull/89507/
829 [89508]: https://github.com/rust-lang/rust/pull/89508/
830 [89582]: https://github.com/rust-lang/rust/pull/89582/
831 [89597]: https://github.com/rust-lang/rust/pull/89597/
832 [89614]: https://github.com/rust-lang/rust/pull/89614/
833 [89692]: https://github.com/rust-lang/rust/issues/89692/
834 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
835 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
836 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
837 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
838 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
839 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
840 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
841 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
842 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
843 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
844 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
845 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
846 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
847 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
848 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
849 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
850 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
851 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
852 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
853 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
854 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
855
856 Version 1.56.1 (2021-11-01)
857 ===========================
858
859 - New lints to detect the presence of bidirectional-override Unicode
860   codepoints in the compiled source code ([CVE-2021-42574])
861
862 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
863
864 Version 1.56.0 (2021-10-21)
865 ========================
866
867 Language
868 --------
869
870 - [The 2021 Edition is now stable.][rust#88100]
871   See [the edition guide][rust-2021-edition-guide] for more details.
872 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
873 - [Union field access is permitted in `const fn`.][rust#85769]
874
875 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
876
877 Compiler
878 --------
879
880 - [Upgrade to LLVM 13.][rust#87570]
881 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
882 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
883 - [Warnings can be forced on with `--force-warn`.][rust#87472]
884   This feature is primarily intended for usage by `cargo fix`, rather than end users.
885 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
886 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
887 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
888
889 \* Refer to Rust's [platform support page][platform-support-doc] for more
890 information on Rust's tiered platform support.
891
892 Libraries
893 ---------
894
895 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
896   The Windows console still requires valid Unicode, but this change allows
897   splitting a UTF-8 character across multiple write calls. This allows, for
898   instance, programs that just read and write data buffers (e.g. copying a file
899   to stdout) without regard for Unicode or character boundaries.
900 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
901   For this use case, atomics scale much better under contention.
902 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
903 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
904 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
905 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
906 - [Treat invalid environment variable names as non-existent.][rust#86183]
907   Previously, the environment functions would panic if given a variable name
908   with an internal null character or equal sign (`=`). Now, these functions will
909   just treat such names as non-existent variables, since the OS cannot represent
910   the existence of a variable with such a name.
911
912 Stabilised APIs
913 ---------------
914
915 - [`std::os::unix::fs::chroot`]
916 - [`UnsafeCell::raw_get`]
917 - [`BufWriter::into_parts`]
918 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
919   These APIs were previously stable in `std`, but are now also available in `core`.
920 - [`Vec::shrink_to`]
921 - [`String::shrink_to`]
922 - [`OsString::shrink_to`]
923 - [`PathBuf::shrink_to`]
924 - [`BinaryHeap::shrink_to`]
925 - [`VecDeque::shrink_to`]
926 - [`HashMap::shrink_to`]
927 - [`HashSet::shrink_to`]
928
929 These APIs are now usable in const contexts:
930
931 - [`std::mem::transmute`]
932 - [`[T]::first`][`slice::first`]
933 - [`[T]::split_first`][`slice::split_first`]
934 - [`[T]::last`][`slice::last`]
935 - [`[T]::split_last`][`slice::split_last`]
936
937 Cargo
938 -----
939
940 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
941   This has no effect at present on dependency version selection.
942   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
943   that support Rust code to include a crate's specified minimum version in the test matrix for that
944   crate by default.
945
946 Compatibility notes
947 -------------------
948
949 - [Update to new argument parsing rules on Windows.][rust#87580]
950   This adjusts Rust's standard library to match the behavior of the standard
951   libraries for C/C++. The rules have changed slightly over time, and this PR
952   brings us to the latest set of rules (changed in 2008).
953 - [Disallow the aapcs calling convention on aarch64][rust#88399]
954   This was already not supported by LLVM; this change surfaces this lack of
955   support with a better error message.
956 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
957 - [Warn when an escaped newline skips multiple lines.][rust#87671]
958 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
959    may return different values on glibc <= 2.24.][rust#81825]
960    Rust now invokes the `clone3` system call directly, when available, to use new functionality
961    available via that system call. Older versions of glibc cache the result of `getpid`, and only
962    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
963    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
964
965 Internal changes
966 ----------------
967 These changes provide no direct user facing benefits, but represent significant
968 improvements to the internals and overall performance of rustc
969 and related tools.
970
971 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
972   This improves the performance of most Rust builds.
973 - [Unify representation of macros in internal data structures.][rust#88019]
974   This change fixes a host of bugs with the handling of macros by the compiler,
975   as well as rustdoc.
976
977 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
978 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
979 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
980 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
981 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
982 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
983 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
984 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
985 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
986 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
987 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
988 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
989 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
990 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
991 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
992 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
993 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
994 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
995 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
996 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
997 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
998 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
999 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
1000 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
1001 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
1002 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
1003 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
1004 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
1005 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
1006 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
1007 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
1008 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
1009 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
1010 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
1011 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
1012 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
1013 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
1014 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
1015 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
1016 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
1017 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
1018 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
1019
1020 Version 1.55.0 (2021-09-09)
1021 ============================
1022
1023 Language
1024 --------
1025 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
1026   will end at the maximum value of the integer.][83918]
1027 - [You can now explicitly import the prelude of different editions
1028   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
1029
1030 Compiler
1031 --------
1032 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
1033
1034 \* Refer to Rust's [platform support page][platform-support-doc] for more
1035    information on Rust's tiered platform support.
1036
1037 Libraries
1038 ---------
1039
1040 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
1041   These improvements should in general provide faster string parsing of floats,
1042   no longer reject certain valid floating point values, and reduce
1043   the produced code size for non-stripped artifacts.
1044 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
1045
1046 Stabilised APIs
1047 ---------------
1048
1049 - [`Bound::cloned`]
1050 - [`Drain::as_str`]
1051 - [`IntoInnerError::into_error`]
1052 - [`IntoInnerError::into_parts`]
1053 - [`MaybeUninit::assume_init_mut`]
1054 - [`MaybeUninit::assume_init_ref`]
1055 - [`MaybeUninit::write`]
1056 - [`array::map`]
1057 - [`ops::ControlFlow`]
1058 - [`x86::_bittest`]
1059 - [`x86::_bittestandcomplement`]
1060 - [`x86::_bittestandreset`]
1061 - [`x86::_bittestandset`]
1062 - [`x86_64::_bittest64`]
1063 - [`x86_64::_bittestandcomplement64`]
1064 - [`x86_64::_bittestandreset64`]
1065 - [`x86_64::_bittestandset64`]
1066
1067 The following previously stable functions are now `const`.
1068
1069 - [`str::from_utf8_unchecked`]
1070
1071
1072 Cargo
1073 -----
1074 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
1075   rustc in parallel such as when using `cargo test`.][cargo/9675]
1076 - [The package definition in `cargo metadata` now includes the `"default_run"`
1077   field from the manifest.][cargo/9550]
1078 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
1079 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
1080   of packages.][cargo/9663]
1081
1082 Rustdoc
1083 -------
1084 - [Added "Go to item on exact match" search option.][85876]
1085 - [The "Implementors" section on traits no longer shows redundant
1086   method definitions.][85970]
1087 - [Trait implementations are toggled open by default.][86260] This should make the
1088   implementations more searchable by tools like `CTRL+F` in your browser.
1089 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
1090   through type aliases.][86334]
1091 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
1092   "Trait Implementations" section.][86513]
1093
1094
1095 Compatibility Notes
1096 -------------------
1097 - [std functions that return an `io::Error` will no longer use the
1098   `ErrorKind::Other` variant.][85746] This is to better reflect that these
1099   kinds of errors could be categorised [into newer more specific `ErrorKind`
1100   variants][79965], and that they do not represent a user error.
1101 - [Using environment variable names with `process::Command` on Windows now
1102   behaves as expected.][85270] Previously using envionment variables with
1103   `Command` would cause them to be ASCII-uppercased.
1104 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
1105   with `rustdoc::`][86849]
1106 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
1107   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
1108   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
1109   for more details.
1110
1111 [86849]: https://github.com/rust-lang/rust/pull/86849
1112 [86513]: https://github.com/rust-lang/rust/pull/86513
1113 [86334]: https://github.com/rust-lang/rust/pull/86334
1114 [86260]: https://github.com/rust-lang/rust/pull/86260
1115 [85970]: https://github.com/rust-lang/rust/pull/85970
1116 [85876]: https://github.com/rust-lang/rust/pull/85876
1117 [83572]: https://github.com/rust-lang/rust/pull/83572
1118 [86294]: https://github.com/rust-lang/rust/pull/86294
1119 [86858]: https://github.com/rust-lang/rust/pull/86858
1120 [86761]: https://github.com/rust-lang/rust/pull/86761
1121 [85746]: https://github.com/rust-lang/rust/pull/85746
1122 [85270]: https://github.com/rust-lang/rust/pull/85270
1123 [83918]: https://github.com/rust-lang/rust/pull/83918
1124 [79965]: https://github.com/rust-lang/rust/pull/79965
1125 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
1126 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
1127 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
1128 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
1129 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
1130 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
1131 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
1132 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
1133 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
1134 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
1135 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
1136 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
1137 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
1138 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
1139 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
1140 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
1141 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
1142 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
1143 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
1144 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
1145 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
1146 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
1147
1148
1149 Version 1.54.0 (2021-07-29)
1150 ============================
1151
1152 Language
1153 -----------------------
1154
1155 - [You can now use macros for values in some built-in attributes.][83366]
1156   This primarily allows you to call macros within the `#[doc]` attribute. For
1157   example, to include external documentation in your crate, you can now write
1158   the following:
1159   ```rust
1160   #![doc = include_str!("README.md")]
1161   ```
1162
1163 - [You can now cast between unsized slice types (and types which contain
1164   unsized slices) in `const fn`.][85078]
1165 - [You can now use multiple generic lifetimes with `impl Trait` where the
1166    lifetimes don't explicitly outlive another.][84701] In code this means
1167    that you can now have `impl Trait<'a, 'b>` where as before you could
1168    only have `impl Trait<'a, 'b> where 'b: 'a`.
1169
1170 Compiler
1171 -----------------------
1172
1173 - [Rustc will now search for custom JSON targets in
1174   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
1175   directory.][83800] You can find your sysroot directory by running
1176   `rustc --print sysroot`.
1177 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
1178 - [You can now use `#[target_feature]` on safe functions when targeting
1179   WebAssembly platforms.][84988]
1180 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
1181 - [Added tier 3\* support for `bpfel-unknown-none`
1182    and `bpfeb-unknown-none`.][79608]
1183 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
1184
1185 \* Refer to Rust's [platform support page][platform-support-doc] for more
1186    information on Rust's tiered platform support.
1187
1188 Libraries
1189 -----------------------
1190
1191 - [`panic::panic_any` will now `#[track_caller]`.][85745]
1192 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
1193 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
1194 - [The implementations of vendor intrinsics in core::arch have been
1195    significantly refactored.][83278] The main user-visible changes are
1196    a 50% reduction in the size of libcore.rlib and stricter validation
1197    of constant operands passed to intrinsics. The latter is technically
1198    a breaking change, but allows Rust to more closely match the C vendor
1199    intrinsics API.
1200
1201 Stabilized APIs
1202 ---------------
1203
1204 - [`BTreeMap::into_keys`]
1205 - [`BTreeMap::into_values`]
1206 - [`HashMap::into_keys`]
1207 - [`HashMap::into_values`]
1208 - [`arch::wasm32`]
1209 - [`VecDeque::binary_search`]
1210 - [`VecDeque::binary_search_by`]
1211 - [`VecDeque::binary_search_by_key`]
1212 - [`VecDeque::partition_point`]
1213
1214 Cargo
1215 -----
1216
1217 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
1218   the dependency graph.][cargo/9520]
1219 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
1220   in the tree ][cargo/9499]
1221 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
1222   macro dependencies.][cargo/9488]
1223 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
1224   This variable points to a directory that integration tests and benches
1225   can use as a "scratchpad" for testing filesystem operations.
1226
1227 Compatibility Notes
1228 -------------------
1229 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
1230 - [Previously unsound code is no longer permitted where different constructors in branches
1231   could require different lifetimes.][85574]
1232 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
1233   than before and may reject some previously accepted code.
1234 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
1235    when compiled with `codegen-units = 1`.][86063]
1236
1237 [85574]: https://github.com/rust-lang/rust/issues/85574
1238 [86831]: https://github.com/rust-lang/rust/issues/86831
1239 [86063]: https://github.com/rust-lang/rust/issues/86063
1240 [79608]: https://github.com/rust-lang/rust/pull/79608
1241 [84988]: https://github.com/rust-lang/rust/pull/84988
1242 [84701]: https://github.com/rust-lang/rust/pull/84701
1243 [84072]: https://github.com/rust-lang/rust/pull/84072
1244 [85745]: https://github.com/rust-lang/rust/pull/85745
1245 [84744]: https://github.com/rust-lang/rust/pull/84744
1246 [85078]: https://github.com/rust-lang/rust/pull/85078
1247 [84717]: https://github.com/rust-lang/rust/pull/84717
1248 [83800]: https://github.com/rust-lang/rust/pull/83800
1249 [83366]: https://github.com/rust-lang/rust/pull/83366
1250 [83278]: https://github.com/rust-lang/rust/pull/83278
1251 [85292]: https://github.com/rust-lang/rust/pull/85292
1252 [82834]: https://github.com/rust-lang/rust/pull/82834
1253 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
1254 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
1255 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
1256 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
1257 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
1258 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
1259 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
1260 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
1261 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
1262 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
1263 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
1264
1265 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
1266
1267 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
1268
1269 Version 1.53.0 (2021-06-17)
1270 ============================
1271
1272 Language
1273 -----------------------
1274 - [You can now use unicode for identifiers.][83799] This allows multilingual
1275   identifiers but still doesn't allow glyphs that are not considered characters
1276   such as `◆` or `🦀`. More specifically you can now use any identifier that
1277   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
1278   is the same standard as languages like Python, however Rust uses NFC
1279   normalization which may be different from other languages.
1280 - [You can now specify "or patterns" inside pattern matches.][79278]
1281   Previously you could only use `|` (OR) on complete patterns. E.g.
1282   ```rust
1283   let x = Some(2u8);
1284   // Before
1285   matches!(x, Some(1) | Some(2));
1286   // Now
1287   matches!(x, Some(1 | 2));
1288   ```
1289 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
1290   has the same semantics as the `:pat` matcher. This is to allow `:pat`
1291   to change semantics to being a pattern fragment in a future edition.
1292
1293 Compiler
1294 -----------------------
1295 - [Updated the minimum external LLVM version to LLVM 10.][83387]
1296 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
1297 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
1298
1299 \* Refer to Rust's [platform support page][platform-support-doc] for more
1300 information on Rust's tiered platform support.
1301
1302 Libraries
1303 -----------------------
1304 - [Abort messages will now forward to `android_set_abort_message` on
1305   Android platforms when available.][81469]
1306 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
1307 - [Arrays of any length now implement `IntoIterator`.][84147]
1308   Currently calling `.into_iter()` as a method on an array will
1309   return `impl Iterator<Item=&T>`, but this may change in a
1310   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
1311   directly on arrays will provide `impl Iterator<Item=T>` as expected.
1312 - [`leading_zeros`, and `trailing_zeros` are now available on all
1313   `NonZero` integer types.][84082]
1314 - [`{f32, f64}::from_str` now parse and print special values
1315   (`NaN`, `-0`) according to IEEE 754.][78618]
1316 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
1317 - [Add the `BITS` associated constant to all numeric types.][82565]
1318
1319 Stabilised APIs
1320 ---------------
1321 - [`AtomicBool::fetch_update`]
1322 - [`AtomicPtr::fetch_update`]
1323 - [`BTreeMap::retain`]
1324 - [`BTreeSet::retain`]
1325 - [`BufReader::seek_relative`]
1326 - [`DebugStruct::non_exhaustive`]
1327 - [`Duration::MAX`]
1328 - [`Duration::ZERO`]
1329 - [`Duration::is_zero`]
1330 - [`Duration::saturating_add`]
1331 - [`Duration::saturating_mul`]
1332 - [`Duration::saturating_sub`]
1333 - [`ErrorKind::Unsupported`]
1334 - [`Option::insert`]
1335 - [`Ordering::is_eq`]
1336 - [`Ordering::is_ge`]
1337 - [`Ordering::is_gt`]
1338 - [`Ordering::is_le`]
1339 - [`Ordering::is_lt`]
1340 - [`Ordering::is_ne`]
1341 - [`OsStr::is_ascii`]
1342 - [`OsStr::make_ascii_lowercase`]
1343 - [`OsStr::make_ascii_uppercase`]
1344 - [`OsStr::to_ascii_lowercase`]
1345 - [`OsStr::to_ascii_uppercase`]
1346 - [`Peekable::peek_mut`]
1347 - [`Rc::decrement_strong_count`]
1348 - [`Rc::increment_strong_count`]
1349 - [`Vec::extend_from_within`]
1350 - [`array::from_mut`]
1351 - [`array::from_ref`]
1352 - [`cmp::max_by_key`]
1353 - [`cmp::max_by`]
1354 - [`cmp::min_by_key`]
1355 - [`cmp::min_by`]
1356 - [`f32::is_subnormal`]
1357 - [`f64::is_subnormal`]
1358
1359 Cargo
1360 -----------------------
1361 - [Cargo now supports git repositories where the default `HEAD` branch is not
1362   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
1363   which can handle default branches correctly.
1364 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
1365 - [The `authors` field is no longer included in `Cargo.toml` for new
1366   projects.][cargo/9282]
1367
1368 Rustdoc
1369 -----------------------
1370 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
1371   without hyperlinks.][81764]
1372
1373 Compatibility Notes
1374 -------------------
1375 - [Implement token-based handling of attributes during expansion][82608]
1376 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
1377   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
1378   to confusion and potential security vulnerabilities and [is no
1379   longer recommended][ietf6943].
1380 - [The added `BITS` constant may conflict with external definitions.][85667]
1381   In particular, this was known to be a problem in the `lexical-core` crate,
1382   but they have published fixes for semantic versions 0.4 through 0.7. To
1383   update this dependency alone, use `cargo update -p lexical-core`.
1384 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
1385
1386 Internal Only
1387 -------------
1388 These changes provide no direct user facing benefits, but represent significant
1389 improvements to the internals and overall performance of rustc and
1390 related tools.
1391
1392 - [Rework the `std::sys::windows::alloc` implementation.][83065]
1393 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
1394 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
1395 - [Rework rustdoc const type][82873]
1396
1397 [85667]: https://github.com/rust-lang/rust/pull/85667
1398 [83386]: https://github.com/rust-lang/rust/pull/83386
1399 [82771]: https://github.com/rust-lang/rust/pull/82771
1400 [84147]: https://github.com/rust-lang/rust/pull/84147
1401 [84082]: https://github.com/rust-lang/rust/pull/84082
1402 [83799]: https://github.com/rust-lang/rust/pull/83799
1403 [83681]: https://github.com/rust-lang/rust/pull/83681
1404 [83652]: https://github.com/rust-lang/rust/pull/83652
1405 [83387]: https://github.com/rust-lang/rust/pull/83387
1406 [82873]: https://github.com/rust-lang/rust/pull/82873
1407 [82864]: https://github.com/rust-lang/rust/pull/82864
1408 [82608]: https://github.com/rust-lang/rust/pull/82608
1409 [82565]: https://github.com/rust-lang/rust/pull/82565
1410 [80525]: https://github.com/rust-lang/rust/pull/80525
1411 [79278]: https://github.com/rust-lang/rust/pull/79278
1412 [78618]: https://github.com/rust-lang/rust/pull/78618
1413 [77704]: https://github.com/rust-lang/rust/pull/77704
1414 [83941]: https://github.com/rust-lang/rust/pull/83941
1415 [83065]: https://github.com/rust-lang/rust/pull/83065
1416 [81764]: https://github.com/rust-lang/rust/pull/81764
1417 [81469]: https://github.com/rust-lang/rust/pull/81469
1418 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
1419 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
1420 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
1421 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
1422 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
1423 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
1424 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
1425 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
1426 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
1427 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
1428 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
1429 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
1430 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
1431 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
1432 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
1433 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
1434 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
1435 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
1436 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
1437 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
1438 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
1439 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
1440 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
1441 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
1442 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
1443 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
1444 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
1445 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
1446 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
1447 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
1448 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
1449 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
1450 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
1451 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
1452 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
1453 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
1454 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
1455 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
1456 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
1457 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
1458 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
1459
1460
1461 Version 1.52.1 (2021-05-10)
1462 ============================
1463
1464 This release disables incremental compilation, unless the user has explicitly
1465 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
1466
1467 This is due to the widespread, and frequently occurring, breakage encountered by
1468 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
1469 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
1470 newly added incremental verification are still present in past stable versions,
1471 and are not yet fixed on any channel. These bugs can lead to miscompilation of
1472 Rust binaries.
1473
1474 These problems only affect incremental builds, so release builds with Cargo
1475 should not be affected unless the user has explicitly opted into incremental.
1476 Debug and check builds are affected.
1477
1478 See [84970] for more details.
1479
1480 [84970]: https://github.com/rust-lang/rust/issues/84970
1481
1482 Version 1.52.0 (2021-05-06)
1483 ============================
1484
1485 Language
1486 --------
1487 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
1488   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
1489   is allowed by default, and may become a warning or hard error in a
1490   future edition.
1491 - [You can now cast mutable references to arrays to a pointer of the same type as
1492   the element.][81479]
1493
1494 Compiler
1495 --------
1496 - [Upgraded the default LLVM to LLVM 12.][81451]
1497
1498 Added tier 3\* support for the following targets.
1499
1500 - [`s390x-unknown-linux-musl`][82166]
1501 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
1502 - [`powerpc-unknown-openbsd`][82733]
1503
1504 \* Refer to Rust's [platform support page][platform-support-doc] for more
1505 information on Rust's tiered platform support.
1506
1507 Libraries
1508 ---------
1509 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
1510 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
1511 - [`Arc<impl Error>` now implements `error::Error`.][80553]
1512 - [All integer division and remainder operations are now `const`.][80962]
1513
1514 Stabilised APIs
1515 -------------
1516 - [`Arguments::as_str`]
1517 - [`char::MAX`]
1518 - [`char::REPLACEMENT_CHARACTER`]
1519 - [`char::UNICODE_VERSION`]
1520 - [`char::decode_utf16`]
1521 - [`char::from_digit`]
1522 - [`char::from_u32_unchecked`]
1523 - [`char::from_u32`]
1524 - [`slice::partition_point`]
1525 - [`str::rsplit_once`]
1526 - [`str::split_once`]
1527
1528 The following previously stable APIs are now `const`.
1529
1530 - [`char::len_utf8`]
1531 - [`char::len_utf16`]
1532 - [`char::to_ascii_uppercase`]
1533 - [`char::to_ascii_lowercase`]
1534 - [`char::eq_ignore_ascii_case`]
1535 - [`u8::to_ascii_uppercase`]
1536 - [`u8::to_ascii_lowercase`]
1537 - [`u8::eq_ignore_ascii_case`]
1538
1539 Rustdoc
1540 -------
1541 - [Rustdoc lints are now treated as a tool lint, meaning that
1542   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
1543   Using the old style is still allowed, and will become a warning in
1544   a future release.
1545 - [Rustdoc now supports argument files.][82261]
1546 - [Rustdoc now generates smart punctuation for documentation.][79423]
1547 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
1548   ```markdown
1549   - [x] Complete
1550   - [ ] Todo
1551   ```
1552
1553 Misc
1554 ----
1555 - [You can now pass multiple filters to tests.][81356] E.g.
1556   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
1557 - [Rustup now distributes PDB symbols for the `std` library on Windows,
1558   allowing you to see `std` symbols when debugging.][82218]
1559
1560 Internal Only
1561 -------------
1562 These changes provide no direct user facing benefits, but represent significant
1563 improvements to the internals and overall performance of rustc and
1564 related tools.
1565
1566 - [Check the result cache before the DepGraph when ensuring queries][81855]
1567 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
1568 - [Only store a LocalDefId in some HIR nodes][81611]
1569 - [Store HIR attributes in a side table][79519]
1570
1571 Compatibility Notes
1572 -------------------
1573 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
1574 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
1575 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
1576 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
1577   languages in code blocks.][78429]
1578 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
1579 - [Changes in how proc macros handle whitespace may lead to panics when used
1580   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
1581 - [Turn `#[derive]` into a regular macro attribute][79078]
1582
1583 [84136]: https://github.com/rust-lang/rust/issues/84136
1584 [80763]: https://github.com/rust-lang/rust/pull/80763
1585 [82166]: https://github.com/rust-lang/rust/pull/82166
1586 [82121]: https://github.com/rust-lang/rust/pull/82121
1587 [81879]: https://github.com/rust-lang/rust/pull/81879
1588 [82261]: https://github.com/rust-lang/rust/pull/82261
1589 [82218]: https://github.com/rust-lang/rust/pull/82218
1590 [82216]: https://github.com/rust-lang/rust/pull/82216
1591 [82202]: https://github.com/rust-lang/rust/pull/82202
1592 [81855]: https://github.com/rust-lang/rust/pull/81855
1593 [81766]: https://github.com/rust-lang/rust/pull/81766
1594 [81744]: https://github.com/rust-lang/rust/pull/81744
1595 [81611]: https://github.com/rust-lang/rust/pull/81611
1596 [81479]: https://github.com/rust-lang/rust/pull/81479
1597 [81451]: https://github.com/rust-lang/rust/pull/81451
1598 [81356]: https://github.com/rust-lang/rust/pull/81356
1599 [80962]: https://github.com/rust-lang/rust/pull/80962
1600 [80553]: https://github.com/rust-lang/rust/pull/80553
1601 [80527]: https://github.com/rust-lang/rust/pull/80527
1602 [79519]: https://github.com/rust-lang/rust/pull/79519
1603 [79423]: https://github.com/rust-lang/rust/pull/79423
1604 [79208]: https://github.com/rust-lang/rust/pull/79208
1605 [78429]: https://github.com/rust-lang/rust/pull/78429
1606 [82733]: https://github.com/rust-lang/rust/pull/82733
1607 [82594]: https://github.com/rust-lang/rust/pull/82594
1608 [79078]: https://github.com/rust-lang/rust/pull/79078
1609 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1610 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1611 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1612 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1613 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1614 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1615 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1616 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1617 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1618 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1619 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1620 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1621 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1622 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1623 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1624 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1625 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1626 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1627 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1628 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1629 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1630 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1631
1632 Version 1.51.0 (2021-03-25)
1633 ============================
1634
1635 Language
1636 --------
1637 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1638   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1639   E.g. you can now write the following. Note: Only values of primitive integers,
1640   `bool`, or `char` types are currently permitted.
1641   ```rust
1642   struct GenericArray<T, const LENGTH: usize> {
1643       inner: [T; LENGTH]
1644   }
1645
1646   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1647       const fn last(&self) -> Option<&T> {
1648           if LENGTH == 0 {
1649               None
1650           } else {
1651               Some(&self.inner[LENGTH - 1])
1652           }
1653       }
1654   }
1655   ```
1656
1657
1658 Compiler
1659 --------
1660
1661 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1662   This option controls whether debug information is split across multiple files
1663   or packed into a single file. **Note** This option is unstable on other platforms.
1664 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1665   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1666 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1667 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1668
1669 \* Refer to Rust's [platform support page][platform-support-doc] for more
1670 information on Rust's tiered platform support.
1671
1672 Libraries
1673 ---------
1674
1675 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1676 - [`str` now implements `AsMut<str>`.][80279]
1677 - [`u64` and `u128` now implement `From<char>`.][79502]
1678 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1679 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1680 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1681 - [`io::Empty` now implements `io::Seek`.][78044]
1682 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1683   `T: ?Sized` types.][80764]
1684 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1685
1686
1687 Stabilized APIs
1688 ---------------
1689
1690 - [`Arc::decrement_strong_count`]
1691 - [`Arc::increment_strong_count`]
1692 - [`Once::call_once_force`]
1693 - [`Peekable::next_if_eq`]
1694 - [`Peekable::next_if`]
1695 - [`Seek::stream_position`]
1696 - [`array::IntoIter`]
1697 - [`panic::panic_any`]
1698 - [`ptr::addr_of!`]
1699 - [`ptr::addr_of_mut!`]
1700 - [`slice::fill_with`]
1701 - [`slice::split_inclusive_mut`]
1702 - [`slice::split_inclusive`]
1703 - [`slice::strip_prefix`]
1704 - [`slice::strip_suffix`]
1705 - [`str::split_inclusive`]
1706 - [`sync::OnceState`]
1707 - [`task::Wake`]
1708 - [`VecDeque::range`]
1709 - [`VecDeque::range_mut`]
1710
1711 Cargo
1712 -----
1713 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1714   codegen option.][cargo/9112]
1715 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1716   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1717   to avoid unifying features of dependencies where that unification could be unwanted.
1718   Such as using the same dependency with a `std` feature in a build scripts and
1719   proc-macros, while using the `no-std` feature in the final binary. See the
1720   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1721
1722 Rustdoc
1723 -------
1724
1725 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1726 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1727   documentation.][79642]
1728
1729 Various improvements to intra-doc links:
1730
1731 - [You can link to non-path primitives such as `slice`.][80181]
1732 - [You can link to associated items.][74489]
1733 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1734
1735 Misc
1736 ----
1737 - [You can now pass `--include-ignored` to tests (e.g. with
1738   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1739
1740 Compatibility Notes
1741 -------------------
1742
1743 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1744 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1745   could fail.][80579]
1746 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1747   for the distributed artifacts.][81521]
1748     - `armv5te-unknown-linux-gnueabi`
1749     - `sparc64-unknown-linux-gnu`
1750     - `thumbv7neon-unknown-linux-gnueabihf`
1751     - `armv7-unknown-linux-gnueabi`
1752     - `x86_64-unknown-linux-gnux32`
1753 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1754
1755 Internal Only
1756 -------------
1757
1758 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1759
1760 [79135]: https://github.com/rust-lang/rust/pull/79135
1761 [74489]: https://github.com/rust-lang/rust/pull/74489
1762 [76934]: https://github.com/rust-lang/rust/pull/76934
1763 [79570]: https://github.com/rust-lang/rust/pull/79570
1764 [80181]: https://github.com/rust-lang/rust/pull/80181
1765 [79642]: https://github.com/rust-lang/rust/pull/79642
1766 [80945]: https://github.com/rust-lang/rust/pull/80945
1767 [80279]: https://github.com/rust-lang/rust/pull/80279
1768 [80053]: https://github.com/rust-lang/rust/pull/80053
1769 [79502]: https://github.com/rust-lang/rust/pull/79502
1770 [75180]: https://github.com/rust-lang/rust/pull/75180
1771 [81521]: https://github.com/rust-lang/rust/pull/81521
1772 [80968]: https://github.com/rust-lang/rust/pull/80968
1773 [80959]: https://github.com/rust-lang/rust/pull/80959
1774 [80718]: https://github.com/rust-lang/rust/pull/80718
1775 [80653]: https://github.com/rust-lang/rust/pull/80653
1776 [80579]: https://github.com/rust-lang/rust/pull/80579
1777 [79998]: https://github.com/rust-lang/rust/pull/79998
1778 [78044]: https://github.com/rust-lang/rust/pull/78044
1779 [81455]: https://github.com/rust-lang/rust/pull/81455
1780 [80764]: https://github.com/rust-lang/rust/pull/80764
1781 [80749]: https://github.com/rust-lang/rust/pull/80749
1782 [80662]: https://github.com/rust-lang/rust/pull/80662
1783 [79134]: https://github.com/rust-lang/rust/pull/79134
1784 [80966]: https://github.com/rust-lang/rust/pull/80966
1785 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1786 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1787 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1788 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1789 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1790 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1791 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1792 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1793 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1794 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1795 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1796 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1797 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1798 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1799 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1800 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1801 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1802 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1803 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1804 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1805 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1806 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1807 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1808
1809 Version 1.50.0 (2021-02-11)
1810 ============================
1811
1812 Language
1813 -----------------------
1814 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1815   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1816 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1817
1818 Compiler
1819 -----------------------
1820 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1821 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1822 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1823 - [Dropped support for all cloudabi targets.][78439]
1824
1825 \* Refer to Rust's [platform support page][platform-support-doc] for more
1826 information on Rust's tiered platform support.
1827
1828 Libraries
1829 -----------------------
1830
1831 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1832 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1833 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1834   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1835   up the same amount of space as `File`.
1836
1837 Stabilized APIs
1838 ---------------
1839
1840 - [`bool::then`]
1841 - [`btree_map::Entry::or_insert_with_key`]
1842 - [`f32::clamp`]
1843 - [`f64::clamp`]
1844 - [`hash_map::Entry::or_insert_with_key`]
1845 - [`Ord::clamp`]
1846 - [`RefCell::take`]
1847 - [`slice::fill`]
1848 - [`UnsafeCell::get_mut`]
1849
1850 The following previously stable methods are now `const`.
1851
1852 - [`IpAddr::is_ipv4`]
1853 - [`IpAddr::is_ipv6`]
1854 - [`IpAddr::is_unspecified`]
1855 - [`IpAddr::is_loopback`]
1856 - [`IpAddr::is_multicast`]
1857 - [`Ipv4Addr::octets`]
1858 - [`Ipv4Addr::is_loopback`]
1859 - [`Ipv4Addr::is_private`]
1860 - [`Ipv4Addr::is_link_local`]
1861 - [`Ipv4Addr::is_multicast`]
1862 - [`Ipv4Addr::is_broadcast`]
1863 - [`Ipv4Addr::is_documentation`]
1864 - [`Ipv4Addr::to_ipv6_compatible`]
1865 - [`Ipv4Addr::to_ipv6_mapped`]
1866 - [`Ipv6Addr::segments`]
1867 - [`Ipv6Addr::is_unspecified`]
1868 - [`Ipv6Addr::is_loopback`]
1869 - [`Ipv6Addr::is_multicast`]
1870 - [`Ipv6Addr::to_ipv4`]
1871 - [`Layout::size`]
1872 - [`Layout::align`]
1873 - [`Layout::from_size_align`]
1874 - `pow` for all integer types.
1875 - `checked_pow` for all integer types.
1876 - `saturating_pow` for all integer types.
1877 - `wrapping_pow` for all integer types.
1878 - `next_power_of_two` for all unsigned integer types.
1879 - `checked_next_power_of_two` for all unsigned integer types.
1880
1881 Cargo
1882 -----------------------
1883
1884 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1885   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1886 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1887   contents of that directory for changes.][cargo/8973]
1888 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1889
1890 Misc
1891 ----
1892
1893 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1894 - [Running tests will now print the total time taken to execute.][75752]
1895
1896 Compatibility Notes
1897 -------------------
1898
1899 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1900   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1901 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1902   unhygenic `macro_rules!` macros.][79472]
1903 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1904   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1905 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1906 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1907   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1908 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1909
1910 [74989]: https://github.com/rust-lang/rust/pull/74989
1911 [79261]: https://github.com/rust-lang/rust/pull/79261
1912 [79896]: https://github.com/rust-lang/rust/pull/79896
1913 [79484]: https://github.com/rust-lang/rust/pull/79484
1914 [79472]: https://github.com/rust-lang/rust/pull/79472
1915 [79270]: https://github.com/rust-lang/rust/pull/79270
1916 [79003]: https://github.com/rust-lang/rust/pull/79003
1917 [78864]: https://github.com/rust-lang/rust/pull/78864
1918 [78636]: https://github.com/rust-lang/rust/pull/78636
1919 [78439]: https://github.com/rust-lang/rust/pull/78439
1920 [78343]: https://github.com/rust-lang/rust/pull/78343
1921 [78296]: https://github.com/rust-lang/rust/pull/78296
1922 [78068]: https://github.com/rust-lang/rust/pull/78068
1923 [75752]: https://github.com/rust-lang/rust/pull/75752
1924 [74699]: https://github.com/rust-lang/rust/pull/74699
1925 [78142]: https://github.com/rust-lang/rust/pull/78142
1926 [77484]: https://github.com/rust-lang/rust/pull/77484
1927 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1928 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1929 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1930 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1931 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1932 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1933 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1934 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1935 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1936 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1937 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1938 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1939 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1940 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1941 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1942 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1943 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1944 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1945 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1946 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1947 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1948 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1949 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1950 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1951 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1952 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1953 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1954 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1955 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1956 [`btree_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/btree_map/enum.Entry.html#method.or_insert_with_key
1957 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1958 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1959 [`hash_map::Entry::or_insert_with_key`]: https://doc.rust-lang.org/stable/std/collections/hash_map/enum.Entry.html#method.or_insert_with_key
1960 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1961
1962
1963 Version 1.49.0 (2020-12-31)
1964 ============================
1965
1966 Language
1967 -----------------------
1968
1969 - [Unions can now implement `Drop`, and you can now have a field in a union
1970   with `ManuallyDrop<T>`.][77547]
1971 - [You can now cast uninhabited enums to integers.][76199]
1972 - [You can now bind by reference and by move in patterns.][76119] This
1973   allows you to selectively borrow individual components of a type. E.g.
1974   ```rust
1975   #[derive(Debug)]
1976   struct Person {
1977       name: String,
1978       age: u8,
1979   }
1980
1981   let person = Person {
1982       name: String::from("Alice"),
1983       age: 20,
1984   };
1985
1986   // `name` is moved out of person, but `age` is referenced.
1987   let Person { name, ref age } = person;
1988   println!("{} {}", name, age);
1989   ```
1990
1991 Compiler
1992 -----------------------
1993
1994 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1995 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1996 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1997 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1998 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1999 - [Output from threads spawned in tests is now captured.][78227]
2000 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
2001
2002 \* Refer to Rust's [platform support page][platform-support-doc] for more
2003 information on Rust's tiered platform support.
2004
2005 Libraries
2006 -----------------------
2007
2008 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
2009 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
2010
2011 Stabilized APIs
2012 ---------------
2013
2014 - [`slice::select_nth_unstable`]
2015 - [`slice::select_nth_unstable_by`]
2016 - [`slice::select_nth_unstable_by_key`]
2017
2018 The following previously stable methods are now `const`.
2019
2020 - [`Poll::is_ready`]
2021 - [`Poll::is_pending`]
2022
2023 Cargo
2024 -----------------------
2025 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
2026 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
2027 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
2028   variable will be set if the crate being built is one the user selected to build, either
2029   with `-p` or through defaults.
2030 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
2031
2032
2033 Compatibility Notes
2034 -------------------
2035
2036 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
2037 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
2038 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
2039   Previously such invalid or unused attributes could be ignored.
2040 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
2041   read [this post about the changes][rustdoc-ws-post] for more details.
2042 - [Trait bounds are no longer inferred for associated types.][79904]
2043
2044 Internal Only
2045 -------------
2046 These changes provide no direct user facing benefits, but represent significant
2047 improvements to the internals and overall performance of rustc and
2048 related tools.
2049
2050 - [rustc's internal crates are now compiled using the `initial-exec` Thread
2051   Local Storage model.][78201]
2052 - [Calculate visibilities once in resolve.][78077]
2053 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
2054 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
2055
2056
2057 [75991]: https://github.com/rust-lang/rust/pull/75991
2058 [78951]: https://github.com/rust-lang/rust/pull/78951
2059 [78848]: https://github.com/rust-lang/rust/pull/78848
2060 [78746]: https://github.com/rust-lang/rust/pull/78746
2061 [78376]: https://github.com/rust-lang/rust/pull/78376
2062 [78228]: https://github.com/rust-lang/rust/pull/78228
2063 [78227]: https://github.com/rust-lang/rust/pull/78227
2064 [78201]: https://github.com/rust-lang/rust/pull/78201
2065 [78109]: https://github.com/rust-lang/rust/pull/78109
2066 [78077]: https://github.com/rust-lang/rust/pull/78077
2067 [77997]: https://github.com/rust-lang/rust/pull/77997
2068 [77703]: https://github.com/rust-lang/rust/pull/77703
2069 [77547]: https://github.com/rust-lang/rust/pull/77547
2070 [77015]: https://github.com/rust-lang/rust/pull/77015
2071 [76199]: https://github.com/rust-lang/rust/pull/76199
2072 [76119]: https://github.com/rust-lang/rust/pull/76119
2073 [75914]: https://github.com/rust-lang/rust/pull/75914
2074 [79004]: https://github.com/rust-lang/rust/pull/79004
2075 [78676]: https://github.com/rust-lang/rust/pull/78676
2076 [79904]: https://github.com/rust-lang/rust/issues/79904
2077 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
2078 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
2079 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
2080 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
2081 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
2082 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
2083 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
2084 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
2085 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
2086 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
2087
2088 Version 1.48.0 (2020-11-19)
2089 ==========================
2090
2091 Language
2092 --------
2093
2094 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
2095   is still rejected *semantically*, but can now be parsed by procedural macros.
2096
2097 Compiler
2098 --------
2099 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
2100   `rustc` whether to link its own C runtime and libraries or to rely on a external
2101   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
2102 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
2103   Note: If you're using cargo you must explicitly pass the `--target` flag.
2104 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
2105
2106 \* Refer to Rust's [platform support page][platform-support-doc] for more
2107 information on Rust's tiered platform support.
2108
2109 Libraries
2110 ---------
2111 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
2112   and `&Stderr`.][76275]
2113 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
2114 - [The `matches!` macro now supports having a trailing comma.][74880]
2115 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
2116 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
2117
2118 Stabilized APIs
2119 ---------------
2120 - [`slice::as_ptr_range`]
2121 - [`slice::as_mut_ptr_range`]
2122 - [`VecDeque::make_contiguous`]
2123 - [`future::pending`]
2124 - [`future::ready`]
2125
2126 The following previously stable methods are now `const fn`'s:
2127
2128 - [`Option::is_some`]
2129 - [`Option::is_none`]
2130 - [`Option::as_ref`]
2131 - [`Result::is_ok`]
2132 - [`Result::is_err`]
2133 - [`Result::as_ref`]
2134 - [`Ordering::reverse`]
2135 - [`Ordering::then`]
2136
2137 Cargo
2138 -----
2139
2140 Rustdoc
2141 -------
2142 - [You can now link to items in `rustdoc` using the intra-doc link
2143   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
2144   a link to `std::future`'s documentation. See ["Linking to items by
2145   name"][intradoc-links] for more information.
2146 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
2147   when searching through `rustdoc`'s UI.][75740]
2148
2149 Compatibility Notes
2150 -------------------
2151 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
2152   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
2153   promoted to `'static` lifetime any more inside `const fn`s.
2154 - [Associated type bindings on trait objects are now verified to meet the bounds
2155   declared on the trait when checking that they implement the trait.][27675]
2156 - [When trait bounds on associated types or opaque types are ambiguous, the
2157   compiler no longer makes an arbitrary choice on which bound to use.][54121]
2158 - [Fixed recursive nonterminals not being expanded in macros during
2159   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
2160   correctly handling recursive nonterminal tokens.
2161 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
2162 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
2163   in places where they have no effect.][73461]
2164 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
2165   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
2166 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
2167   disallow zero-initialization.][71274]
2168 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
2169 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
2170   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
2171   see the [`catch_unwind`] documentation for further information.
2172
2173
2174
2175 Internal Only
2176 -------------
2177 These changes provide no direct user facing benefits, but represent significant
2178 improvements to the internals and overall performance of rustc and
2179 related tools.
2180
2181 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
2182   You can continue building with `make` by setting `ninja=false` in
2183   your `config.toml`.
2184 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
2185 - [Made `ensure_sufficient_stack()` non-generic][76680]
2186
2187 [78143]: https://github.com/rust-lang/rust/issues/78143
2188 [76680]: https://github.com/rust-lang/rust/pull/76680/
2189 [76030]: https://github.com/rust-lang/rust/pull/76030/
2190 [70212]: https://github.com/rust-lang/rust/pull/70212/
2191 [27675]: https://github.com/rust-lang/rust/issues/27675/
2192 [54121]: https://github.com/rust-lang/rust/issues/54121/
2193 [71274]: https://github.com/rust-lang/rust/pull/71274/
2194 [77386]: https://github.com/rust-lang/rust/pull/77386/
2195 [77153]: https://github.com/rust-lang/rust/pull/77153/
2196 [77055]: https://github.com/rust-lang/rust/pull/77055/
2197 [76275]: https://github.com/rust-lang/rust/pull/76275/
2198 [76310]: https://github.com/rust-lang/rust/pull/76310/
2199 [76420]: https://github.com/rust-lang/rust/pull/76420/
2200 [76158]: https://github.com/rust-lang/rust/pull/76158/
2201 [75857]: https://github.com/rust-lang/rust/pull/75857/
2202 [75585]: https://github.com/rust-lang/rust/pull/75585/
2203 [75740]: https://github.com/rust-lang/rust/pull/75740/
2204 [75502]: https://github.com/rust-lang/rust/pull/75502/
2205 [74880]: https://github.com/rust-lang/rust/pull/74880/
2206 [74922]: https://github.com/rust-lang/rust/pull/74922/
2207 [74430]: https://github.com/rust-lang/rust/pull/74430/
2208 [74194]: https://github.com/rust-lang/rust/pull/74194/
2209 [73461]: https://github.com/rust-lang/rust/pull/73461/
2210 [73166]: https://github.com/rust-lang/rust/pull/73166/
2211 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
2212 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
2213 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
2214 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
2215 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
2216 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
2217 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
2218 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
2219 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
2220 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2221 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
2222 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
2223 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
2224 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
2225 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
2226
2227
2228 Version 1.47.0 (2020-10-08)
2229 ==========================
2230
2231 Language
2232 --------
2233 - [Closures will now warn when not used.][74869]
2234
2235 Compiler
2236 --------
2237 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
2238   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
2239   platforms.
2240 - [Upgraded to LLVM 11.][73526]
2241 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
2242 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
2243 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
2244
2245 \* Refer to Rust's [platform support page][platform-support-doc] for more
2246 information on Rust's tiered platform support.
2247
2248 Libraries
2249 ---------
2250 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
2251 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
2252   those of length less than 33.][74060]
2253 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
2254 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
2255   `PartialEq`, and `PartialOrd`.][73583]
2256
2257 Stabilized APIs
2258 ---------------
2259 - [`Ident::new_raw`]
2260 - [`Range::is_empty`]
2261 - [`RangeInclusive::is_empty`]
2262 - [`Result::as_deref`]
2263 - [`Result::as_deref_mut`]
2264 - [`Vec::leak`]
2265 - [`pointer::offset_from`]
2266 - [`f32::TAU`]
2267 - [`f64::TAU`]
2268
2269 The following previously stable APIs have now been made const.
2270
2271 - [The `new` method for all `NonZero` integers.][73858]
2272 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
2273   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
2274   methods for all integers.][73858]
2275 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
2276   signed integers.][73858]
2277 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
2278   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
2279   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
2280   `is_ascii_control` methods for `char` and `u8`.][73858]
2281
2282 Cargo
2283 -----
2284 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
2285   You can override this by setting the following in your `Cargo.toml`.
2286   ```toml
2287   [profile.release.build-override]
2288   opt-level = 3
2289   ```
2290 - [`cargo-help` will now display man pages for commands rather just the
2291   `--help` text.][cargo/8456]
2292 - [`cargo-metadata` now emits a `test` field indicating if a target has
2293   tests enabled.][cargo/8478]
2294 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
2295 - [`cargo-publish` will now use an alternative registry by default if it's the
2296   only registry specified in `package.publish`.][cargo/8571]
2297
2298 Misc
2299 ----
2300 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
2301   type based search.][75366]
2302 - [Added the Ayu theme to rustdoc.][71237]
2303
2304 Compatibility Notes
2305 -------------------
2306 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
2307 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
2308 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
2309   help to preserve more span information.][73084] These changes may cause
2310   compiliation errors if your macro was unhygenic or didn't correctly handle
2311   `Delimiter::None`.
2312 - [Moved support for the CloudABI target to tier 3.][75568]
2313 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
2314 - [Added the `rustc-docs` component.][75560] This allows you to install
2315   and read the documentation for the compiler internal APIs. (Currently only
2316   available for `x86_64-unknown-linux-gnu`.)
2317
2318 Internal Only
2319 --------
2320
2321 - [Improved default settings for bootstrapping in `x.py`.][73964] You can read details about this change in the ["Changes to `x.py` defaults"](https://blog.rust-lang.org/inside-rust/2020/08/30/changes-to-x-py-defaults.html) post on the Inside Rust blog.
2322
2323 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
2324 [75048]: https://github.com/rust-lang/rust/pull/75048/
2325 [74163]: https://github.com/rust-lang/rust/pull/74163/
2326 [71237]: https://github.com/rust-lang/rust/pull/71237/
2327 [74869]: https://github.com/rust-lang/rust/pull/74869/
2328 [73858]: https://github.com/rust-lang/rust/pull/73858/
2329 [75716]: https://github.com/rust-lang/rust/pull/75716/
2330 [75560]: https://github.com/rust-lang/rust/pull/75560/
2331 [75568]: https://github.com/rust-lang/rust/pull/75568/
2332 [75366]: https://github.com/rust-lang/rust/pull/75366/
2333 [75204]: https://github.com/rust-lang/rust/pull/75204/
2334 [74650]: https://github.com/rust-lang/rust/pull/74650/
2335 [74419]: https://github.com/rust-lang/rust/pull/74419/
2336 [73964]: https://github.com/rust-lang/rust/pull/73964/
2337 [74021]: https://github.com/rust-lang/rust/pull/74021/
2338 [74060]: https://github.com/rust-lang/rust/pull/74060/
2339 [73893]: https://github.com/rust-lang/rust/pull/73893/
2340 [73526]: https://github.com/rust-lang/rust/pull/73526/
2341 [73583]: https://github.com/rust-lang/rust/pull/73583/
2342 [73084]: https://github.com/rust-lang/rust/pull/73084/
2343 [73197]: https://github.com/rust-lang/rust/pull/73197/
2344 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
2345 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
2346 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
2347 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
2348 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
2349 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
2350 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
2351 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
2352 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
2353 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
2354 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
2355 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
2356 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
2357 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
2358
2359
2360 Version 1.46.0 (2020-08-27)
2361 ==========================
2362
2363 Language
2364 --------
2365 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
2366 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
2367   const functions.][73862]
2368 - [The `#[track_caller]` attribute can now be added to functions to use the
2369   function's caller's location information for panic messages.][72445]
2370 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
2371   `x.0.0` over `(x.0).0`.
2372 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
2373   You currently can't use `mem::transmute` in constant functions.
2374
2375 Compiler
2376 --------
2377 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
2378 - [Enabled static "Position Independent Executables" by default
2379   for `x86_64-unknown-linux-musl`.][70740]
2380
2381 Libraries
2382 ---------
2383 - [`mem::forget` is now a `const fn`.][73887]
2384 - [`String` now implements `From<char>`.][73466]
2385 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
2386   integer types.][73032]
2387 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
2388 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
2389   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
2390 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
2391 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
2392 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
2393
2394 Stabilized APIs
2395 ---------------
2396 - [`Option::zip`]
2397 - [`vec::Drain::as_slice`]
2398
2399 Cargo
2400 -----
2401 Added a number of new environment variables that are now available when
2402 compiling your crate.
2403
2404 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
2405   the specific binary being compiled and the name of the crate.
2406 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
2407 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
2408
2409 Compatibility Notes
2410 -------------------
2411 - [The target configuration option `abi_blacklist` has been renamed
2412   to `unsupported_abis`.][74150] The old name will still continue to work.
2413 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
2414   This was previously accepted but will become a hard error in a future release.
2415 - [Rustc will fail to compile if you have a struct with
2416   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
2417   allowed on `enum`s.
2418 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
2419   ensure that spans have the correct information, and may cause breakage if you
2420   were relying on receiving spans with dummy information.
2421 - [The InnoSetup installer for Windows is no longer available.][72569] This was
2422   a legacy installer that was replaced by a MSI installer a few years ago but
2423   was still being built.
2424 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
2425 - [Rustc will no longer accept overlapping trait implementations that only
2426   differ in how the lifetime was bound.][72493]
2427 - [Rustc now correctly relates the lifetime of an existential associated
2428   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
2429   you to pass a shorter lifetime than expected.
2430 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
2431   The library will need to be installed for `rustc` to work, even though we
2432   expect it to be already available on most systems.
2433 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
2434   under QEMU.][74820]
2435 - [Pretty printing of some tokens in procedural macros changed.][75453] The
2436   exact output returned by rustc's pretty printing is an unstable
2437   implementation detail: we recommend any macro relying on it to switch to a
2438   more robust parsing system.
2439
2440 [75453]: https://github.com/rust-lang/rust/issues/75453/
2441 [74820]: https://github.com/rust-lang/rust/issues/74820/
2442 [74420]: https://github.com/rust-lang/rust/issues/74420/
2443 [74109]: https://github.com/rust-lang/rust/pull/74109/
2444 [74150]: https://github.com/rust-lang/rust/pull/74150/
2445 [73862]: https://github.com/rust-lang/rust/pull/73862/
2446 [73887]: https://github.com/rust-lang/rust/pull/73887/
2447 [73466]: https://github.com/rust-lang/rust/pull/73466/
2448 [73516]: https://github.com/rust-lang/rust/pull/73516/
2449 [73293]: https://github.com/rust-lang/rust/pull/73293/
2450 [73007]: https://github.com/rust-lang/rust/pull/73007/
2451 [73032]: https://github.com/rust-lang/rust/pull/73032/
2452 [72920]: https://github.com/rust-lang/rust/pull/72920/
2453 [72569]: https://github.com/rust-lang/rust/pull/72569/
2454 [72583]: https://github.com/rust-lang/rust/pull/72583/
2455 [72584]: https://github.com/rust-lang/rust/pull/72584/
2456 [72717]: https://github.com/rust-lang/rust/pull/72717/
2457 [72437]: https://github.com/rust-lang/rust/pull/72437/
2458 [72445]: https://github.com/rust-lang/rust/pull/72445/
2459 [72486]: https://github.com/rust-lang/rust/pull/72486/
2460 [72493]: https://github.com/rust-lang/rust/pull/72493/
2461 [72331]: https://github.com/rust-lang/rust/pull/72331/
2462 [71896]: https://github.com/rust-lang/rust/pull/71896/
2463 [71660]: https://github.com/rust-lang/rust/pull/71660/
2464 [71322]: https://github.com/rust-lang/rust/pull/71322/
2465 [70740]: https://github.com/rust-lang/rust/pull/70740/
2466 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
2467 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
2468 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
2469 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
2470 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
2471
2472
2473 Version 1.45.2 (2020-08-03)
2474 ==========================
2475
2476 * [Fix bindings in tuple struct patterns][74954]
2477 * [Fix track_caller integration with trait objects][74784]
2478
2479 [74954]: https://github.com/rust-lang/rust/issues/74954
2480 [74784]: https://github.com/rust-lang/rust/issues/74784
2481
2482
2483 Version 1.45.1 (2020-07-30)
2484 ==========================
2485
2486 * [Fix const propagation with references.][73613]
2487 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2488 * [Avoid spurious implicit region bound.][74509]
2489 * [Install clippy on x.py install][74457]
2490
2491 [73613]: https://github.com/rust-lang/rust/pull/73613
2492 [73078]: https://github.com/rust-lang/rust/issues/73078
2493 [74509]: https://github.com/rust-lang/rust/pull/74509
2494 [74457]: https://github.com/rust-lang/rust/pull/74457
2495
2496
2497 Version 1.45.0 (2020-07-16)
2498 ==========================
2499
2500 Language
2501 --------
2502 - [Out of range float to int conversions using `as` has been defined as a saturating
2503   conversion.][71269] This was previously undefined behaviour, but you can use the
2504    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
2505    may be desirable in rare performance sensitive situations.
2506 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
2507   using `u64`.][70705]
2508 - [Function like procedural macros can now be used in expression, pattern, and  statement
2509   positions.][68717] This means you can now use a function-like procedural macro
2510   anywhere you can use a declarative (`macro_rules!`) macro.
2511
2512 Compiler
2513 --------
2514 - [You can now override individual target features through the `target-feature`
2515   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
2516   equivalent to `-C target-feature=+avx2,+fma`.
2517 - [Added the `force-unwind-tables` flag.][69984] This option allows
2518   rustc to always generate unwind tables regardless of panic strategy.
2519 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
2520   to include LLVM bitcode into generated `rlib`s (this is on by default).
2521 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
2522 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
2523 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
2524 - [Upgraded to LLVM 10.][67759]
2525
2526 \* Refer to Rust's [platform support page][platform-support-doc] for more
2527 information on Rust's tiered platform support.
2528
2529
2530 Libraries
2531 ---------
2532 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
2533   and `Ord`.][72239]
2534 - [`proc_macro::TokenStream` now implements `Default`.][72234]
2535 - [You can now use `char` with
2536   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
2537   a range of codepoints.][72413] E.g.
2538   you can now write the following;
2539   ```rust
2540   for ch in 'a'..='z' {
2541       print!("{}", ch);
2542   }
2543   println!();
2544   // Prints "abcdefghijklmnopqrstuvwxyz"
2545   ```
2546 - [`OsString` now implements `FromStr`.][71662]
2547 - [The `saturating_neg` method has been added to all signed integer primitive
2548   types, and the `saturating_abs` method has been added for all integer
2549   primitive types.][71886]
2550 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
2551   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
2552   or `Path`.][71447]
2553 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
2554 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
2555   integer types.][69813]
2556 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
2557   integer types.][72324]
2558 - [The `fetch_update` method has been added to all atomic integer types.][71843]
2559
2560 Stabilized APIs
2561 ---------------
2562 - [`Arc::as_ptr`]
2563 - [`BTreeMap::remove_entry`]
2564 - [`Rc::as_ptr`]
2565 - [`rc::Weak::as_ptr`]
2566 - [`rc::Weak::from_raw`]
2567 - [`rc::Weak::into_raw`]
2568 - [`str::strip_prefix`]
2569 - [`str::strip_suffix`]
2570 - [`sync::Weak::as_ptr`]
2571 - [`sync::Weak::from_raw`]
2572 - [`sync::Weak::into_raw`]
2573 - [`char::UNICODE_VERSION`]
2574 - [`Span::resolved_at`]
2575 - [`Span::located_at`]
2576 - [`Span::mixed_site`]
2577 - [`unix::process::CommandExt::arg0`]
2578
2579 Cargo
2580 -----
2581
2582 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
2583   time.][cargo/8066]
2584
2585 Misc
2586 ----
2587 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2588   `~~outdated information~~` becomes "~~outdated information~~".
2589 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2590
2591 Compatibility Notes
2592 -------------------
2593 - [Trying to self initialize a static value (that is creating a value using
2594   itself) is unsound and now causes a compile error.][71140]
2595 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2596   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2597 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2598   previously undocumented and not intended for public use. Rustdoc still provides
2599   a non-zero exit code on errors.
2600 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2601   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2602   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2603   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2604   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2605
2606 Internals Only
2607 --------------
2608 - [Make clippy a git subtree instead of a git submodule][70655]
2609 - [Unify the undo log of all snapshot types][69464]
2610
2611 [71848]: https://github.com/rust-lang/rust/issues/71848/
2612 [73420]: https://github.com/rust-lang/rust/issues/73420/
2613 [72324]: https://github.com/rust-lang/rust/pull/72324/
2614 [71843]: https://github.com/rust-lang/rust/pull/71843/
2615 [71886]: https://github.com/rust-lang/rust/pull/71886/
2616 [72234]: https://github.com/rust-lang/rust/pull/72234/
2617 [72239]: https://github.com/rust-lang/rust/pull/72239/
2618 [72397]: https://github.com/rust-lang/rust/pull/72397/
2619 [72413]: https://github.com/rust-lang/rust/pull/72413/
2620 [72014]: https://github.com/rust-lang/rust/pull/72014/
2621 [72062]: https://github.com/rust-lang/rust/pull/72062/
2622 [72094]: https://github.com/rust-lang/rust/pull/72094/
2623 [72133]: https://github.com/rust-lang/rust/pull/72133/
2624 [67759]: https://github.com/rust-lang/rust/pull/67759/
2625 [71900]: https://github.com/rust-lang/rust/pull/71900/
2626 [71928]: https://github.com/rust-lang/rust/pull/71928/
2627 [71662]: https://github.com/rust-lang/rust/pull/71662/
2628 [71716]: https://github.com/rust-lang/rust/pull/71716/
2629 [71447]: https://github.com/rust-lang/rust/pull/71447/
2630 [71269]: https://github.com/rust-lang/rust/pull/71269/
2631 [71095]: https://github.com/rust-lang/rust/pull/71095/
2632 [71140]: https://github.com/rust-lang/rust/pull/71140/
2633 [70655]: https://github.com/rust-lang/rust/pull/70655/
2634 [70705]: https://github.com/rust-lang/rust/pull/70705/
2635 [69984]: https://github.com/rust-lang/rust/pull/69984/
2636 [69813]: https://github.com/rust-lang/rust/pull/69813/
2637 [69464]: https://github.com/rust-lang/rust/pull/69464/
2638 [68717]: https://github.com/rust-lang/rust/pull/68717/
2639 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2640 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2641 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2642 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2643 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2644 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2645 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2646 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2647 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2648 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2649 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2650 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2651 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2652 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2653 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2654 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2655 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2656
2657
2658 Version 1.44.1 (2020-06-18)
2659 ===========================
2660
2661 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2662 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2663 * [Fix crashes when finding backtrace on macOS.][71397]
2664 * [Clippy applies lint levels into different files.][clippy/5356]
2665
2666 [71397]: https://github.com/rust-lang/rust/issues/71397
2667 [73078]: https://github.com/rust-lang/rust/issues/73078
2668 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2669 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2670
2671
2672 Version 1.44.0 (2020-06-04)
2673 ==========================
2674
2675 Language
2676 --------
2677 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2678 - [Added the `unused_braces` lint.][70081]
2679
2680 **Syntax-only changes**
2681
2682 - [Expansion-driven outline module parsing][69838]
2683 ```rust
2684 #[cfg(FALSE)]
2685 mod foo {
2686     mod bar {
2687         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2688     }
2689 }
2690 ```
2691
2692 These are still rejected semantically, so you will likely receive an error but
2693 these changes can be seen and parsed by macros and conditional compilation.
2694
2695 Compiler
2696 --------
2697 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2698   Additionally when in incremental mode rustc defaults to 256 codegen units.
2699 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2700   a panic is thrown.][67502]
2701 - [Added tier 3\* support for the `aarch64-unknown-none` and
2702   `aarch64-unknown-none-softfloat` targets.][68334]
2703 - [Added tier 3 support for `arm64-apple-tvos` and
2704   `x86_64-apple-tvos` targets.][68191]
2705
2706
2707 Libraries
2708 ---------
2709 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2710   `vec![]` to be able to be used in `const` contexts.
2711 - [`convert::Infallible` now implements `Hash`.][70281]
2712 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2713   a `&mut OsStr`.][70048]
2714 - [Unicode 13 is now supported.][69929]
2715 - [`String` now implements `From<&mut str>`.][69661]
2716 - [`IoSlice` now implements `Copy`.][69403]
2717 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2718 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2719 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2720   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2721   integer types.][69373]
2722
2723 Stabilized APIs
2724 ---------------
2725 - [`PathBuf::with_capacity`]
2726 - [`PathBuf::capacity`]
2727 - [`PathBuf::clear`]
2728 - [`PathBuf::reserve`]
2729 - [`PathBuf::reserve_exact`]
2730 - [`PathBuf::shrink_to_fit`]
2731 - [`f32::to_int_unchecked`]
2732 - [`f64::to_int_unchecked`]
2733 - [`Layout::align_to`]
2734 - [`Layout::pad_to_align`]
2735 - [`Layout::array`]
2736 - [`Layout::extend`]
2737
2738 Cargo
2739 -----
2740 - [Added the `cargo tree` command which will print a tree graph of
2741   your dependencies.][cargo/8062] E.g.
2742   ```
2743     mdbook v0.3.2 (/Users/src/rust/mdbook)
2744   ├── ammonia v3.0.0
2745   │   ├── html5ever v0.24.0
2746   │   │   ├── log v0.4.8
2747   │   │   │   └── cfg-if v0.1.9
2748   │   │   ├── mac v0.1.1
2749   │   │   └── markup5ever v0.9.0
2750   │   │       ├── log v0.4.8 (*)
2751   │   │       ├── phf v0.7.24
2752   │   │       │   └── phf_shared v0.7.24
2753   │   │       │       ├── siphasher v0.2.3
2754   │   │       │       └── unicase v1.4.2
2755   │   │       │           [build-dependencies]
2756   │   │       │           └── version_check v0.1.5
2757   ...
2758   ```
2759   You can also display dependencies on multiple versions of the same crate with
2760   `cargo tree -d` (short for `cargo tree --duplicates`).
2761
2762 Misc
2763 ----
2764 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2765   the version in the sidebar.][69494]
2766
2767 Compatibility Notes
2768 -------------------
2769 - [Rustc now correctly generates static libraries on Windows GNU targets with
2770   the `.a` extension, rather than the previous `.lib`.][70937]
2771 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2772 - [The `file_name` property in JSON output of macro errors now points the actual
2773   source file rather than the previous format of `<NAME macros>`.][70969]
2774   **Note:** this may not point to a file that actually exists on the user's system.
2775 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2776 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2777   not allow zero initialization such as `NonZeroU8`.][66059] This was
2778   previously a warning.
2779 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2780   operator has been defined as a saturating operation.][71269] This was previously
2781   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2782   continue using the current behaviour, which may be desirable in rare performance
2783   sensitive situations.
2784
2785 Internal Only
2786 -------------
2787 These changes provide no direct user facing benefits, but represent significant
2788 improvements to the internals and overall performance of rustc and
2789 related tools.
2790
2791 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2792 - [Replace big JS dict with JSON parsing.][71250]
2793
2794 [69373]: https://github.com/rust-lang/rust/pull/69373/
2795 [66059]: https://github.com/rust-lang/rust/pull/66059/
2796 [68191]: https://github.com/rust-lang/rust/pull/68191/
2797 [68899]: https://github.com/rust-lang/rust/pull/68899/
2798 [71147]: https://github.com/rust-lang/rust/pull/71147/
2799 [71250]: https://github.com/rust-lang/rust/pull/71250/
2800 [70937]: https://github.com/rust-lang/rust/pull/70937/
2801 [70969]: https://github.com/rust-lang/rust/pull/70969/
2802 [70632]: https://github.com/rust-lang/rust/pull/70632/
2803 [70281]: https://github.com/rust-lang/rust/pull/70281/
2804 [70345]: https://github.com/rust-lang/rust/pull/70345/
2805 [70048]: https://github.com/rust-lang/rust/pull/70048/
2806 [70081]: https://github.com/rust-lang/rust/pull/70081/
2807 [70156]: https://github.com/rust-lang/rust/pull/70156/
2808 [71269]: https://github.com/rust-lang/rust/pull/71269/
2809 [69838]: https://github.com/rust-lang/rust/pull/69838/
2810 [69929]: https://github.com/rust-lang/rust/pull/69929/
2811 [69661]: https://github.com/rust-lang/rust/pull/69661/
2812 [69778]: https://github.com/rust-lang/rust/pull/69778/
2813 [69494]: https://github.com/rust-lang/rust/pull/69494/
2814 [69403]: https://github.com/rust-lang/rust/pull/69403/
2815 [69033]: https://github.com/rust-lang/rust/pull/69033/
2816 [68692]: https://github.com/rust-lang/rust/pull/68692/
2817 [68334]: https://github.com/rust-lang/rust/pull/68334/
2818 [67502]: https://github.com/rust-lang/rust/pull/67502/
2819 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2820 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2821 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2822 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2823 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2824 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2825 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2826 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2827 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2828 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2829 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2830 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2831 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2832
2833
2834 Version 1.43.1 (2020-05-07)
2835 ===========================
2836
2837 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2838 * [Fixed the stabilization of AVX-512 features.][71473]
2839 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2840
2841 [71430]: https://github.com/rust-lang/rust/pull/71430
2842 [71473]: https://github.com/rust-lang/rust/issues/71473
2843 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2844
2845
2846 Version 1.43.0 (2020-04-23)
2847 ==========================
2848
2849 Language
2850 --------
2851 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2852   the type inferred correctly.][68129]
2853 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2854
2855 **Syntax only changes**
2856 - [Allow `type Foo: Ord` syntactically.][69361]
2857 - [Fuse associated and extern items up to defaultness.][69194]
2858 - [Syntactically allow `self` in all `fn` contexts.][68764]
2859 - [Merge `fn` syntax + cleanup item parsing.][68728]
2860 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2861   For example, you may now write:
2862   ```rust
2863   macro_rules! mac_trait {
2864       ($i:item) => {
2865           trait T { $i }
2866       }
2867   }
2868   mac_trait! {
2869       fn foo() {}
2870   }
2871   ```
2872
2873 These are still rejected *semantically*, so you will likely receive an error but
2874 these changes can be seen and parsed by macros and
2875 conditional compilation.
2876
2877
2878 Compiler
2879 --------
2880 - [You can now pass multiple lint flags to rustc to override the previous
2881   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2882   everything in the `unused` lint group except `unused-variables` which
2883   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2884   everything in the `unused` lint group **including** `unused-variables` since
2885   the allow flag is specified before the deny flag (and therefore overridden).
2886 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2887   if they are available on `windows-gnu`.][67429]
2888 - [rustc now buffers errors/warnings printed in JSON.][69227]
2889
2890 Libraries
2891 ---------
2892 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2893   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2894   respectively.][69538] **Note** These conversions are only available when `N`
2895   is `0..=32`.
2896 - [You can now use associated constants on floats and integers directly, rather
2897   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2898   `f32::NAN` with no imports.
2899 - [`u8::is_ascii` is now `const`.][68984]
2900 - [`String` now implements `AsMut<str>`.][68742]
2901 - [Added the `primitive` module to `std` and `core`.][67637] This module
2902   reexports Rust's primitive types. This is mainly useful in macros
2903   where you want avoid these types being shadowed.
2904 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2905 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2906
2907 Stabilized APIs
2908 ---------------
2909 - [`Once::is_completed`]
2910 - [`f32::LOG10_2`]
2911 - [`f32::LOG2_10`]
2912 - [`f64::LOG10_2`]
2913 - [`f64::LOG2_10`]
2914 - [`iter::once_with`]
2915
2916 Cargo
2917 -----
2918 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2919   your environment.][cargo/7823]
2920 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2921   executable path when running integration tests or benchmarks.][cargo/7697]
2922   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2923   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2924
2925 Misc
2926 ----
2927 - [Certain checks in the `const_err` lint were deemed unrelated to const
2928   evaluation][69185], and have been moved to the `unconditional_panic` and
2929   `arithmetic_overflow` lints.
2930
2931 Compatibility Notes
2932 -------------------
2933
2934 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2935   has been a warning since 1.36.0.
2936 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2937   led to some instances being accepted, and now correctly emits a hard error.
2938
2939 [69340]: https://github.com/rust-lang/rust/pull/69340
2940
2941 Internal Only
2942 -------------
2943 These changes provide no direct user facing benefits, but represent significant
2944 improvements to the internals and overall performance of `rustc` and
2945 related tools.
2946
2947 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2948 - [Improved how rustc generates drop code.][67332]
2949 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2950 - [traits: preallocate 2 Vecs of known initial size][69022]
2951 - [Avoid exponential behaviour when relating types][68772]
2952 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2953 - [Improve performance of coherence checks][68966]
2954 - [Deduplicate types in the generator witness][68672]
2955 - [Invert control in struct_lint_level.][68725]
2956
2957 [67332]: https://github.com/rust-lang/rust/pull/67332/
2958 [67429]: https://github.com/rust-lang/rust/pull/67429/
2959 [67637]: https://github.com/rust-lang/rust/pull/67637/
2960 [67642]: https://github.com/rust-lang/rust/pull/67642/
2961 [67878]: https://github.com/rust-lang/rust/pull/67878/
2962 [67885]: https://github.com/rust-lang/rust/pull/67885/
2963 [68129]: https://github.com/rust-lang/rust/pull/68129/
2964 [68672]: https://github.com/rust-lang/rust/pull/68672/
2965 [68725]: https://github.com/rust-lang/rust/pull/68725/
2966 [68728]: https://github.com/rust-lang/rust/pull/68728/
2967 [68738]: https://github.com/rust-lang/rust/pull/68738/
2968 [68742]: https://github.com/rust-lang/rust/pull/68742/
2969 [68764]: https://github.com/rust-lang/rust/pull/68764/
2970 [68772]: https://github.com/rust-lang/rust/pull/68772/
2971 [68943]: https://github.com/rust-lang/rust/pull/68943/
2972 [68952]: https://github.com/rust-lang/rust/pull/68952/
2973 [68966]: https://github.com/rust-lang/rust/pull/68966/
2974 [68984]: https://github.com/rust-lang/rust/pull/68984/
2975 [69022]: https://github.com/rust-lang/rust/pull/69022/
2976 [69185]: https://github.com/rust-lang/rust/pull/69185/
2977 [69194]: https://github.com/rust-lang/rust/pull/69194/
2978 [69201]: https://github.com/rust-lang/rust/pull/69201/
2979 [69227]: https://github.com/rust-lang/rust/pull/69227/
2980 [69548]: https://github.com/rust-lang/rust/pull/69548/
2981 [69256]: https://github.com/rust-lang/rust/pull/69256/
2982 [69361]: https://github.com/rust-lang/rust/pull/69361/
2983 [69366]: https://github.com/rust-lang/rust/pull/69366/
2984 [69538]: https://github.com/rust-lang/rust/pull/69538/
2985 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2986 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2987 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2988 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2989 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2990 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2991 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2992 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2993
2994
2995 Version 1.42.0 (2020-03-12)
2996 ==========================
2997
2998 Language
2999 --------
3000 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
3001   ```rust
3002   fn foo(words: &[&str]) {
3003       match words {
3004           ["Hello", "World", "!", ..] => println!("Hello World!"),
3005           ["Foo", "Bar", ..] => println!("Baz"),
3006           rest => println!("{:?}", rest),
3007       }
3008   }
3009   ```
3010 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
3011   that you can create an enum that has the exact layout and ABI of the type
3012   it contains.
3013 - [You can now use outer attribute procedural macros on inline modules.][64273]
3014 - [There are some *syntax-only* changes:][67131]
3015    - `default` is syntactically allowed before items in `trait` definitions.
3016    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
3017      leave out their bodies in favor of `;`.
3018    - Bounds on associated types in `impl`s are now syntactically allowed
3019      (e.g. `type Foo: Ord;`).
3020    - `...` (the C-variadic type) may occur syntactically directly as the type of
3021       any function parameter.
3022
3023   These are still rejected *semantically*, so you will likely receive an error
3024   but these changes can be seen and parsed by procedural macros and
3025   conditional compilation.
3026
3027 Compiler
3028 --------
3029 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
3030 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
3031 - [`Option::{expect,unwrap}` and
3032    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
3033    pointing to the location where they were called, rather than
3034    `core`'s internals. ][67887]
3035
3036 \* Refer to Rust's [platform support page][platform-support-doc] for more
3037 information on Rust's tiered platform support.
3038
3039 Libraries
3040 ---------
3041 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
3042 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
3043    to implement `Sized`.][67935]
3044 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
3045 - [`Layout::new` is now `const`.][66254]
3046 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
3047
3048
3049 Stabilized APIs
3050 ---------------
3051 - [`CondVar::wait_while`]
3052 - [`CondVar::wait_timeout_while`]
3053 - [`DebugMap::key`]
3054 - [`DebugMap::value`]
3055 - [`ManuallyDrop::take`]
3056 - [`matches!`]
3057 - [`ptr::slice_from_raw_parts_mut`]
3058 - [`ptr::slice_from_raw_parts`]
3059
3060 Cargo
3061 -----
3062 - [You no longer need to include `extern crate proc_macro;` to be able to
3063   `use proc_macro;` in the `2018` edition.][cargo/7700]
3064
3065 Compatibility Notes
3066 -------------------
3067 - [`Error::description` has been deprecated, and its use will now produce a
3068   warning.][66919] It's recommended to use `Display`/`to_string` instead.
3069
3070 [68253]: https://github.com/rust-lang/rust/pull/68253/
3071 [68348]: https://github.com/rust-lang/rust/pull/68348/
3072 [67935]: https://github.com/rust-lang/rust/pull/67935/
3073 [68339]: https://github.com/rust-lang/rust/pull/68339/
3074 [68122]: https://github.com/rust-lang/rust/pull/68122/
3075 [64273]: https://github.com/rust-lang/rust/pull/64273/
3076 [67712]: https://github.com/rust-lang/rust/pull/67712/
3077 [67887]: https://github.com/rust-lang/rust/pull/67887/
3078 [67131]: https://github.com/rust-lang/rust/pull/67131/
3079 [67233]: https://github.com/rust-lang/rust/pull/67233/
3080 [66899]: https://github.com/rust-lang/rust/pull/66899/
3081 [66919]: https://github.com/rust-lang/rust/pull/66919/
3082 [66254]: https://github.com/rust-lang/rust/pull/66254/
3083 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
3084 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
3085 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
3086 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
3087 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
3088 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
3089 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
3090 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
3091 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
3092
3093
3094 Version 1.41.1 (2020-02-27)
3095 ===========================
3096
3097 * [Always check types of static items][69145]
3098 * [Always check lifetime bounds of `Copy` impls][69145]
3099 * [Fix miscompilation in callers of `Layout::repeat`][69225]
3100
3101 [69225]: https://github.com/rust-lang/rust/issues/69225
3102 [69145]: https://github.com/rust-lang/rust/pull/69145
3103
3104
3105 Version 1.41.0 (2020-01-30)
3106 ===========================
3107
3108 Language
3109 --------
3110
3111 - [You can now pass type parameters to foreign items when implementing
3112   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
3113 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
3114   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
3115   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
3116 - [You can now use any valid identifier in a `format_args` macro.][66847]
3117   Previously identifiers starting with an underscore were not allowed.
3118 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
3119   enum variants.][66183] These are still rejected semantically, but
3120   can be seen and parsed by procedural macros and conditional compilation.
3121 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
3122   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
3123   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
3124
3125 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
3126
3127 Compiler
3128 --------
3129
3130 - [Rustc will now warn if you have unused loop `'label`s.][66325]
3131 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
3132 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
3133 - [You can now pass an arguments file passing the `@path` syntax
3134   to rustc.][66172] Note that the format differs somewhat from what is
3135   found in other tooling; please see [the documentation][argfile-docs] for
3136   more information.
3137 - [You can now provide `--extern` flag without a path, indicating that it is
3138   available from the search path or specified with an `-L` flag.][64882]
3139
3140 \* Refer to Rust's [platform support page][platform-support-doc] for more
3141 information on Rust's tiered platform support.
3142
3143 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
3144
3145 Libraries
3146 ---------
3147
3148 - [The `core::panic` module is now stable.][66771] It was already stable
3149   through `std`.
3150 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
3151   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
3152 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
3153
3154 Stabilized APIs
3155 ---------------
3156
3157 - [`Result::map_or`]
3158 - [`Result::map_or_else`]
3159 - [`std::rc::Weak::weak_count`]
3160 - [`std::rc::Weak::strong_count`]
3161 - [`std::sync::Weak::weak_count`]
3162 - [`std::sync::Weak::strong_count`]
3163
3164 Cargo
3165 -----
3166
3167 - [Cargo will now document all the private items for binary crates
3168   by default.][cargo/7593]
3169 - [`cargo-install` will now reinstall the package if it detects that it is out
3170   of date.][cargo/7560]
3171 - [Cargo.lock now uses a more git friendly format that should help to reduce
3172   merge conflicts.][cargo/7579]
3173 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
3174   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
3175   optimisation level to `2` for debug builds. You can also use
3176   `[profile.<profile>.build-override]` to override build scripts and
3177   their dependencies.
3178
3179 Misc
3180 ----
3181
3182 - [You can now specify `edition` in documentation code blocks to compile the block
3183   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
3184   should be compiled the 2018 edition of Rust.
3185 - [You can now provide custom themes to rustdoc with `--theme`, and check the
3186   current theme with `--check-theme`.][54733]
3187 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
3188
3189 Compatibility Notes
3190 -------------------
3191
3192 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
3193   Apple targets.][apple-32bit-drop] This means that the source code is still
3194   available to build, but the targets are no longer being tested and release
3195   binaries for those platforms will no longer be distributed by the Rust project.
3196   Please refer to the linked blog post for more information.
3197
3198 [54733]: https://github.com/rust-lang/rust/pull/54733/
3199 [61351]: https://github.com/rust-lang/rust/pull/61351/
3200 [62514]: https://github.com/rust-lang/rust/pull/62514/
3201 [67255]: https://github.com/rust-lang/rust/pull/67255/
3202 [66661]: https://github.com/rust-lang/rust/pull/66661/
3203 [66771]: https://github.com/rust-lang/rust/pull/66771/
3204 [66847]: https://github.com/rust-lang/rust/pull/66847/
3205 [66238]: https://github.com/rust-lang/rust/pull/66238/
3206 [66277]: https://github.com/rust-lang/rust/pull/66277/
3207 [66325]: https://github.com/rust-lang/rust/pull/66325/
3208 [66172]: https://github.com/rust-lang/rust/pull/66172/
3209 [66183]: https://github.com/rust-lang/rust/pull/66183/
3210 [65879]: https://github.com/rust-lang/rust/pull/65879/
3211 [65013]: https://github.com/rust-lang/rust/pull/65013/
3212 [64882]: https://github.com/rust-lang/rust/pull/64882/
3213 [64325]: https://github.com/rust-lang/rust/pull/64325/
3214 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
3215 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
3216 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
3217 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
3218 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
3219 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
3220 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
3221 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
3222 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
3223 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
3224 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
3225
3226 Version 1.40.0 (2019-12-19)
3227 ===========================
3228
3229 Language
3230 --------
3231 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
3232   `const` contexts.][65188] e.g.
3233
3234   ```rust
3235   pub struct Point(i32, i32);
3236
3237   const ORIGIN: Point = {
3238       let constructor = Point;
3239
3240       constructor(0, 0)
3241   };
3242   ```
3243
3244 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
3245   indicate that there may be variants or fields added in the future.][64639]
3246   For example this requires adding a wild-card branch (`_ => {}`) to any match
3247   statements on a non-exhaustive `enum`. [(RFC 2008)]
3248 - [You can now use function-like procedural macros in `extern` blocks and in
3249   type positions.][63931] e.g. `type Generated = macro!();`
3250 - [Function-like and attribute procedural macros can now emit
3251   `macro_rules!` items, so you can now have your macros generate macros.][64035]
3252 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
3253   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
3254   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
3255
3256 Compiler
3257 --------
3258 - [Added tier 3 support\* for the
3259   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
3260 - [Added tier 3 support for the
3261   `aarch64-unknown-none-softfloat` target.][64589]
3262 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
3263   `mips64el-unknown-linux-muslabi64` targets.][65843]
3264
3265 \* Refer to Rust's [platform support page][platform-support-doc] for more
3266   information on Rust's tiered platform support.
3267
3268 Libraries
3269 ---------
3270 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
3271
3272 Stabilized APIs
3273 ---------------
3274 - [`BTreeMap::get_key_value`]
3275 - [`HashMap::get_key_value`]
3276 - [`Option::as_deref_mut`]
3277 - [`Option::as_deref`]
3278 - [`Option::flatten`]
3279 - [`UdpSocket::peer_addr`]
3280 - [`f32::to_be_bytes`]
3281 - [`f32::to_le_bytes`]
3282 - [`f32::to_ne_bytes`]
3283 - [`f64::to_be_bytes`]
3284 - [`f64::to_le_bytes`]
3285 - [`f64::to_ne_bytes`]
3286 - [`f32::from_be_bytes`]
3287 - [`f32::from_le_bytes`]
3288 - [`f32::from_ne_bytes`]
3289 - [`f64::from_be_bytes`]
3290 - [`f64::from_le_bytes`]
3291 - [`f64::from_ne_bytes`]
3292 - [`mem::take`]
3293 - [`slice::repeat`]
3294 - [`todo!`]
3295
3296 Cargo
3297 -----
3298 - [Cargo will now always display warnings, rather than only on
3299   fresh builds.][cargo/7450]
3300 - [Feature flags (except `--all-features`) passed to a virtual workspace will
3301   now produce an error.][cargo/7507] Previously these flags were ignored.
3302 - [You can now publish `dev-dependencies` without including
3303   a `version`.][cargo/7333]
3304
3305 Misc
3306 ----
3307 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
3308   when running documentation tests with `rustdoc`.][63803]
3309
3310 Compatibility Notes
3311 -------------------
3312 - [As previously announced, any previous NLL warnings in the 2015 edition are
3313   now hard errors.][64221]
3314 - [The `include!` macro will now warn if it failed to include the
3315   entire file.][64284] The `include!` macro unintentionally only includes the
3316   first _expression_ in a file, and this can be unintuitive. This will become
3317   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
3318 - [Using `#[inline]` on function prototypes and consts now emits a warning under
3319   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
3320   or `extern` blocks now correctly emits a hard error.
3321
3322 [65294]: https://github.com/rust-lang/rust/pull/65294/
3323 [66103]: https://github.com/rust-lang/rust/pull/66103/
3324 [65843]: https://github.com/rust-lang/rust/pull/65843/
3325 [65188]: https://github.com/rust-lang/rust/pull/65188/
3326 [65092]: https://github.com/rust-lang/rust/pull/65092/
3327 [64589]: https://github.com/rust-lang/rust/pull/64589/
3328 [64639]: https://github.com/rust-lang/rust/pull/64639/
3329 [64221]: https://github.com/rust-lang/rust/pull/64221/
3330 [64284]: https://github.com/rust-lang/rust/pull/64284/
3331 [63931]: https://github.com/rust-lang/rust/pull/63931/
3332 [64035]: https://github.com/rust-lang/rust/pull/64035/
3333 [63674]: https://github.com/rust-lang/rust/pull/63674/
3334 [63803]: https://github.com/rust-lang/rust/pull/63803/
3335 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
3336 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
3337 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
3338 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
3339 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
3340 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
3341 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
3342 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
3343 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
3344 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
3345 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
3346 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
3347 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
3348 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
3349 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
3350 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
3351 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
3352 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
3353 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
3354 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
3355 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
3356 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
3357 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
3358 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
3359 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
3360
3361
3362 Version 1.39.0 (2019-11-07)
3363 ===========================
3364
3365 Language
3366 --------
3367 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
3368   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
3369 - [You can now use certain attributes on function, closure, and function pointer
3370   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
3371   `deny`, `forbid` as well as inert helper attributes used by procedural macro
3372   attributes applied to items. e.g.
3373   ```rust
3374   fn len(
3375       #[cfg(windows)] slice: &[u16],
3376       #[cfg(not(windows))] slice: &[u8],
3377   ) -> usize {
3378       slice.len()
3379   }
3380   ```
3381 - [You can now take shared references to bind-by-move patterns in the `if` guards
3382   of `match` arms.][63118] e.g.
3383   ```rust
3384   fn main() {
3385       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
3386
3387       match array {
3388           nums
3389   //      ---- `nums` is bound by move.
3390               if nums.iter().sum::<u8>() == 10
3391   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
3392           => {
3393               drop(nums);
3394   //          ----------- Legal as `nums` was bound by move and so we have ownership.
3395           }
3396           _ => unreachable!(),
3397       }
3398   }
3399   ```
3400
3401
3402
3403 Compiler
3404 --------
3405 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
3406 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
3407 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
3408   **Note** Cargo currently doesn't use this feature. Refer to
3409   [cargo#7315][cargo/7315] to track this feature's progress.
3410 - [You can now pass `--show-output` argument to test binaries to print the
3411   output of successful tests.][62600]
3412
3413
3414 \* Refer to Rust's [platform support page][platform-support-doc] for more
3415 information on Rust's tiered platform support.
3416
3417 Libraries
3418 ---------
3419 - [`Vec::new` and `String::new` are now `const` functions.][64028]
3420 - [`LinkedList::new` is now a `const` function.][63684]
3421 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
3422 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
3423   now `const`.][63786]
3424
3425 Stabilized APIs
3426 ---------------
3427 - [`Pin::into_inner`]
3428 - [`Instant::checked_duration_since`]
3429 - [`Instant::saturating_duration_since`]
3430
3431 Cargo
3432 -----
3433 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
3434 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
3435   `--all` is now deprecated.
3436
3437 Misc
3438 ----
3439 - [You can now pass `-Clinker` to rustdoc to control the linker used
3440   for compiling doctests.][63834]
3441
3442 Compatibility Notes
3443 -------------------
3444 - [Code that was previously accepted by the old borrow checker, but rejected by
3445   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
3446   previously a warning, and will also become a hard error in the Rust 2015
3447   edition in the 1.40.0 release.
3448 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
3449   run tests.][63827] This should improve performance when running a large
3450   amount of doctests.
3451 - [The `try!` macro will now issue a deprecation warning.][62672] It is
3452   recommended to use the `?` operator instead.
3453 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
3454   returned `0.0`.
3455
3456 [62600]: https://github.com/rust-lang/rust/pull/62600/
3457 [62672]: https://github.com/rust-lang/rust/pull/62672/
3458 [63118]: https://github.com/rust-lang/rust/pull/63118/
3459 [63209]: https://github.com/rust-lang/rust/pull/63209/
3460 [63402]: https://github.com/rust-lang/rust/pull/63402/
3461 [63565]: https://github.com/rust-lang/rust/pull/63565/
3462 [63595]: https://github.com/rust-lang/rust/pull/63595/
3463 [63684]: https://github.com/rust-lang/rust/pull/63684/
3464 [63698]: https://github.com/rust-lang/rust/pull/63698/
3465 [63770]: https://github.com/rust-lang/rust/pull/63770/
3466 [63786]: https://github.com/rust-lang/rust/pull/63786/
3467 [63827]: https://github.com/rust-lang/rust/pull/63827/
3468 [63834]: https://github.com/rust-lang/rust/pull/63834/
3469 [64010]: https://github.com/rust-lang/rust/pull/64010/
3470 [64028]: https://github.com/rust-lang/rust/pull/64028/
3471 [64334]: https://github.com/rust-lang/rust/pull/64334/
3472 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
3473 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
3474 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
3475 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
3476 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
3477 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
3478
3479 Version 1.38.0 (2019-09-26)
3480 ==========================
3481
3482 Language
3483 --------
3484 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
3485 - [The `#[deprecated]` attribute can now be used on macros.][62042]
3486
3487 Compiler
3488 --------
3489 - [Added pipelined compilation support to `rustc`.][62766] This will
3490   improve compilation times in some cases. For further information please refer
3491   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
3492 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
3493   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
3494   `x86_64-uwp-windows-msvc` targets.][60260]
3495 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
3496   `armv7-unknown-linux-musleabi` targets.][63107]
3497 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
3498 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
3499 - [Upgraded to LLVM 9.][62592]
3500
3501 \* Refer to Rust's [platform support page][platform-support-doc] for more
3502 information on Rust's tiered platform support.
3503
3504 Libraries
3505 ---------
3506 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
3507 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
3508   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
3509   is available at `std::clone::Clone`). This also makes all built-in macros
3510   available in `std`/`core` root. e.g. `std::include_bytes!`.
3511 - [`str::Chars` now implements `Debug`.][63000]
3512 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
3513 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
3514 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
3515 - [Added euclidean remainder and division operations (`div_euclid`,
3516   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
3517   `overflowing`, and `wrapping` versions are available for all
3518   integer primitives.
3519 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
3520   `PartialEq`.][61491]
3521 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
3522
3523 Stabilized APIs
3524 ---------------
3525 - [`<*const T>::cast`]
3526 - [`<*mut T>::cast`]
3527 - [`Duration::as_secs_f32`]
3528 - [`Duration::as_secs_f64`]
3529 - [`Duration::div_f32`]
3530 - [`Duration::div_f64`]
3531 - [`Duration::from_secs_f32`]
3532 - [`Duration::from_secs_f64`]
3533 - [`Duration::mul_f32`]
3534 - [`Duration::mul_f64`]
3535 - [`any::type_name`]
3536
3537 Cargo
3538 -----
3539 - [Added pipelined compilation support to `cargo`.][cargo/7143]
3540 - [You can now pass the `--features` option multiple times to enable
3541   multiple features.][cargo/7084]
3542
3543 Rustdoc
3544 -------
3545
3546 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
3547
3548 Misc
3549 ----
3550 - [`rustc` will now warn about some incorrect uses of
3551   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
3552
3553 Compatibility Notes
3554 -------------------
3555 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
3556   1.38.0.
3557 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
3558   issues][62896] with certain crates such as libc.
3559
3560 [60260]: https://github.com/rust-lang/rust/pull/60260/
3561 [61457]: https://github.com/rust-lang/rust/pull/61457/
3562 [61491]: https://github.com/rust-lang/rust/pull/61491/
3563 [61884]: https://github.com/rust-lang/rust/pull/61884/
3564 [61953]: https://github.com/rust-lang/rust/pull/61953/
3565 [62042]: https://github.com/rust-lang/rust/pull/62042/
3566 [62528]: https://github.com/rust-lang/rust/pull/62528/
3567 [62583]: https://github.com/rust-lang/rust/pull/62583/
3568 [62735]: https://github.com/rust-lang/rust/pull/62735/
3569 [62766]: https://github.com/rust-lang/rust/pull/62766/
3570 [62784]: https://github.com/rust-lang/rust/pull/62784/
3571 [62592]: https://github.com/rust-lang/rust/pull/62592/
3572 [62785]: https://github.com/rust-lang/rust/issues/62785/
3573 [62814]: https://github.com/rust-lang/rust/pull/62814/
3574 [62896]: https://github.com/rust-lang/rust/issues/62896/
3575 [63000]: https://github.com/rust-lang/rust/pull/63000/
3576 [63056]: https://github.com/rust-lang/rust/pull/63056/
3577 [63107]: https://github.com/rust-lang/rust/pull/63107/
3578 [63346]: https://github.com/rust-lang/rust/pull/63346/
3579 [63421]: https://github.com/rust-lang/rust/pull/63421/
3580 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
3581 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
3582 [63048]: https://github.com/rust-lang/rust/pull/63048
3583 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3584 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3585 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
3586 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
3587 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3588 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3589 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3590 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3591 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3592 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3593 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3594 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3595 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3596
3597 Version 1.37.0 (2019-08-15)
3598 ==========================
3599
3600 Language
3601 --------
3602 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3603   [`Box`][62228], or an [array][62235] and unused.
3604 - [You can now use the `cfg` and `cfg_attr` attributes on
3605   generic parameters.][61547]
3606 - [You can now use enum variants through type alias.][61682] e.g. You can
3607   write the following:
3608   ```rust
3609   type MyOption = Option<u8>;
3610
3611   fn increment_or_zero(x: MyOption) -> u8 {
3612       match x {
3613           MyOption::Some(y) => y + 1,
3614           MyOption::None => 0,
3615       }
3616   }
3617   ```
3618 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3619   `const _: u32 = 5;`.
3620 - [You can now use `#[repr(align(X)]` on enums.][61229]
3621 - [The  `?` Kleene macro operator is now available in the
3622   2015 edition.][60932]
3623
3624 Compiler
3625 --------
3626 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3627   and `-C profile-use` flags.][61268] For more information on how to use profile
3628   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3629 - [The `rust-lldb` wrapper script should now work again.][61827]
3630
3631 Libraries
3632 ---------
3633 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3634
3635 Stabilized APIs
3636 ---------------
3637 - [`BufReader::buffer`]
3638 - [`BufWriter::buffer`]
3639 - [`Cell::from_mut`]
3640 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3641 - [`DoubleEndedIterator::nth_back`]
3642 - [`Option::xor`]
3643 - [`Wrapping::reverse_bits`]
3644 - [`i128::reverse_bits`]
3645 - [`i16::reverse_bits`]
3646 - [`i32::reverse_bits`]
3647 - [`i64::reverse_bits`]
3648 - [`i8::reverse_bits`]
3649 - [`isize::reverse_bits`]
3650 - [`slice::copy_within`]
3651 - [`u128::reverse_bits`]
3652 - [`u16::reverse_bits`]
3653 - [`u32::reverse_bits`]
3654 - [`u64::reverse_bits`]
3655 - [`u8::reverse_bits`]
3656 - [`usize::reverse_bits`]
3657
3658 Cargo
3659 -----
3660 - [`Cargo.lock` files are now included by default when publishing executable crates
3661   with executables.][cargo/7026]
3662 - [You can now specify `default-run="foo"` in `[package]` to specify the
3663   default executable to use for `cargo run`.][cargo/7056]
3664
3665 Misc
3666 ----
3667
3668 Compatibility Notes
3669 -------------------
3670 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3671   Please transition your code to using the `..=` syntax for inclusive
3672   ranges instead.
3673 - [Using a trait object without the `dyn` will now warn by default.][61203]
3674   Please transition your code to use `dyn Trait` for trait objects instead.
3675
3676 [62228]: https://github.com/rust-lang/rust/pull/62228/
3677 [62235]: https://github.com/rust-lang/rust/pull/62235/
3678 [61802]: https://github.com/rust-lang/rust/pull/61802/
3679 [61827]: https://github.com/rust-lang/rust/pull/61827/
3680 [61547]: https://github.com/rust-lang/rust/pull/61547/
3681 [61682]: https://github.com/rust-lang/rust/pull/61682/
3682 [61268]: https://github.com/rust-lang/rust/pull/61268/
3683 [61342]: https://github.com/rust-lang/rust/pull/61342/
3684 [61347]: https://github.com/rust-lang/rust/pull/61347/
3685 [61100]: https://github.com/rust-lang/rust/pull/61100/
3686 [61203]: https://github.com/rust-lang/rust/pull/61203/
3687 [61229]: https://github.com/rust-lang/rust/pull/61229/
3688 [60932]: https://github.com/rust-lang/rust/pull/60932/
3689 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3690 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3691 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3692 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3693 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3694 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3695 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3696 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3697 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3698 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3699 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3700 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3701 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3702 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3703 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3704 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3705 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3706 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3707 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3708 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3709 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3710 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3711 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3712
3713
3714 Version 1.36.0 (2019-07-04)
3715 ==========================
3716
3717 Language
3718 --------
3719 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3720 - [The order of traits in trait objects no longer affects the semantics of that
3721   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3722   `dyn fmt::Debug + Send`, where this was previously not the case.
3723
3724 Libraries
3725 ---------
3726 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3727 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3728 - [`mem::needs_drop` is now available as a const fn.][60364]
3729 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3730 - [`String` now implements `BorrowMut<str>`.][60404]
3731 - [`io::Cursor` now implements `Default`.][60234]
3732 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3733 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3734   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3735   environment has access to heap memory allocation.
3736 - [`String` now implements `From<&String>`.][59825]
3737 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3738   return a tuple of each argument when there is multiple arguments.
3739 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3740   not used.][59648]
3741
3742 Stabilized APIs
3743 ---------------
3744 - [`VecDeque::rotate_left`]
3745 - [`VecDeque::rotate_right`]
3746 - [`Iterator::copied`]
3747 - [`io::IoSlice`]
3748 - [`io::IoSliceMut`]
3749 - [`Read::read_vectored`]
3750 - [`Write::write_vectored`]
3751 - [`str::as_mut_ptr`]
3752 - [`mem::MaybeUninit`]
3753 - [`pointer::align_offset`]
3754 - [`future::Future`]
3755 - [`task::Context`]
3756 - [`task::RawWaker`]
3757 - [`task::RawWakerVTable`]
3758 - [`task::Waker`]
3759 - [`task::Poll`]
3760
3761 Cargo
3762 -----
3763 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3764 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3765
3766 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3767
3768 Clippy
3769 ------
3770 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3771
3772 Misc
3773 ----
3774
3775 Compatibility Notes
3776 -------------------
3777 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3778   longer recommended, and will be deprecated in 1.39.0.
3779
3780 [60318]: https://github.com/rust-lang/rust/pull/60318/
3781 [60364]: https://github.com/rust-lang/rust/pull/60364/
3782 [60370]: https://github.com/rust-lang/rust/pull/60370/
3783 [60404]: https://github.com/rust-lang/rust/pull/60404/
3784 [60234]: https://github.com/rust-lang/rust/pull/60234/
3785 [60244]: https://github.com/rust-lang/rust/pull/60244/
3786 [58623]: https://github.com/rust-lang/rust/pull/58623/
3787 [59648]: https://github.com/rust-lang/rust/pull/59648/
3788 [59675]: https://github.com/rust-lang/rust/pull/59675/
3789 [59825]: https://github.com/rust-lang/rust/pull/59825/
3790 [59826]: https://github.com/rust-lang/rust/pull/59826/
3791 [59445]: https://github.com/rust-lang/rust/pull/59445/
3792 [59114]: https://github.com/rust-lang/rust/pull/59114/
3793 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3794 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3795 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3796 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3797 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3798 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3799 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3800 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3801 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3802 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3803 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3804 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3805 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3806 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3807 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3808 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3809 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3810 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3811 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3812 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3813
3814
3815 Version 1.35.0 (2019-05-23)
3816 ==========================
3817
3818 Language
3819 --------
3820 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3821   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3822 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3823   ```rust
3824   unsafe fn call_unsafe(func: unsafe fn()) {
3825       func()
3826   }
3827
3828   pub fn main() {
3829       unsafe { call_unsafe(|| {}); }
3830   }
3831   ```
3832
3833
3834 Compiler
3835 --------
3836 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3837   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3838 - [Added the `wasm32-unknown-wasi` target.][59464]
3839
3840
3841 Libraries
3842 ---------
3843 - [`Thread` will now show its ID in `Debug` output.][59460]
3844 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3845 - [`alloc::System` now implements `Default`.][59451]
3846 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3847   last field.][59076]
3848 - [`char::{ToLowercase, ToUppercase}` now
3849   implement `ExactSizeIterator`.][58778]
3850 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3851 - [Removed the `Read` trait bounds
3852   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3853 - [You can now call the `dbg!` macro without any parameters to print the file
3854   and line where it is called.][57847]
3855 - [In place ASCII case conversions are now up to 4× faster.][59283]
3856   e.g. `str::make_ascii_lowercase`
3857 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3858   and `Send`.][58369]
3859
3860 Stabilized APIs
3861 ---------------
3862 - [`f32::copysign`]
3863 - [`f64::copysign`]
3864 - [`RefCell::replace_with`]
3865 - [`RefCell::map_split`]
3866 - [`ptr::hash`]
3867 - [`Range::contains`]
3868 - [`RangeFrom::contains`]
3869 - [`RangeTo::contains`]
3870 - [`RangeInclusive::contains`]
3871 - [`RangeToInclusive::contains`]
3872 - [`Option::copied`]
3873
3874 Cargo
3875 -----
3876 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3877   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3878   platform specific.
3879
3880 Misc
3881 ----
3882 - [The Rust toolchain is now available natively for musl based distros.][58575]
3883
3884 [59460]: https://github.com/rust-lang/rust/pull/59460/
3885 [59464]: https://github.com/rust-lang/rust/pull/59464/
3886 [59500]: https://github.com/rust-lang/rust/pull/59500/
3887 [59512]: https://github.com/rust-lang/rust/pull/59512/
3888 [59580]: https://github.com/rust-lang/rust/pull/59580/
3889 [59283]: https://github.com/rust-lang/rust/pull/59283/
3890 [59451]: https://github.com/rust-lang/rust/pull/59451/
3891 [59076]: https://github.com/rust-lang/rust/pull/59076/
3892 [58778]: https://github.com/rust-lang/rust/pull/58778/
3893 [58717]: https://github.com/rust-lang/rust/pull/58717/
3894 [58369]: https://github.com/rust-lang/rust/pull/58369/
3895 [58423]: https://github.com/rust-lang/rust/pull/58423/
3896 [58080]: https://github.com/rust-lang/rust/pull/58080/
3897 [57847]: https://github.com/rust-lang/rust/pull/57847/
3898 [58575]: https://github.com/rust-lang/rust/pull/58575
3899 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3900 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3901 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3902 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3903 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3904 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3905 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3906 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3907 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3908 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3909 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3910 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3911
3912 Version 1.34.2 (2019-05-14)
3913 ===========================
3914
3915 * [Destabilize the `Error::type_id` function due to a security
3916    vulnerability][60785] ([CVE-2019-12083])
3917
3918 [60785]: https://github.com/rust-lang/rust/pull/60785
3919 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3920
3921 Version 1.34.1 (2019-04-25)
3922 ===========================
3923
3924 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3925 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3926 * [Fix Clippy panic when checking some macros][clippy/3805]
3927
3928 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3929 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3930 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3931
3932 Version 1.34.0 (2019-04-11)
3933 ==========================
3934
3935 Language
3936 --------
3937 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3938   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3939   but had no effect.
3940 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3941   `#[attr{}]` procedural macros.][57367]
3942 - [You can now write `extern crate self as foo;`][57407] to import your
3943   crate's root into the extern prelude.
3944
3945
3946 Compiler
3947 --------
3948 - [You can now target `riscv64imac-unknown-none-elf` and
3949   `riscv64gc-unknown-none-elf`.][58406]
3950 - [You can now enable linker plugin LTO optimisations with
3951   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3952   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3953   boundaries.
3954 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3955
3956
3957 Libraries
3958 ---------
3959 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3960   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3961   the `Hash` trait to create an iterator.
3962 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3963   methods.][58421] Most notably you no longer require the `Ord` trait to create
3964   an iterator.
3965 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3966   for all numeric types.][58044]
3967 - [Indexing a `str` is now generic over all types that
3968   implement `SliceIndex<str>`.][57604]
3969 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3970   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3971   produce a warning if their returning type is unused.
3972 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3973   `overflowing_pow` are now available for all numeric types.][57873] These are
3974   equivalent to methods such as `wrapping_add` for the `pow` operation.
3975
3976
3977 Stabilized APIs
3978 ---------------
3979
3980 #### std & core
3981 * [`Any::type_id`]
3982 * [`Error::type_id`]
3983 * [`atomic::AtomicI16`]
3984 * [`atomic::AtomicI32`]
3985 * [`atomic::AtomicI64`]
3986 * [`atomic::AtomicI8`]
3987 * [`atomic::AtomicU16`]
3988 * [`atomic::AtomicU32`]
3989 * [`atomic::AtomicU64`]
3990 * [`atomic::AtomicU8`]
3991 * [`convert::Infallible`]
3992 * [`convert::TryFrom`]
3993 * [`convert::TryInto`]
3994 * [`iter::from_fn`]
3995 * [`iter::successors`]
3996 * [`num::NonZeroI128`]
3997 * [`num::NonZeroI16`]
3998 * [`num::NonZeroI32`]
3999 * [`num::NonZeroI64`]
4000 * [`num::NonZeroI8`]
4001 * [`num::NonZeroIsize`]
4002 * [`slice::sort_by_cached_key`]
4003 * [`str::escape_debug`]
4004 * [`str::escape_default`]
4005 * [`str::escape_unicode`]
4006 * [`str::split_ascii_whitespace`]
4007
4008 #### std
4009 * [`Instant::checked_add`]
4010 * [`Instant::checked_sub`]
4011 * [`SystemTime::checked_add`]
4012 * [`SystemTime::checked_sub`]
4013
4014 Cargo
4015 -----
4016 - [You can now use alternative registries to crates.io.][cargo/6654]
4017
4018 Misc
4019 ----
4020 - [You can now use the `?` operator in your documentation tests without manually
4021   adding `fn main() -> Result<(), _> {}`.][56470]
4022
4023 Compatibility Notes
4024 -------------------
4025 - [`Command::before_exec` is being replaced by the unsafe method
4026   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
4027 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
4028   can now use `const` functions in `static` variables.
4029
4030 [58370]: https://github.com/rust-lang/rust/pull/58370/
4031 [58406]: https://github.com/rust-lang/rust/pull/58406/
4032 [58421]: https://github.com/rust-lang/rust/pull/58421/
4033 [58166]: https://github.com/rust-lang/rust/pull/58166/
4034 [58044]: https://github.com/rust-lang/rust/pull/58044/
4035 [58057]: https://github.com/rust-lang/rust/pull/58057/
4036 [58059]: https://github.com/rust-lang/rust/pull/58059/
4037 [57809]: https://github.com/rust-lang/rust/pull/57809/
4038 [57873]: https://github.com/rust-lang/rust/pull/57873/
4039 [57604]: https://github.com/rust-lang/rust/pull/57604/
4040 [57367]: https://github.com/rust-lang/rust/pull/57367/
4041 [57407]: https://github.com/rust-lang/rust/pull/57407/
4042 [57425]: https://github.com/rust-lang/rust/pull/57425/
4043 [57106]: https://github.com/rust-lang/rust/pull/57106/
4044 [56470]: https://github.com/rust-lang/rust/pull/56470/
4045 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
4046 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
4047 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
4048 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
4049 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
4050 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
4051 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
4052 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
4053 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
4054 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
4055 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
4056 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
4057 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
4058 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
4059 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
4060 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
4061 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
4062 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
4063 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
4064 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
4065 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
4066 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
4067 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
4068 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
4069 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
4070 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
4071 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
4072 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
4073 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
4074 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
4075 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
4076
4077
4078 Version 1.33.0 (2019-02-28)
4079 ==========================
4080
4081 Language
4082 --------
4083 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
4084   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
4085 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
4086   E.g. You can have match statement on a `u8` that covers `0..=255` and
4087   you would no longer be required to have a `_ => unreachable!()` case.
4088 - [You can now have multiple patterns in `if let` and `while let`
4089   expressions.][57532] You can do this with the same syntax as a `match`
4090   expression. E.g.
4091   ```rust
4092   enum Creature {
4093       Crab(String),
4094       Lobster(String),
4095       Person(String),
4096   }
4097
4098   fn main() {
4099       let state = Creature::Crab("Ferris");
4100
4101       if let Creature::Crab(name) | Creature::Person(name) = state {
4102           println!("This creature's name is: {}", name);
4103       }
4104   }
4105   ```
4106 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
4107   this feature will by default produce a warning as this behaviour can be
4108   unintuitive. E.g. `if let _ = 5 {}`
4109 - [You can now use `let` bindings, assignments, expression statements,
4110   and irrefutable pattern destructuring in const functions.][57175]
4111 - [You can now call unsafe const functions.][57067] E.g.
4112   ```rust
4113   const unsafe fn foo() -> i32 { 5 }
4114   const fn bar() -> i32 {
4115       unsafe { foo() }
4116   }
4117   ```
4118 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
4119   E.g. `#[cfg_attr(all(), must_use, optimize)]`
4120 - [You can now specify a specific alignment with the `#[repr(packed)]`
4121   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
4122   with an alignment of 2 bytes and a size of 6 bytes.
4123 - [You can now import an item from a module as an `_`.][56303] This allows you to
4124   import a trait's impls, and not have the name in the namespace. E.g.
4125   ```rust
4126   use std::io::Read as _;
4127
4128   // Allowed as there is only one `Read` in the module.
4129   pub trait Read {}
4130   ```
4131 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
4132
4133 Compiler
4134 --------
4135 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
4136   command line argument.][56351]
4137 - [The minimum required LLVM version has been bumped to 6.0.][56642]
4138 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
4139 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
4140   tier 2 support.][57130] Visit the [platform support][platform-support] page for
4141   information on Rust's platform support.
4142 - [Added support for the `thumbv7neon-linux-androideabi` and
4143   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
4144 - [Added support for the `x86_64-unknown-uefi` target.][56769]
4145
4146 Libraries
4147 ---------
4148 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
4149   functions for all numeric types.][57566]
4150 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
4151   are now `const` functions for all numeric types.][57105]
4152 - [The methods `is_positive` and `is_negative` are now `const` functions for
4153   all signed numeric types.][57105]
4154 - [The `get` method for all `NonZero` types is now `const`.][57167]
4155 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
4156   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
4157   numeric types.][57234]
4158 - [`Ipv4Addr::new` is now a `const` function][57234]
4159
4160 Stabilized APIs
4161 ---------------
4162 - [`unix::FileExt::read_exact_at`]
4163 - [`unix::FileExt::write_all_at`]
4164 - [`Option::transpose`]
4165 - [`Result::transpose`]
4166 - [`convert::identity`]
4167 - [`pin::Pin`]
4168 - [`marker::Unpin`]
4169 - [`marker::PhantomPinned`]
4170 - [`Vec::resize_with`]
4171 - [`VecDeque::resize_with`]
4172 - [`Duration::as_millis`]
4173 - [`Duration::as_micros`]
4174 - [`Duration::as_nanos`]
4175
4176
4177 Cargo
4178 -----
4179 - [You can now publish crates that require a feature flag to compile with
4180   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
4181 - [Cargo should now rebuild a crate if a file was modified during the initial
4182   build.][cargo/6484]
4183
4184 Compatibility Notes
4185 -------------------
4186 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
4187   are now deprecated in the standard library, and their usage will now produce a warning.
4188   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
4189   methods instead.
4190 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
4191   downcasting.
4192 - [Libtest no longer creates a new thread for each test when
4193   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
4194
4195 [56243]: https://github.com/rust-lang/rust/pull/56243
4196 [56303]: https://github.com/rust-lang/rust/pull/56303/
4197 [56351]: https://github.com/rust-lang/rust/pull/56351/
4198 [56362]: https://github.com/rust-lang/rust/pull/56362
4199 [56642]: https://github.com/rust-lang/rust/pull/56642/
4200 [56769]: https://github.com/rust-lang/rust/pull/56769/
4201 [56805]: https://github.com/rust-lang/rust/pull/56805
4202 [56947]: https://github.com/rust-lang/rust/pull/56947/
4203 [57049]: https://github.com/rust-lang/rust/pull/57049/
4204 [57067]: https://github.com/rust-lang/rust/pull/57067/
4205 [57105]: https://github.com/rust-lang/rust/pull/57105
4206 [57130]: https://github.com/rust-lang/rust/pull/57130/
4207 [57167]: https://github.com/rust-lang/rust/pull/57167/
4208 [57175]: https://github.com/rust-lang/rust/pull/57175/
4209 [57234]: https://github.com/rust-lang/rust/pull/57234/
4210 [57332]: https://github.com/rust-lang/rust/pull/57332/
4211 [57465]: https://github.com/rust-lang/rust/pull/57465/
4212 [57532]: https://github.com/rust-lang/rust/pull/57532/
4213 [57535]: https://github.com/rust-lang/rust/pull/57535/
4214 [57566]: https://github.com/rust-lang/rust/pull/57566/
4215 [57615]: https://github.com/rust-lang/rust/pull/57615/
4216 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
4217 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
4218 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
4219 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
4220 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
4221 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
4222 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
4223 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
4224 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
4225 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
4226 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
4227 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
4228 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
4229 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
4230 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
4231 [platform-support]: https://forge.rust-lang.org/platform-support.html
4232
4233 Version 1.32.0 (2019-01-17)
4234 ==========================
4235
4236 Language
4237 --------
4238 #### 2018 edition
4239 - [You can now use the `?` operator in macro definitions.][56245] The `?`
4240   operator allows you to specify zero or one repetitions similar to the `*` and
4241   `+` operators.
4242 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
4243   now always resolve to the item (`enum`, `struct`, etc.) available in the
4244   module if present, before resolving to a external crate or an item the prelude.][56759]
4245   E.g.
4246   ```rust
4247   enum Color { Red, Green, Blue }
4248
4249   use Color::*;
4250   ```
4251
4252 #### All editions
4253 - [You can now match against `PhantomData<T>` types.][55837]
4254 - [You can now match against literals in macros with the `literal`
4255   specifier.][56072] This will match against a literal of any type.
4256   E.g. `1`, `'A'`, `"Hello World"`
4257 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
4258   ```rust
4259   struct Point(i32, i32);
4260
4261   impl Point {
4262       pub fn new(x: i32, y: i32) -> Self {
4263           Self(x, y)
4264       }
4265
4266       pub fn is_origin(&self) -> bool {
4267           match self {
4268               Self(0, 0) => true,
4269               _ => false,
4270           }
4271       }
4272   }
4273   ```
4274 - [Self can also now be used in type definitions.][56366] E.g.
4275   ```rust
4276   enum List<T>
4277   where
4278       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
4279   {
4280       Nil,
4281       Cons(T, Box<Self>) // likewise here
4282   }
4283   ```
4284 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
4285   a `impl Trait` or `dyn Trait` is returned and unused in the program.
4286
4287 Compiler
4288 --------
4289 - [The default allocator has changed from jemalloc to the default allocator on
4290   your system.][55238] The compiler itself on Linux & macOS will still use
4291   jemalloc, but programs compiled with it will use the system allocator.
4292 - [Added the `aarch64-pc-windows-msvc` target.][55702]
4293
4294 Libraries
4295 ---------
4296 - [`PathBuf` now implements `FromStr`.][55148]
4297 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
4298 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
4299   easily debug expressions in your rust program. E.g.
4300   ```rust
4301   let a = 2;
4302   let b = dbg!(a * 2) + 1;
4303   //      ^-- prints: [src/main.rs:4] a * 2 = 4
4304   assert_eq!(b, 5);
4305   ```
4306
4307 The following APIs are now `const` functions and can be used in a
4308 `const` context.
4309
4310 - [`Cell::as_ptr`]
4311 - [`UnsafeCell::get`]
4312 - [`char::is_ascii`]
4313 - [`iter::empty`]
4314 - [`ManuallyDrop::new`]
4315 - [`ManuallyDrop::into_inner`]
4316 - [`RangeInclusive::start`]
4317 - [`RangeInclusive::end`]
4318 - [`NonNull::as_ptr`]
4319 - [`slice::as_ptr`]
4320 - [`str::as_ptr`]
4321 - [`Duration::as_secs`]
4322 - [`Duration::subsec_millis`]
4323 - [`Duration::subsec_micros`]
4324 - [`Duration::subsec_nanos`]
4325 - [`CStr::as_ptr`]
4326 - [`Ipv4Addr::is_unspecified`]
4327 - [`Ipv6Addr::new`]
4328 - [`Ipv6Addr::octets`]
4329
4330 Stabilized APIs
4331 ---------------
4332 - [`i8::to_be_bytes`]
4333 - [`i8::to_le_bytes`]
4334 - [`i8::to_ne_bytes`]
4335 - [`i8::from_be_bytes`]
4336 - [`i8::from_le_bytes`]
4337 - [`i8::from_ne_bytes`]
4338 - [`i16::to_be_bytes`]
4339 - [`i16::to_le_bytes`]
4340 - [`i16::to_ne_bytes`]
4341 - [`i16::from_be_bytes`]
4342 - [`i16::from_le_bytes`]
4343 - [`i16::from_ne_bytes`]
4344 - [`i32::to_be_bytes`]
4345 - [`i32::to_le_bytes`]
4346 - [`i32::to_ne_bytes`]
4347 - [`i32::from_be_bytes`]
4348 - [`i32::from_le_bytes`]
4349 - [`i32::from_ne_bytes`]
4350 - [`i64::to_be_bytes`]
4351 - [`i64::to_le_bytes`]
4352 - [`i64::to_ne_bytes`]
4353 - [`i64::from_be_bytes`]
4354 - [`i64::from_le_bytes`]
4355 - [`i64::from_ne_bytes`]
4356 - [`i128::to_be_bytes`]
4357 - [`i128::to_le_bytes`]
4358 - [`i128::to_ne_bytes`]
4359 - [`i128::from_be_bytes`]
4360 - [`i128::from_le_bytes`]
4361 - [`i128::from_ne_bytes`]
4362 - [`isize::to_be_bytes`]
4363 - [`isize::to_le_bytes`]
4364 - [`isize::to_ne_bytes`]
4365 - [`isize::from_be_bytes`]
4366 - [`isize::from_le_bytes`]
4367 - [`isize::from_ne_bytes`]
4368 - [`u8::to_be_bytes`]
4369 - [`u8::to_le_bytes`]
4370 - [`u8::to_ne_bytes`]
4371 - [`u8::from_be_bytes`]
4372 - [`u8::from_le_bytes`]
4373 - [`u8::from_ne_bytes`]
4374 - [`u16::to_be_bytes`]
4375 - [`u16::to_le_bytes`]
4376 - [`u16::to_ne_bytes`]
4377 - [`u16::from_be_bytes`]
4378 - [`u16::from_le_bytes`]
4379 - [`u16::from_ne_bytes`]
4380 - [`u32::to_be_bytes`]
4381 - [`u32::to_le_bytes`]
4382 - [`u32::to_ne_bytes`]
4383 - [`u32::from_be_bytes`]
4384 - [`u32::from_le_bytes`]
4385 - [`u32::from_ne_bytes`]
4386 - [`u64::to_be_bytes`]
4387 - [`u64::to_le_bytes`]
4388 - [`u64::to_ne_bytes`]
4389 - [`u64::from_be_bytes`]
4390 - [`u64::from_le_bytes`]
4391 - [`u64::from_ne_bytes`]
4392 - [`u128::to_be_bytes`]
4393 - [`u128::to_le_bytes`]
4394 - [`u128::to_ne_bytes`]
4395 - [`u128::from_be_bytes`]
4396 - [`u128::from_le_bytes`]
4397 - [`u128::from_ne_bytes`]
4398 - [`usize::to_be_bytes`]
4399 - [`usize::to_le_bytes`]
4400 - [`usize::to_ne_bytes`]
4401 - [`usize::from_be_bytes`]
4402 - [`usize::from_le_bytes`]
4403 - [`usize::from_ne_bytes`]
4404
4405 Cargo
4406 -----
4407 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
4408 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
4409
4410 Misc
4411 ----
4412 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
4413
4414 Compatibility Notes
4415 -------------------
4416 - [The argument types for AVX's
4417   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
4418   been changed from `*const` to `*mut` as the previous implementation
4419   was unsound.
4420
4421
4422 [55148]: https://github.com/rust-lang/rust/pull/55148/
4423 [55238]: https://github.com/rust-lang/rust/pull/55238/
4424 [55280]: https://github.com/rust-lang/rust/pull/55280/
4425 [55610]: https://github.com/rust-lang/rust/pull/55610/
4426 [55663]: https://github.com/rust-lang/rust/pull/55663/
4427 [55702]: https://github.com/rust-lang/rust/pull/55702/
4428 [55837]: https://github.com/rust-lang/rust/pull/55837/
4429 [55843]: https://github.com/rust-lang/rust/pull/55843/
4430 [56072]: https://github.com/rust-lang/rust/pull/56072/
4431 [56245]: https://github.com/rust-lang/rust/pull/56245/
4432 [56365]: https://github.com/rust-lang/rust/pull/56365/
4433 [56366]: https://github.com/rust-lang/rust/pull/56366/
4434 [56395]: https://github.com/rust-lang/rust/pull/56395/
4435 [56759]: https://github.com/rust-lang/rust/pull/56759/
4436 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
4437 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
4438 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
4439 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
4440 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
4441 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4442 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4443 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
4444 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
4445 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
4446 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
4447 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
4448 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
4449 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
4450 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
4451 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
4452 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
4453 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
4454 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
4455 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
4456 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
4457 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
4458 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
4459 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
4460 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
4461 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
4462 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
4463 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
4464 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
4465 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
4466 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
4467 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
4468 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
4469 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
4470 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
4471 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
4472 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
4473 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
4474 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
4475 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
4476 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
4477 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
4478 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
4479 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
4480 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
4481 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
4482 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
4483 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
4484 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
4485 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
4486 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
4487 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
4488 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
4489 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
4490 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
4491 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
4492 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
4493 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
4494 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
4495 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
4496 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
4497 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
4498 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
4499 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
4500 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
4501 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
4502 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
4503 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
4504 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
4505 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
4506 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
4507 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
4508 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
4509 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
4510 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
4511 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
4512 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
4513 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
4514 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
4515 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
4516 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
4517 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
4518 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
4519 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
4520 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
4521 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
4522 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
4523 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
4524 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
4525 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
4526 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
4527 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
4528 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
4529
4530
4531 Version 1.31.1 (2018-12-20)
4532 ===========================
4533
4534 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
4535 - [Fix broken go-to-definition in RLS][rls/1171]
4536 - [Fix infinite loop on hover in RLS][rls/1170]
4537
4538 [56562]: https://github.com/rust-lang/rust/pull/56562
4539 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
4540 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
4541
4542 Version 1.31.0 (2018-12-06)
4543 ==========================
4544
4545 Language
4546 --------
4547 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
4548 - [New lifetime elision rules now allow for eliding lifetimes in functions and
4549   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
4550   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
4551   in structs.
4552 - [You can now define and use `const` functions.][54835] These are currently
4553   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
4554   [language reference][const-reference] for what exactly is available.
4555 - [You can now use tool lints, which allow you to scope lints from external
4556   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
4557 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
4558   a crate, not just in exported functions.][54451]
4559 - [You can now use parentheses in pattern matches.][54497]
4560
4561 Compiler
4562 --------
4563 - [Updated musl to 1.1.20][54430]
4564
4565 Libraries
4566 ---------
4567 - [You can now convert `num::NonZero*` types to their raw equivalents using the
4568   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
4569 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
4570   into `Option<&mut T>` using the `From` trait.][53218]
4571 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
4572
4573
4574 Stabilized APIs
4575 ---------------
4576 - [`slice::align_to`]
4577 - [`slice::align_to_mut`]
4578 - [`slice::chunks_exact`]
4579 - [`slice::chunks_exact_mut`]
4580 - [`slice::rchunks`]
4581 - [`slice::rchunks_mut`]
4582 - [`slice::rchunks_exact`]
4583 - [`slice::rchunks_exact_mut`]
4584 - [`Option::replace`]
4585
4586 Cargo
4587 -----
4588 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4589 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4590   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4591
4592 [52813]: https://github.com/rust-lang/rust/pull/52813/
4593 [53218]: https://github.com/rust-lang/rust/pull/53218/
4594 [54057]: https://github.com/rust-lang/rust/pull/54057/
4595 [54240]: https://github.com/rust-lang/rust/pull/54240/
4596 [54430]: https://github.com/rust-lang/rust/pull/54430/
4597 [54451]: https://github.com/rust-lang/rust/pull/54451/
4598 [54497]: https://github.com/rust-lang/rust/pull/54497/
4599 [54778]: https://github.com/rust-lang/rust/pull/54778/
4600 [54835]: https://github.com/rust-lang/rust/pull/54835/
4601 [54870]: https://github.com/rust-lang/rust/pull/54870/
4602 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4603 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4604 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4605 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4606 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4607 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4608 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4609 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4610 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4611 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4612 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4613 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4614 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4615 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4616
4617 Version 1.30.1 (2018-11-08)
4618 ===========================
4619
4620 - [Fixed overflow ICE in rustdoc][54199]
4621 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4622
4623 [54199]: https://github.com/rust-lang/rust/pull/54199
4624 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4625
4626 Version 1.30.0 (2018-10-25)
4627 ==========================
4628
4629 Language
4630 --------
4631 - [Procedural macros are now available.][52081] These kinds of macros allow for
4632   more powerful code generation. There is a [new chapter available][proc-macros]
4633   in the Rust Programming Language book that goes further in depth.
4634 - [You can now use keywords as identifiers using the raw identifiers
4635   syntax (`r#`),][53236] e.g. `let r#for = true;`
4636 - [Using anonymous parameters in traits is now deprecated with a warning and
4637   will be a hard error in the 2018 edition.][53272]
4638 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4639   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4640 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4641   Previously, using a external crate in a module without a use statement
4642   required `let json = ::serde_json::from_str(foo);` but can now be written
4643   as `let json = serde_json::from_str(foo);`.
4644 - [You can now apply the `#[used]` attribute to static items to prevent the
4645   compiler from optimising them away, even if they appear to be unused,][51363]
4646   e.g. `#[used] static FOO: u32 = 1;`
4647 - [You can now import and reexport macros from other crates with the `use`
4648   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4649   the root module of the crate. If your macro relies on calling other local
4650   macros, it is recommended to export with the
4651   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4652   those macros.
4653 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4654   using the `vis` specifier.][53370]
4655 - [Non-macro attributes now allow all forms of literals, not just
4656   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4657   write `#[attr(true)]`.
4658 - [You can now specify a function to handle a panic in the Rust runtime with the
4659   `#[panic_handler]` attribute.][51366]
4660
4661 Compiler
4662 --------
4663 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4664 - [Added the `aarch64-unknown-netbsd` target][53165]
4665 - [Upgraded to LLVM 8.][53611]
4666
4667 Libraries
4668 ---------
4669 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4670
4671 Stabilized APIs
4672 ---------------
4673 - [`Ipv4Addr::BROADCAST`]
4674 - [`Ipv4Addr::LOCALHOST`]
4675 - [`Ipv4Addr::UNSPECIFIED`]
4676 - [`Ipv6Addr::LOCALHOST`]
4677 - [`Ipv6Addr::UNSPECIFIED`]
4678 - [`Iterator::find_map`]
4679
4680   The following methods are replacement methods for `trim_left`, `trim_right`,
4681   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4682   in 1.33.0:
4683 - [`str::trim_end_matches`]
4684 - [`str::trim_end`]
4685 - [`str::trim_start_matches`]
4686 - [`str::trim_start`]
4687
4688 Cargo
4689 ----
4690 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4691 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4692   equivalent to calling `rustdoc --error-format=json`.
4693 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4694
4695 Misc
4696 ----
4697 - [`rustdoc` allows you to specify what edition to treat your code as with the
4698   `--edition` option.][54057]
4699 - [`rustdoc` now has the `--color` (specify whether to output color) and
4700   `--error-format` (specify error format, e.g. `json`) options.][53003]
4701 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4702   debug symbols.][53774]
4703 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4704   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4705
4706 [50911]: https://github.com/rust-lang/rust/pull/50911/
4707 [51363]: https://github.com/rust-lang/rust/pull/51363/
4708 [51366]: https://github.com/rust-lang/rust/pull/51366/
4709 [52081]: https://github.com/rust-lang/rust/pull/52081/
4710 [53003]: https://github.com/rust-lang/rust/pull/53003/
4711 [53033]: https://github.com/rust-lang/rust/pull/53033/
4712 [53044]: https://github.com/rust-lang/rust/pull/53044/
4713 [53165]: https://github.com/rust-lang/rust/pull/53165/
4714 [53611]: https://github.com/rust-lang/rust/pull/53611/
4715 [53236]: https://github.com/rust-lang/rust/pull/53236/
4716 [53272]: https://github.com/rust-lang/rust/pull/53272/
4717 [53370]: https://github.com/rust-lang/rust/pull/53370/
4718 [53459]: https://github.com/rust-lang/rust/pull/53459/
4719 [53774]: https://github.com/rust-lang/rust/pull/53774/
4720 [53822]: https://github.com/rust-lang/rust/pull/53822/
4721 [54057]: https://github.com/rust-lang/rust/pull/54057/
4722 [54404]: https://github.com/rust-lang/rust/pull/54404/
4723 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4724 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4725 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4726 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4727
4728 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4729 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4730 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4731 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4732 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4733 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4734 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4735 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4736 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4737 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4738
4739
4740 Version 1.29.2 (2018-10-11)
4741 ===========================
4742
4743 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4744 - The `rls-preview` component on the windows-gnu targets has been restored.
4745
4746 [54639]: https://github.com/rust-lang/rust/pull/54639
4747
4748
4749 Version 1.29.1 (2018-09-25)
4750 ===========================
4751
4752 Security Notes
4753 --------------
4754
4755 - The standard library's `str::repeat` function contained an out of bounds write
4756   caused by an integer overflow. This has been fixed by deterministically
4757   panicking when an overflow happens.
4758
4759   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4760   us.
4761
4762
4763 Version 1.29.0 (2018-09-13)
4764 ==========================
4765
4766 Compiler
4767 --------
4768 - [Bumped minimum LLVM version to 5.0.][51899]
4769 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4770 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4771 - [Upgraded to LLVM 7.][51966]
4772
4773 Libraries
4774 ---------
4775 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4776 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4777 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4778 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4779   for `&str`.][51178]
4780 - [`Cell<T>` now allows `T` to be unsized.][50494]
4781 - [`SocketAddr` is now stable on Redox.][52656]
4782
4783 Stabilized APIs
4784 ---------------
4785 - [`Arc::downcast`]
4786 - [`Iterator::flatten`]
4787 - [`Rc::downcast`]
4788
4789 Cargo
4790 -----
4791 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4792   `--locked` to disable this behavior.
4793 - [`cargo-install` will now allow you to cross compile an install
4794   using `--target`.][cargo/5614]
4795 - [Added the `cargo-fix` subcommand to automatically move project code from
4796   2015 edition to 2018.][cargo/5723]
4797 - [`cargo doc` can now optionally document private types using the
4798   `--document-private-items` flag.][cargo/5543]
4799
4800 Misc
4801 ----
4802 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4803   the specified level to that level.][52354] For example `--cap-lints warn`
4804   will demote `deny` and `forbid` lints to `warn`.
4805 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4806   fails and `101` if there is a panic.][52197]
4807 - [A preview of clippy has been made available through rustup.][51122]
4808   You can install the preview with `rustup component add clippy-preview`.
4809
4810 Compatibility Notes
4811 -------------------
4812 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4813   Use `str::get_unchecked(begin..end)` instead.
4814 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4815   Consider using the `home_dir` function from
4816   https://crates.io/crates/dirs instead.
4817 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4818 - [`cfg` attributes and `--cfg` command line flags are now more
4819   strictly validated.][53893]
4820
4821 [53893]: https://github.com/rust-lang/rust/pull/53893/
4822 [52861]: https://github.com/rust-lang/rust/pull/52861/
4823 [51966]: https://github.com/rust-lang/rust/pull/51966/
4824 [52656]: https://github.com/rust-lang/rust/pull/52656/
4825 [52239]: https://github.com/rust-lang/rust/pull/52239/
4826 [52330]: https://github.com/rust-lang/rust/pull/52330/
4827 [52354]: https://github.com/rust-lang/rust/pull/52354/
4828 [52402]: https://github.com/rust-lang/rust/pull/52402/
4829 [52197]: https://github.com/rust-lang/rust/pull/52197/
4830 [51807]: https://github.com/rust-lang/rust/pull/51807/
4831 [51899]: https://github.com/rust-lang/rust/pull/51899/
4832 [51912]: https://github.com/rust-lang/rust/pull/51912/
4833 [51619]: https://github.com/rust-lang/rust/pull/51619/
4834 [51656]: https://github.com/rust-lang/rust/pull/51656/
4835 [51178]: https://github.com/rust-lang/rust/pull/51178/
4836 [51122]: https://github.com/rust-lang/rust/pull/51122
4837 [50494]: https://github.com/rust-lang/rust/pull/50494/
4838 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4839 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4840 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4841 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4842 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4843 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4844 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4845
4846
4847 Version 1.28.0 (2018-08-02)
4848 ===========================
4849
4850 Language
4851 --------
4852 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4853   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4854   the inner type across Foreign Function Interface (FFI) boundaries.
4855 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4856   and can now be used as identifiers.][51196]
4857 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4858   stable.][51241] This will allow users to specify a global allocator for
4859   their program.
4860 - [Unit test functions marked with the `#[test]` attribute can now return
4861   `Result<(), E: Debug>` in addition to `()`.][51298]
4862 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4863   allows macros to easily target lifetimes.
4864
4865 Compiler
4866 --------
4867 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4868   prioritise making smaller binary sizes. `z` is the same as `s` with the
4869   exception that it does not vectorise loops, which typically results in an even
4870   smaller binary.
4871 - [The short error format is now stable.][49546] Specified with
4872   `--error-format=short` this option will provide a more compressed output of
4873   rust error messages.
4874 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4875 - [Reduced the number of allocations in the macro parser.][50855] This can
4876   improve compile times of macro heavy crates on average by 5%.
4877
4878 Libraries
4879 ---------
4880 - [Implemented `Default` for `&mut str`.][51306]
4881 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4882 - [Implemented `Extend` for `()`.][50234]
4883 - [The `Debug` implementation of `time::Duration` should now be more easily
4884   human readable.][50364] Previously a `Duration` of one second would printed as
4885   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4886 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4887   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4888   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4889   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4890   for `PathBuf`.][50170]
4891 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4892   and `Wrapping<i128>`.][50465]
4893 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4894   possible.][51050] This can provide up to a 40% speed increase.
4895 - [Improved error messages when using `format!`.][50610]
4896
4897 Stabilized APIs
4898 ---------------
4899 - [`Iterator::step_by`]
4900 - [`Path::ancestors`]
4901 - [`SystemTime::UNIX_EPOCH`]
4902 - [`alloc::GlobalAlloc`]
4903 - [`alloc::Layout`]
4904 - [`alloc::LayoutErr`]
4905 - [`alloc::System`]
4906 - [`alloc::alloc`]
4907 - [`alloc::alloc_zeroed`]
4908 - [`alloc::dealloc`]
4909 - [`alloc::realloc`]
4910 - [`alloc::handle_alloc_error`]
4911 - [`btree_map::Entry::or_default`]
4912 - [`fmt::Alignment`]
4913 - [`hash_map::Entry::or_default`]
4914 - [`iter::repeat_with`]
4915 - [`num::NonZeroUsize`]
4916 - [`num::NonZeroU128`]
4917 - [`num::NonZeroU16`]
4918 - [`num::NonZeroU32`]
4919 - [`num::NonZeroU64`]
4920 - [`num::NonZeroU8`]
4921 - [`ops::RangeBounds`]
4922 - [`slice::SliceIndex`]
4923 - [`slice::from_mut`]
4924 - [`slice::from_ref`]
4925 - [`{Any + Send + Sync}::downcast_mut`]
4926 - [`{Any + Send + Sync}::downcast_ref`]
4927 - [`{Any + Send + Sync}::is`]
4928
4929 Cargo
4930 -----
4931 - [Cargo will now no longer allow you to publish crates with build scripts that
4932   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4933   considered to be immutable.
4934
4935 Misc
4936 ----
4937 - [The `suggestion_applicability` field in `rustc`'s json output is now
4938   stable.][50486] This will allow dev tools to check whether a code suggestion
4939   would apply to them.
4940
4941 Compatibility Notes
4942 -------------------
4943 - [Rust will consider trait objects with duplicated constraints to be the same
4944   type as without the duplicated constraint.][51276] For example the below code will
4945   now fail to compile.
4946   ```rust
4947   trait Trait {}
4948
4949   impl Trait + Send {
4950       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4951   }
4952
4953   impl Trait + Send + Send {
4954       fn test(&self) { println!("two"); }
4955   }
4956   ```
4957
4958 [49546]: https://github.com/rust-lang/rust/pull/49546/
4959 [50143]: https://github.com/rust-lang/rust/pull/50143/
4960 [50170]: https://github.com/rust-lang/rust/pull/50170/
4961 [50234]: https://github.com/rust-lang/rust/pull/50234/
4962 [50265]: https://github.com/rust-lang/rust/pull/50265/
4963 [50364]: https://github.com/rust-lang/rust/pull/50364/
4964 [50385]: https://github.com/rust-lang/rust/pull/50385/
4965 [50465]: https://github.com/rust-lang/rust/pull/50465/
4966 [50486]: https://github.com/rust-lang/rust/pull/50486/
4967 [50554]: https://github.com/rust-lang/rust/pull/50554/
4968 [50610]: https://github.com/rust-lang/rust/pull/50610/
4969 [50855]: https://github.com/rust-lang/rust/pull/50855/
4970 [51050]: https://github.com/rust-lang/rust/pull/51050/
4971 [51196]: https://github.com/rust-lang/rust/pull/51196/
4972 [51241]: https://github.com/rust-lang/rust/pull/51241/
4973 [51276]: https://github.com/rust-lang/rust/pull/51276/
4974 [51298]: https://github.com/rust-lang/rust/pull/51298/
4975 [51306]: https://github.com/rust-lang/rust/pull/51306/
4976 [51562]: https://github.com/rust-lang/rust/pull/51562/
4977 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4978 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4979 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4980 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4981 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4982 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4983 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4984 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4985 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4986 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4987 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4988 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4989 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4990 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4991 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4992 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4993 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4994 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4995 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4996 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4997 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4998 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4999 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
5000 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
5001 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
5002 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
5003 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
5004 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
5005 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
5006 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
5007
5008 Version 1.27.2 (2018-07-20)
5009 ===========================
5010
5011 Compatibility Notes
5012 -------------------
5013
5014 - The borrow checker was fixed to avoid potential unsoundness when using
5015   match ergonomics: [#52213][52213].
5016
5017 [52213]: https://github.com/rust-lang/rust/issues/52213
5018
5019 Version 1.27.1 (2018-07-10)
5020 ===========================
5021
5022 Security Notes
5023 --------------
5024
5025 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
5026   when running, which enabled executing code as some other user on a
5027   given machine. This release fixes that vulnerability; you can read
5028   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
5029
5030   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
5031
5032 Compatibility Notes
5033 -------------------
5034
5035 - The borrow checker was fixed to avoid an additional potential unsoundness when using
5036   match ergonomics: [#51415][51415], [#49534][49534].
5037
5038 [51415]: https://github.com/rust-lang/rust/issues/51415
5039 [49534]: https://github.com/rust-lang/rust/issues/49534
5040 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
5041 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
5042
5043 Version 1.27.0 (2018-06-21)
5044 ==========================
5045
5046 Language
5047 --------
5048 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
5049   be used as an identifier.
5050 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
5051   bare `Trait` syntax, and should make it clearer when being used in tandem with
5052   `impl Trait` because it is equivalent to the following syntax:
5053   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
5054   `Box<Trait> == Box<dyn Trait>`.
5055 - [Attributes on generic parameters such as types and lifetimes are
5056   now stable.][48851] e.g.
5057   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
5058 - [The `#[must_use]` attribute can now also be used on functions as well as
5059   types.][48925] It provides a lint that by default warns users when the
5060   value returned by a function has not been used.
5061
5062 Compiler
5063 --------
5064 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
5065
5066 Libraries
5067 ---------
5068 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
5069   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
5070   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
5071   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
5072   the `cfg` attribute.
5073 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
5074   std are now available in core.][49896]
5075 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
5076   to `Self`.][49630]
5077 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
5078   that the operation isn't done in place.
5079 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
5080   the `#[must_use]` attribute][49533] to warn about unused potentially
5081   expensive allocations.
5082
5083 Stabilized APIs
5084 ---------------
5085 - [`DoubleEndedIterator::rfind`]
5086 - [`DoubleEndedIterator::rfold`]
5087 - [`DoubleEndedIterator::try_rfold`]
5088 - [`Duration::from_micros`]
5089 - [`Duration::from_nanos`]
5090 - [`Duration::subsec_micros`]
5091 - [`Duration::subsec_millis`]
5092 - [`HashMap::remove_entry`]
5093 - [`Iterator::try_fold`]
5094 - [`Iterator::try_for_each`]
5095 - [`NonNull::cast`]
5096 - [`Option::filter`]
5097 - [`String::replace_range`]
5098 - [`Take::set_limit`]
5099 - [`hint::unreachable_unchecked`]
5100 - [`os::unix::process::parent_id`]
5101 - [`ptr::swap_nonoverlapping`]
5102 - [`slice::rsplit_mut`]
5103 - [`slice::rsplit`]
5104 - [`slice::swap_with_slice`]
5105
5106 Cargo
5107 -----
5108 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
5109   `readme`, and `repository` fields.][cargo/5386]
5110 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
5111 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
5112   a different directory than `target` for placing compilation artifacts.
5113 - [Cargo will be adding automatic target inference for binaries, benchmarks,
5114   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
5115   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
5116   where cargo would infer a binary, Cargo will produce a warning. You can
5117   disable this feature ahead of time by setting any of the following to false:
5118   `autobins`, `autobenches`, `autoexamples`, `autotests`.
5119 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
5120   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
5121
5122 Misc
5123 ----
5124 - [Added “The Rustc book” into the official documentation.][49707]
5125   [“The Rustc book”] documents and teaches how to use the rustc compiler.
5126 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
5127
5128 Compatibility Notes
5129 -------------------
5130 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
5131   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
5132   compile, `"".is_empty()` will still compile.
5133 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
5134   will only print the inner type.][48553] E.g.
5135   `print!("{:?}", AtomicBool::new(true))` will print `true`,
5136   not `AtomicBool(true)`.
5137 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
5138   could enter higher numbers but they were not supported by LLVM. Up to 512MB
5139   alignment should cover all use cases.
5140 - The `.description()` method on the `std::error::Error` trait
5141   [has been soft-deprecated][50163]. It is no longer required to implement it.
5142
5143 [48553]: https://github.com/rust-lang/rust/pull/48553/
5144 [48851]: https://github.com/rust-lang/rust/pull/48851/
5145 [48925]: https://github.com/rust-lang/rust/pull/48925/
5146 [49533]: https://github.com/rust-lang/rust/pull/49533/
5147 [49623]: https://github.com/rust-lang/rust/pull/49623/
5148 [49630]: https://github.com/rust-lang/rust/pull/49630/
5149 [49664]: https://github.com/rust-lang/rust/pull/49664/
5150 [49699]: https://github.com/rust-lang/rust/pull/49699/
5151 [49707]: https://github.com/rust-lang/rust/pull/49707/
5152 [49896]: https://github.com/rust-lang/rust/pull/49896/
5153 [49968]: https://github.com/rust-lang/rust/pull/49968/
5154 [50163]: https://github.com/rust-lang/rust/pull/50163
5155 [50177]: https://github.com/rust-lang/rust/pull/50177/
5156 [50378]: https://github.com/rust-lang/rust/pull/50378/
5157 [50423]: https://github.com/rust-lang/rust/pull/50423/
5158 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
5159 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
5160 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
5161 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
5162 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
5163 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
5164 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
5165 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
5166 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
5167 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
5168 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
5169 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
5170 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
5171 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
5172 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
5173 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
5174 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
5175 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
5176 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
5177 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
5178 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
5179 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5180 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
5181 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
5182 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
5183 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
5184 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
5185 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
5186 [“The Rustc book”]: https://doc.rust-lang.org/rustc
5187
5188
5189 Version 1.26.2 (2018-06-05)
5190 ==========================
5191
5192 Compatibility Notes
5193 -------------------
5194
5195 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
5196
5197 [51117]: https://github.com/rust-lang/rust/issues/51117
5198
5199
5200 Version 1.26.1 (2018-05-29)
5201 ==========================
5202
5203 Tools
5204 -----
5205
5206 - [RLS now works on Windows.][50646]
5207 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
5208
5209
5210 Compatibility Notes
5211 --------
5212
5213 - [`fn main() -> impl Trait` no longer works for non-Termination
5214   trait.][50656]
5215   This reverts an accidental stabilization.
5216 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
5217 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
5218
5219 [50646]: https://github.com/rust-lang/rust/issues/50646
5220 [50656]: https://github.com/rust-lang/rust/pull/50656
5221 [50812]: https://github.com/rust-lang/rust/pull/50812
5222 [50950]: https://github.com/rust-lang/rust/issues/50950
5223 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
5224
5225 Version 1.26.0 (2018-05-10)
5226 ==========================
5227
5228 Language
5229 --------
5230 - [Closures now implement `Copy` and/or `Clone` if all captured variables
5231   implement either or both traits.][49299]
5232 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
5233 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
5234   lifetime can be elided.][49458]
5235 - [`impl Trait` is now stable allowing you to have abstract types in returns
5236    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
5237   `fn open(path: impl AsRef<Path>)`.
5238 - [Pattern matching will now automatically apply dereferences.][49394]
5239 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
5240 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
5241 - [A lot of operations are now available in a const context.][46882] E.g. You
5242   can now index into constant arrays, reference and dereference into constants,
5243   and use tuple struct constructors.
5244 - [Fixed entry slice patterns are now stable.][48516] E.g.
5245   ```rust
5246   let points = [1, 2, 3, 4];
5247   match points {
5248       [1, 2, 3, 4] => println!("All points were sequential."),
5249       _ => println!("Not all points were sequential."),
5250   }
5251   ```
5252
5253
5254 Compiler
5255 --------
5256 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
5257 - [Fixed exponential projection complexity on nested types.][48296]
5258   This can provide up to a ~12% reduction in compile times for certain crates.
5259 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
5260   to remap path prefixes outputted by the compiler.
5261 - [Added `powerpc-unknown-netbsd` target.][48281]
5262
5263 Libraries
5264 ---------
5265 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
5266 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
5267   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
5268 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
5269 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
5270 - [`ascii::escape_default` is now available in libcore.][48735]
5271 - [Trailing commas are now supported in std and core macros.][48056]
5272 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
5273 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
5274
5275 Stabilized APIs
5276 ---------------
5277 - [`*const T::add`]
5278 - [`*const T::copy_to_nonoverlapping`]
5279 - [`*const T::copy_to`]
5280 - [`*const T::read_unaligned`]
5281 - [`*const T::read_volatile`]
5282 - [`*const T::read`]
5283 - [`*const T::sub`]
5284 - [`*const T::wrapping_add`]
5285 - [`*const T::wrapping_sub`]
5286 - [`*mut T::add`]
5287 - [`*mut T::copy_to_nonoverlapping`]
5288 - [`*mut T::copy_to`]
5289 - [`*mut T::read_unaligned`]
5290 - [`*mut T::read_volatile`]
5291 - [`*mut T::read`]
5292 - [`*mut T::replace`]
5293 - [`*mut T::sub`]
5294 - [`*mut T::swap`]
5295 - [`*mut T::wrapping_add`]
5296 - [`*mut T::wrapping_sub`]
5297 - [`*mut T::write_bytes`]
5298 - [`*mut T::write_unaligned`]
5299 - [`*mut T::write_volatile`]
5300 - [`*mut T::write`]
5301 - [`Box::leak`]
5302 - [`FromUtf8Error::as_bytes`]
5303 - [`LocalKey::try_with`]
5304 - [`Option::cloned`]
5305 - [`btree_map::Entry::and_modify`]
5306 - [`fs::read_to_string`]
5307 - [`fs::read`]
5308 - [`fs::write`]
5309 - [`hash_map::Entry::and_modify`]
5310 - [`iter::FusedIterator`]
5311 - [`ops::RangeInclusive`]
5312 - [`ops::RangeToInclusive`]
5313 - [`process::id`]
5314 - [`slice::rotate_left`]
5315 - [`slice::rotate_right`]
5316 - [`String::retain`]
5317
5318
5319 Cargo
5320 -----
5321 - [Cargo will now output path to custom commands when `-v` is
5322   passed with `--list`][cargo/5041]
5323 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
5324
5325 Misc
5326 ----
5327 - [The second edition of "The Rust Programming Language" book is now recommended
5328   over the first.][48404]
5329
5330 Compatibility Notes
5331 -------------------
5332
5333 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
5334   syntax is now invalid.
5335   ```
5336   use std::ops::Fn as dyn;
5337   fn g(_: Box<dyn(std::fmt::Debug)>) {}
5338   ```
5339 - [The result of dereferences are no longer promoted to `'static`.][47408]
5340   e.g.
5341   ```rust
5342   fn main() {
5343       const PAIR: &(i32, i32) = &(0, 1);
5344       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
5345   }
5346   ```
5347 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
5348 - [`".e0"` will now no longer parse as `0.0` and will instead cause
5349   an error.][48235]
5350 - [Removed hoedown from rustdoc.][48274]
5351 - [Bounds on higher-kinded lifetimes a hard error.][48326]
5352
5353 [46882]: https://github.com/rust-lang/rust/pull/46882
5354 [47379]: https://github.com/rust-lang/rust/pull/47379
5355 [47408]: https://github.com/rust-lang/rust/pull/47408
5356 [47813]: https://github.com/rust-lang/rust/pull/47813
5357 [48056]: https://github.com/rust-lang/rust/pull/48056
5358 [48125]: https://github.com/rust-lang/rust/pull/48125
5359 [48235]: https://github.com/rust-lang/rust/pull/48235
5360 [48274]: https://github.com/rust-lang/rust/pull/48274
5361 [48281]: https://github.com/rust-lang/rust/pull/48281
5362 [48296]: https://github.com/rust-lang/rust/pull/48296
5363 [48326]: https://github.com/rust-lang/rust/pull/48326
5364 [48359]: https://github.com/rust-lang/rust/pull/48359
5365 [48404]: https://github.com/rust-lang/rust/pull/48404
5366 [48481]: https://github.com/rust-lang/rust/pull/48481
5367 [48516]: https://github.com/rust-lang/rust/pull/48516
5368 [48628]: https://github.com/rust-lang/rust/pull/48628
5369 [48629]: https://github.com/rust-lang/rust/pull/48629
5370 [48657]: https://github.com/rust-lang/rust/pull/48657
5371 [48735]: https://github.com/rust-lang/rust/pull/48735
5372 [48978]: https://github.com/rust-lang/rust/pull/48978
5373 [49101]: https://github.com/rust-lang/rust/pull/49101
5374 [49109]: https://github.com/rust-lang/rust/pull/49109
5375 [49162]: https://github.com/rust-lang/rust/pull/49162
5376 [49255]: https://github.com/rust-lang/rust/pull/49255
5377 [49299]: https://github.com/rust-lang/rust/pull/49299
5378 [49305]: https://github.com/rust-lang/rust/pull/49305
5379 [49394]: https://github.com/rust-lang/rust/pull/49394
5380 [49458]: https://github.com/rust-lang/rust/pull/49458
5381 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
5382 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
5383 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
5384 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
5385 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
5386 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
5387 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
5388 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
5389 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
5390 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
5391 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
5392 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
5393 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
5394 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
5395 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
5396 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
5397 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
5398 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
5399 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
5400 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
5401 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
5402 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
5403 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
5404 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
5405 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
5406 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
5407 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
5408 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
5409 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
5410 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
5411 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
5412 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
5413 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
5414 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
5415 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
5416 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
5417 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5418 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
5419 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
5420 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
5421 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
5422 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
5423
5424
5425 Version 1.25.0 (2018-03-29)
5426 ==========================
5427
5428 Language
5429 --------
5430 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
5431 - [You can now use nested groups of imports.][47948]
5432   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
5433 - [You can now have `|` at the start of a match arm.][47947] e.g.
5434 ```rust
5435 enum Foo { A, B, C }
5436
5437 fn main() {
5438     let x = Foo::A;
5439     match x {
5440         | Foo::A
5441         | Foo::B => println!("AB"),
5442         | Foo::C => println!("C"),
5443     }
5444 }
5445 ```
5446
5447 Compiler
5448 --------
5449 - [Upgraded to LLVM 6.][47828]
5450 - [Added `-C lto=val` option.][47521]
5451 - [Added `i586-unknown-linux-musl` target][47282]
5452
5453 Libraries
5454 ---------
5455 - [Impl Send for `process::Command` on Unix.][47760]
5456 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
5457 - [`UnsafeCell::into_inner` is now safe.][47204]
5458 - [Implement libstd for CloudABI.][47268]
5459 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
5460 - [Implement `AsRef<Path>` for Component][46985]
5461 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
5462 - [Moved `Duration` to libcore.][46666]
5463
5464 Stabilized APIs
5465 ---------------
5466 - [`Location::column`]
5467 - [`ptr::NonNull`]
5468
5469 The following functions can now be used in a constant expression.
5470 eg. `static MINUTE: Duration = Duration::from_secs(60);`
5471 - [`Duration::new`][47300]
5472 - [`Duration::from_secs`][47300]
5473 - [`Duration::from_millis`][47300]
5474
5475 Cargo
5476 -----
5477 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
5478 - [`cargo new` now defaults to creating a binary crate, instead of a
5479   library crate.][cargo/5029]
5480
5481 Misc
5482 ----
5483 - [Rust by example is now shipped with new releases][46196]
5484
5485 Compatibility Notes
5486 -------------------
5487 - [Deprecated `net::lookup_host`.][47510]
5488 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
5489 - The borrow checker was sometimes incorrectly permitting overlapping borrows
5490   around indexing operations (see [#47349][47349]). This has been fixed (which also
5491   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
5492 - [Removed deprecated unstable attribute `#[simd]`.][47251]
5493
5494 [33903]: https://github.com/rust-lang/rust/pull/33903
5495 [47947]: https://github.com/rust-lang/rust/pull/47947
5496 [47948]: https://github.com/rust-lang/rust/pull/47948
5497 [47760]: https://github.com/rust-lang/rust/pull/47760
5498 [47790]: https://github.com/rust-lang/rust/pull/47790
5499 [47828]: https://github.com/rust-lang/rust/pull/47828
5500 [47398]: https://github.com/rust-lang/rust/pull/47398
5501 [47510]: https://github.com/rust-lang/rust/pull/47510
5502 [47521]: https://github.com/rust-lang/rust/pull/47521
5503 [47204]: https://github.com/rust-lang/rust/pull/47204
5504 [47251]: https://github.com/rust-lang/rust/pull/47251
5505 [47268]: https://github.com/rust-lang/rust/pull/47268
5506 [47282]: https://github.com/rust-lang/rust/pull/47282
5507 [47300]: https://github.com/rust-lang/rust/pull/47300
5508 [47349]: https://github.com/rust-lang/rust/pull/47349
5509 [46931]: https://github.com/rust-lang/rust/pull/46931
5510 [46985]: https://github.com/rust-lang/rust/pull/46985
5511 [47006]: https://github.com/rust-lang/rust/pull/47006
5512 [46830]: https://github.com/rust-lang/rust/pull/46830
5513 [46095]: https://github.com/rust-lang/rust/pull/46095
5514 [46666]: https://github.com/rust-lang/rust/pull/46666
5515 [46196]: https://github.com/rust-lang/rust/pull/46196
5516 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
5517 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
5518 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
5519 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
5520 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
5521
5522
5523 Version 1.24.1 (2018-03-01)
5524 ==========================
5525
5526  - [Do not abort when unwinding through FFI][48251]
5527  - [Emit UTF-16 files for linker arguments on Windows][48318]
5528  - [Make the error index generator work again][48308]
5529  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
5530
5531 [48251]: https://github.com/rust-lang/rust/issues/48251
5532 [48308]: https://github.com/rust-lang/rust/issues/48308
5533 [48318]: https://github.com/rust-lang/rust/issues/48318
5534 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
5535
5536
5537 Version 1.24.0 (2018-02-15)
5538 ==========================
5539
5540 Language
5541 --------
5542 - [External `sysv64` ffi is now available.][46528]
5543   eg. `extern "sysv64" fn foo () {}`
5544
5545 Compiler
5546 --------
5547 - [rustc now uses 16 codegen units by default for release builds.][46910]
5548   For the fastest builds, utilize `codegen-units=1`.
5549 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
5550 - [Add `aarch64-unknown-openbsd` support][46760]
5551
5552 Libraries
5553 ---------
5554 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
5555   improvement in performance in the majority of cases.
5556 - [`OsStr`'s `Debug` implementation is now lossless and consistent
5557   with Windows.][46798]
5558 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
5559 - [impl `From<bool>` for `AtomicBool`][46293]
5560 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
5561 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
5562 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
5563 - [float::from_bits now just uses transmute.][46012] This provides
5564   some optimisations from LLVM.
5565 - [Copied `AsciiExt` methods onto `char`][46077]
5566 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
5567 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
5568 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
5569 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
5570
5571 Stabilized APIs
5572 ---------------
5573 - [`RefCell::replace`]
5574 - [`RefCell::swap`]
5575 - [`atomic::spin_loop_hint`]
5576
5577 The following functions can now be used in a constant expression.
5578 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
5579
5580 - [`AtomicBool::new`][46287]
5581 - [`AtomicUsize::new`][46287]
5582 - [`AtomicIsize::new`][46287]
5583 - [`AtomicPtr::new`][46287]
5584 - [`Cell::new`][46287]
5585 - [`{integer}::min_value`][46287]
5586 - [`{integer}::max_value`][46287]
5587 - [`mem::size_of`][46287]
5588 - [`mem::align_of`][46287]
5589 - [`ptr::null`][46287]
5590 - [`ptr::null_mut`][46287]
5591 - [`RefCell::new`][46287]
5592 - [`UnsafeCell::new`][46287]
5593
5594 Cargo
5595 -----
5596 - [Added a `workspace.default-members` config that
5597   overrides implied `--all` in virtual workspaces.][cargo/4743]
5598 - [Enable incremental by default on development builds.][cargo/4817] Also added
5599   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5600   per-project or global basis respectively.
5601
5602 Misc
5603 ----
5604
5605 Compatibility Notes
5606 -------------------
5607 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5608 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5609   in accordance with IETF RFC 4291 §2.2.
5610 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5611 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5612   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5613 - [Leading zeros in tuple struct members is now an error][47084]
5614 - [`column!()` macro is one-based instead of zero-based][46977]
5615 - [`fmt::Arguments` can no longer be shared across threads][45198]
5616 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5617 - [Cargo sets a different working directory for the compiler][cargo/4788]
5618
5619 [44884]: https://github.com/rust-lang/rust/pull/44884
5620 [45198]: https://github.com/rust-lang/rust/pull/45198
5621 [45506]: https://github.com/rust-lang/rust/pull/45506
5622 [45990]: https://github.com/rust-lang/rust/pull/45990
5623 [46012]: https://github.com/rust-lang/rust/pull/46012
5624 [46077]: https://github.com/rust-lang/rust/pull/46077
5625 [46094]: https://github.com/rust-lang/rust/pull/46094
5626 [46284]: https://github.com/rust-lang/rust/pull/46284
5627 [46287]: https://github.com/rust-lang/rust/pull/46287
5628 [46293]: https://github.com/rust-lang/rust/pull/46293
5629 [46528]: https://github.com/rust-lang/rust/pull/46528
5630 [46671]: https://github.com/rust-lang/rust/pull/46671
5631 [46713]: https://github.com/rust-lang/rust/pull/46713
5632 [46735]: https://github.com/rust-lang/rust/pull/46735
5633 [46760]: https://github.com/rust-lang/rust/pull/46760
5634 [46798]: https://github.com/rust-lang/rust/pull/46798
5635 [46828]: https://github.com/rust-lang/rust/pull/46828
5636 [46831]: https://github.com/rust-lang/rust/pull/46831
5637 [46833]: https://github.com/rust-lang/rust/pull/46833
5638 [46910]: https://github.com/rust-lang/rust/pull/46910
5639 [46977]: https://github.com/rust-lang/rust/pull/46977
5640 [47018]: https://github.com/rust-lang/rust/pull/47018
5641 [47080]: https://github.com/rust-lang/rust/pull/47080
5642 [47084]: https://github.com/rust-lang/rust/pull/47084
5643 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5644 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5645 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5646 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5647 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5648 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5649
5650
5651 Version 1.23.0 (2018-01-04)
5652 ==========================
5653
5654 Language
5655 --------
5656 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5657 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5658   Which should fix some confusing errors in some operations.
5659
5660 Compiler
5661 --------
5662 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5663   undefined behavior.][45920]
5664 - [rustc now suggests renaming import if names clash.][45660]
5665 - [Display errors/warnings correctly when there are zero-width or
5666   wide characters.][45711]
5667 - [rustc now avoids unnecessary copies of arguments that are
5668   simple bindings][45380] This should improve memory usage on average by 5-10%.
5669 - [Updated musl used to build musl rustc to 1.1.17][45393]
5670
5671 Libraries
5672 ---------
5673 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5674 - [Implement Hash for raw pointers to unsized types][45483]
5675 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5676 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5677 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5678 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5679   and `<*mut T>::as_mut`][44932]
5680 - [Optimized `Thread::{park, unpark}` implementation][45524]
5681 - [Improved `SliceExt::binary_search` performance.][45333]
5682 - [impl `FromIterator<()>` for `()`][45379]
5683 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5684   is now deprecated.
5685
5686 Stabilized APIs
5687 ---------------
5688
5689 Cargo
5690 -----
5691 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5692   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5693 - [Added unit test checking to `cargo check`][cargo/4592]
5694 - [Cargo now lets you install a specific version
5695   using `cargo install --version`][cargo/4637]
5696
5697 Misc
5698 ----
5699 - [Releases now ship with the Cargo book documentation.][45692]
5700 - [rustdoc now prints rendering warnings on every run.][45324]
5701
5702 Compatibility Notes
5703 -------------------
5704 - [Changes have been made to type equality to make it more correct,
5705   in rare cases this could break some code.][45853] [Tracking issue for
5706   further information][45852]
5707 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5708 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5709   Android 9, the minimum supported version is Android 14.
5710 - [Bumped the minimum LLVM to 3.9][45326]
5711
5712 [44042]: https://github.com/rust-lang/rust/pull/44042
5713 [44932]: https://github.com/rust-lang/rust/pull/44932
5714 [45267]: https://github.com/rust-lang/rust/pull/45267
5715 [45324]: https://github.com/rust-lang/rust/pull/45324
5716 [45326]: https://github.com/rust-lang/rust/pull/45326
5717 [45333]: https://github.com/rust-lang/rust/pull/45333
5718 [45379]: https://github.com/rust-lang/rust/pull/45379
5719 [45380]: https://github.com/rust-lang/rust/pull/45380
5720 [45393]: https://github.com/rust-lang/rust/pull/45393
5721 [45435]: https://github.com/rust-lang/rust/pull/45435
5722 [45483]: https://github.com/rust-lang/rust/pull/45483
5723 [45524]: https://github.com/rust-lang/rust/pull/45524
5724 [45571]: https://github.com/rust-lang/rust/pull/45571
5725 [45580]: https://github.com/rust-lang/rust/pull/45580
5726 [45610]: https://github.com/rust-lang/rust/pull/45610
5727 [45660]: https://github.com/rust-lang/rust/pull/45660
5728 [45692]: https://github.com/rust-lang/rust/pull/45692
5729 [45711]: https://github.com/rust-lang/rust/pull/45711
5730 [45772]: https://github.com/rust-lang/rust/pull/45772
5731 [45852]: https://github.com/rust-lang/rust/issues/45852
5732 [45853]: https://github.com/rust-lang/rust/pull/45853
5733 [45887]: https://github.com/rust-lang/rust/pull/45887
5734 [45920]: https://github.com/rust-lang/rust/pull/45920
5735 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5736 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5737 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5738
5739
5740 Version 1.22.1 (2017-11-22)
5741 ==========================
5742
5743 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5744
5745 [46183]: https://github.com/rust-lang/rust/pull/46183
5746
5747 Version 1.22.0 (2017-11-22)
5748 ==========================
5749
5750 Language
5751 --------
5752 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5753 - [Now accepts underscores in unicode escapes][43716]
5754 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5755 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5756
5757 Compiler
5758 --------
5759 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5760 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5761   This should decrease compile times for debug builds.
5762 - [strict memory alignment now enabled on ARMv6][45094]
5763 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5764
5765 Libraries
5766 ---------
5767 - [Allow atomic operations up to 32 bits
5768   on `armv5te_unknown_linux_gnueabi`][44978]
5769 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5770 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5771 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5772 - [Properly detect overflow in `Instant += Duration`.][44220]
5773 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5774 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5775 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5776
5777 Stabilized APIs
5778 ---------------
5779
5780 Cargo
5781 -----
5782 - [Cargo will now build multi file examples in subdirectories of the `examples`
5783   folder that have a `main.rs` file.][cargo/4496]
5784 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5785   the old format will continue to work and can be updated with `cargo update`.
5786 - [Now supports vendoring git repositories][cargo/3992]
5787
5788 Misc
5789 ----
5790 - [`libbacktrace` is now available on Apple platforms.][44251]
5791 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5792   This now lets you specify that a given code example will fail to compile.
5793
5794 Compatibility Notes
5795 -------------------
5796 - [The minimum Android version that rustc can build for has been bumped
5797   to `4.0` from `2.3`][45656]
5798 - [Allowing `T op= &T` for numeric types has broken some type
5799   inference cases][45480]
5800
5801
5802 [42526]: https://github.com/rust-lang/rust/pull/42526
5803 [43716]: https://github.com/rust-lang/rust/pull/43716
5804 [43949]: https://github.com/rust-lang/rust/pull/43949
5805 [44015]: https://github.com/rust-lang/rust/pull/44015
5806 [44220]: https://github.com/rust-lang/rust/pull/44220
5807 [44251]: https://github.com/rust-lang/rust/pull/44251
5808 [44287]: https://github.com/rust-lang/rust/pull/44287
5809 [44303]: https://github.com/rust-lang/rust/pull/44303
5810 [44456]: https://github.com/rust-lang/rust/pull/44456
5811 [44466]: https://github.com/rust-lang/rust/pull/44466
5812 [44895]: https://github.com/rust-lang/rust/pull/44895
5813 [44966]: https://github.com/rust-lang/rust/pull/44966
5814 [44978]: https://github.com/rust-lang/rust/pull/44978
5815 [45041]: https://github.com/rust-lang/rust/pull/45041
5816 [45064]: https://github.com/rust-lang/rust/pull/45064
5817 [45075]: https://github.com/rust-lang/rust/pull/45075
5818 [45094]: https://github.com/rust-lang/rust/pull/45094
5819 [45095]: https://github.com/rust-lang/rust/pull/45095
5820 [45480]: https://github.com/rust-lang/rust/issues/45480
5821 [45656]: https://github.com/rust-lang/rust/pull/45656
5822 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5823 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5824 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5825
5826
5827
5828
5829
5830
5831 Version 1.21.0 (2017-10-12)
5832 ==========================
5833
5834 Language
5835 --------
5836 - [You can now use static references for literals.][43838]
5837   Example:
5838   ```rust
5839   fn main() {
5840       let x: &'static u32 = &0;
5841   }
5842   ```
5843 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5844   Example:
5845   ```rust
5846   my_macro!(Vec<i32>::new); // Always worked
5847   my_macro!(Vec::<i32>::new); // Now works
5848   ```
5849
5850 Compiler
5851 --------
5852 - [Upgraded jemalloc to 4.5.0][43911]
5853 - [Enabled unwinding panics on Redox][43917]
5854 - [Now runs LLVM in parallel during translation phase.][43506]
5855   This should reduce peak memory usage.
5856
5857 Libraries
5858 ---------
5859 - [Generate builtin impls for `Clone` for all arrays and tuples that
5860   are `T: Clone`][43690]
5861 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5862 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5863   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5864
5865 Stabilized APIs
5866 ---------------
5867
5868 [`std::mem::discriminant`]
5869
5870 Cargo
5871 -----
5872 - [You can now call `cargo install` with multiple package names][cargo/4216]
5873 - [Cargo commands inside a virtual workspace will now implicitly
5874   pass `--all`][cargo/4335]
5875 - [Added a `[patch]` section to `Cargo.toml` to handle
5876   prepublication dependencies][cargo/4123] [RFC 1969]
5877 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5878   like patterns][cargo/4270]
5879 - [Added the `--all-targets` option][cargo/4400]
5880 - [Using required dependencies as a feature is now deprecated and emits
5881   a warning][cargo/4364]
5882
5883
5884 Misc
5885 ----
5886 - [Cargo docs are moving][43916]
5887   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5888 - [The rustdoc book is now available][43863]
5889   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5890 - [Added a preview of RLS has been made available through rustup][44204]
5891   Install with `rustup component add rls-preview`
5892 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5893   Previously only showed `std::os::unix`.
5894
5895 Compatibility Notes
5896 -------------------
5897 - [Changes in method matching against higher-ranked types][43880] This may cause
5898   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5899 - [rustc's JSON error output's byte position start at top of file.][42973]
5900   Was previously relative to the rustc's internal `CodeMap` struct which
5901   required the unstable library `libsyntax` to correctly use.
5902 - [`unused_results` lint no longer ignores booleans][43728]
5903
5904 [42565]: https://github.com/rust-lang/rust/pull/42565
5905 [42973]: https://github.com/rust-lang/rust/pull/42973
5906 [43348]: https://github.com/rust-lang/rust/pull/43348
5907 [43459]: https://github.com/rust-lang/rust/pull/43459
5908 [43506]: https://github.com/rust-lang/rust/pull/43506
5909 [43540]: https://github.com/rust-lang/rust/pull/43540
5910 [43690]: https://github.com/rust-lang/rust/pull/43690
5911 [43728]: https://github.com/rust-lang/rust/pull/43728
5912 [43838]: https://github.com/rust-lang/rust/pull/43838
5913 [43863]: https://github.com/rust-lang/rust/pull/43863
5914 [43880]: https://github.com/rust-lang/rust/pull/43880
5915 [43911]: https://github.com/rust-lang/rust/pull/43911
5916 [43916]: https://github.com/rust-lang/rust/pull/43916
5917 [43917]: https://github.com/rust-lang/rust/pull/43917
5918 [44204]: https://github.com/rust-lang/rust/pull/44204
5919 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5920 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5921 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5922 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5923 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5924 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5925 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5926 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5927 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5928
5929 Version 1.20.0 (2017-08-31)
5930 ===========================
5931
5932 Language
5933 --------
5934 - [Associated constants are now stabilised.][42809]
5935 - [A lot of macro bugs are now fixed.][42913]
5936
5937 Compiler
5938 --------
5939
5940 - [Struct fields are now properly coerced to the expected field type.][42807]
5941 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5942   `wasm32-experimental-emscripten` target.
5943 - [Changed some of the error messages to be more helpful.][42033]
5944 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5945   it.][43170]
5946 - [rustc now reports the total number of errors on compilation failure][43015]
5947   previously this was only the number of errors in the pass that failed.
5948 - [Expansion in rustc has been sped up 29x.][42533]
5949 - [added `msp430-none-elf` target.][43099]
5950 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5951   applicable][43178]
5952 - [Fixes backtraces on Redox][43228]
5953 - [rustc now identifies different versions of same crate when absolute paths of
5954   different types match in an error message.][42826]
5955
5956 Libraries
5957 ---------
5958
5959
5960 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5961 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5962   tuples.][43011]
5963 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5964   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5965 - [Impl `Clone` for `DefaultHasher`.][42799]
5966 - [Impl `Sync` for `SyncSender`.][42397]
5967 - [Impl `FromStr` for `char`][42271]
5968 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5969   NaN.][42431]
5970 - [allow messages in the `unimplemented!()` macro.][42155]
5971   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5972 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5973 - [Upgrade to Unicode 10.0.0][42999]
5974 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5975 - [Skip the main thread's manual stack guard on Linux][43072]
5976 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5977 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5978   previously 2^15.
5979 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5980
5981 Stabilized APIs
5982 ---------------
5983
5984 - [`CStr::into_c_string`]
5985 - [`CString::as_c_str`]
5986 - [`CString::into_boxed_c_str`]
5987 - [`Chain::get_mut`]
5988 - [`Chain::get_ref`]
5989 - [`Chain::into_inner`]
5990 - [`Option::get_or_insert_with`]
5991 - [`Option::get_or_insert`]
5992 - [`OsStr::into_os_string`]
5993 - [`OsString::into_boxed_os_str`]
5994 - [`Take::get_mut`]
5995 - [`Take::get_ref`]
5996 - [`Utf8Error::error_len`]
5997 - [`char::EscapeDebug`]
5998 - [`char::escape_debug`]
5999 - [`compile_error!`]
6000 - [`f32::from_bits`]
6001 - [`f32::to_bits`]
6002 - [`f64::from_bits`]
6003 - [`f64::to_bits`]
6004 - [`mem::ManuallyDrop`]
6005 - [`slice::sort_unstable_by_key`]
6006 - [`slice::sort_unstable_by`]
6007 - [`slice::sort_unstable`]
6008 - [`str::from_boxed_utf8_unchecked`]
6009 - [`str::as_bytes_mut`]
6010 - [`str::as_bytes_mut`]
6011 - [`str::from_utf8_mut`]
6012 - [`str::from_utf8_unchecked_mut`]
6013 - [`str::get_mut`]
6014 - [`str::get_unchecked_mut`]
6015 - [`str::get_unchecked`]
6016 - [`str::get`]
6017 - [`str::into_boxed_bytes`]
6018
6019
6020 Cargo
6021 -----
6022 - [Cargo API token location moved from `~/.cargo/config` to
6023   `~/.cargo/credentials`.][cargo/3978]
6024 - [Cargo will now build `main.rs` binaries that are in sub-directories of
6025   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
6026   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
6027 - [You can now specify version of a binary when installed through
6028   `cargo install` using `--vers`.][cargo/4229]
6029 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
6030   failure.][cargo/4248]
6031 - [Changed the convention around which file is the crate root.][cargo/4259]
6032
6033 Compatibility Notes
6034 -------------------
6035
6036 - [Functions with `'static` in their return types will now not be as usable as
6037   if they were using lifetime parameters instead.][42417]
6038 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
6039   takes the sign of NaN into account where previously didn't.][42430]
6040
6041 [42033]: https://github.com/rust-lang/rust/pull/42033
6042 [42155]: https://github.com/rust-lang/rust/pull/42155
6043 [42271]: https://github.com/rust-lang/rust/pull/42271
6044 [42397]: https://github.com/rust-lang/rust/pull/42397
6045 [42417]: https://github.com/rust-lang/rust/pull/42417
6046 [42430]: https://github.com/rust-lang/rust/pull/42430
6047 [42431]: https://github.com/rust-lang/rust/pull/42431
6048 [42533]: https://github.com/rust-lang/rust/pull/42533
6049 [42571]: https://github.com/rust-lang/rust/pull/42571
6050 [42613]: https://github.com/rust-lang/rust/pull/42613
6051 [42799]: https://github.com/rust-lang/rust/pull/42799
6052 [42807]: https://github.com/rust-lang/rust/pull/42807
6053 [42809]: https://github.com/rust-lang/rust/pull/42809
6054 [42822]: https://github.com/rust-lang/rust/pull/42822
6055 [42826]: https://github.com/rust-lang/rust/pull/42826
6056 [42854]: https://github.com/rust-lang/rust/pull/42854
6057 [42913]: https://github.com/rust-lang/rust/pull/42913
6058 [42999]: https://github.com/rust-lang/rust/pull/42999
6059 [43011]: https://github.com/rust-lang/rust/pull/43011
6060 [43015]: https://github.com/rust-lang/rust/pull/43015
6061 [43072]: https://github.com/rust-lang/rust/pull/43072
6062 [43077]: https://github.com/rust-lang/rust/pull/43077
6063 [43097]: https://github.com/rust-lang/rust/pull/43097
6064 [43099]: https://github.com/rust-lang/rust/pull/43099
6065 [43170]: https://github.com/rust-lang/rust/pull/43170
6066 [43178]: https://github.com/rust-lang/rust/pull/43178
6067 [43185]: https://github.com/rust-lang/rust/pull/43185
6068 [43228]: https://github.com/rust-lang/rust/pull/43228
6069 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
6070 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
6071 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
6072 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
6073 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
6074 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
6075 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
6076 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
6077 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
6078 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
6079 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
6080 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
6081 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
6082 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
6083 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
6084 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
6085 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
6086 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
6087 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
6088 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
6089 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
6090 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
6091 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
6092 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
6093 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
6094 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
6095 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
6096 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
6097 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
6098 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
6099 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
6100 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
6101 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
6102 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
6103 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
6104 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
6105 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
6106 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
6107
6108
6109 Version 1.19.0 (2017-07-20)
6110 ===========================
6111
6112 Language
6113 --------
6114
6115 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
6116   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
6117 - [Macro recursion limit increased to 1024 from 64.][41676]
6118 - [Added lint for detecting unused macros.][41907]
6119 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
6120   For example: `let x = loop { break 7; };`
6121 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
6122   contain `Copy` types and cannot have a `Drop` implementation.
6123   Example: `union Foo { bar: u8, baz: usize }`
6124 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
6125   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
6126
6127 Compiler
6128 --------
6129
6130 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
6131 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
6132   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
6133   you should use `--target armv7-linux-androideabi`.
6134 - [Fixed ICE when removing a source file between compilation sessions.][41873]
6135 - [Minor optimisation of string operations.][42037]
6136 - [Compiler error message is now `aborting due to previous error(s)` instead of
6137   `aborting due to N previous errors`][42150] This was previously inaccurate and
6138   would only count certain kinds of errors.
6139 - [The compiler now supports Visual Studio 2017][42225]
6140 - [The compiler is now built against LLVM 4.0.1 by default][42948]
6141 - [Added a lot][42264] of [new error codes][42302]
6142 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
6143   libraries with C Run-time Libraries(CRT) to be statically linked.
6144 - [Fixed various ARM codegen bugs][42740]
6145
6146 Libraries
6147 ---------
6148
6149 - [`String` now implements `FromIterator<Cow<'a, str>>` and
6150   `Extend<Cow<'a, str>>`][41449]
6151 - [`Vec` now implements `From<&mut [T]>`][41530]
6152 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
6153 - [`SplitWhitespace` now implements `Clone`][41659]
6154 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
6155   1.5x faster][41764]
6156 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
6157   macros, but for printing to stderr.
6158
6159 Stabilized APIs
6160 ---------------
6161
6162 - [`OsString::shrink_to_fit`]
6163 - [`cmp::Reverse`]
6164 - [`Command::envs`]
6165 - [`thread::ThreadId`]
6166
6167 Cargo
6168 -----
6169
6170 - [Build scripts can now add environment variables to the environment
6171   the crate is being compiled in.
6172   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
6173 - [Subcommands now replace the current process rather than spawning a new
6174   child process][cargo/3970]
6175 - [Workspace members can now accept glob file patterns][cargo/3979]
6176 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
6177   the members in a given workspace.][cargo/3988]
6178 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
6179 - [Target directory path is now in the cargo metadata][cargo/4022]
6180 - [Cargo no longer checks out a local working directory for the
6181   crates.io index][cargo/4026] This should provide smaller file size for the
6182   registry, and improve cloning times, especially on Windows machines.
6183 - [Added an `--exclude` option for excluding certain packages when using the
6184   `--all` option][cargo/4031]
6185 - [Cargo will now automatically retry when receiving a 5xx error
6186   from crates.io][cargo/4032]
6187 - [The `--features` option now accepts multiple comma or space
6188   delimited values.][cargo/4084]
6189 - [Added support for custom target specific runners][cargo/3954]
6190
6191 Misc
6192 ----
6193
6194 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
6195   Windows Debugger.
6196 - [Rust will now release XZ compressed packages][rust-installer/57]
6197 - [rustup will now prefer to download rust packages with
6198   XZ compression][rustup/1100] over GZip packages.
6199 - [Added the ability to escape `#` in rust documentation][41785] By adding
6200   additional `#`'s ie. `##` is now `#`
6201
6202 Compatibility Notes
6203 -------------------
6204
6205 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
6206 - [`-Z` flags are now no longer allowed to be used on the stable
6207   compiler.][41751] This has been a warning for a year previous to this.
6208 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
6209   longer works][42844]. Users should migrate to the built-in `check`
6210   command, which has been available since 1.16.
6211 - [Ending a float literal with `._` is now a hard error.
6212   Example: `42._` .][41946]
6213 - [Any use of a private `extern crate` outside of its module is now a
6214   hard error.][36886] This was previously a warning.
6215 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
6216   relative while the `::` prefix makes a path absolute, but was ignored and the
6217   path was relative regardless.
6218 - [Floating point constants in match patterns is now a hard error][36890]
6219   This was previously a warning.
6220 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
6221   match patterns is now a hard error][36891] This was previously a warning.
6222 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
6223   a warning.
6224 - [From the pound escape, lines consisting of multiple `#`s are
6225   now visible][41785]
6226 - [It is an error to re-export private enum variants][42460]. This is
6227   known to break a number of crates that depend on an older version of
6228   mustache.
6229 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
6230   to use it to find the linker, and the build will fail where it did
6231   not previously][42607]
6232
6233 [36886]: https://github.com/rust-lang/rust/issues/36886
6234 [36888]: https://github.com/rust-lang/rust/issues/36888
6235 [36890]: https://github.com/rust-lang/rust/issues/36890
6236 [36891]: https://github.com/rust-lang/rust/issues/36891
6237 [36892]: https://github.com/rust-lang/rust/issues/36892
6238 [37406]: https://github.com/rust-lang/rust/issues/37406
6239 [39983]: https://github.com/rust-lang/rust/pull/39983
6240 [41145]: https://github.com/rust-lang/rust/pull/41145
6241 [41192]: https://github.com/rust-lang/rust/pull/41192
6242 [41258]: https://github.com/rust-lang/rust/pull/41258
6243 [41370]: https://github.com/rust-lang/rust/pull/41370
6244 [41449]: https://github.com/rust-lang/rust/pull/41449
6245 [41530]: https://github.com/rust-lang/rust/pull/41530
6246 [41624]: https://github.com/rust-lang/rust/pull/41624
6247 [41656]: https://github.com/rust-lang/rust/pull/41656
6248 [41659]: https://github.com/rust-lang/rust/pull/41659
6249 [41676]: https://github.com/rust-lang/rust/pull/41676
6250 [41751]: https://github.com/rust-lang/rust/pull/41751
6251 [41764]: https://github.com/rust-lang/rust/pull/41764
6252 [41785]: https://github.com/rust-lang/rust/pull/41785
6253 [41873]: https://github.com/rust-lang/rust/pull/41873
6254 [41907]: https://github.com/rust-lang/rust/pull/41907
6255 [41946]: https://github.com/rust-lang/rust/pull/41946
6256 [42016]: https://github.com/rust-lang/rust/pull/42016
6257 [42037]: https://github.com/rust-lang/rust/pull/42037
6258 [42068]: https://github.com/rust-lang/rust/pull/42068
6259 [42150]: https://github.com/rust-lang/rust/pull/42150
6260 [42162]: https://github.com/rust-lang/rust/pull/42162
6261 [42225]: https://github.com/rust-lang/rust/pull/42225
6262 [42264]: https://github.com/rust-lang/rust/pull/42264
6263 [42302]: https://github.com/rust-lang/rust/pull/42302
6264 [42460]: https://github.com/rust-lang/rust/issues/42460
6265 [42607]: https://github.com/rust-lang/rust/issues/42607
6266 [42740]: https://github.com/rust-lang/rust/pull/42740
6267 [42844]: https://github.com/rust-lang/rust/issues/42844
6268 [42948]: https://github.com/rust-lang/rust/pull/42948
6269 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
6270 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
6271 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
6272 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
6273 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
6274 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
6275 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
6276 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
6277 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
6278 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
6279 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
6280 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
6281 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
6282 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
6283 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
6284 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
6285 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
6286 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
6287 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
6288 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
6289 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
6290 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
6291
6292
6293 Version 1.18.0 (2017-06-08)
6294 ===========================
6295
6296 Language
6297 --------
6298
6299 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
6300   make the item visible to just that module tree. Also accepts the keyword
6301   `crate` to make something public to the whole crate but not users of the
6302   library. Example: `pub(crate) mod utils;`. [RFC 1422].
6303 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
6304   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
6305 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
6306   types like `Write + Send`, trailing `+` are now supported in trait objects,
6307   and better error reporting for trait objects starting with `?Sized`.
6308 - [0e+10 is now a valid floating point literal][40589]
6309 - [Now warns if you bind a lifetime parameter to 'static][40734]
6310 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
6311   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
6312   representation in some cases.][40377]
6313
6314 Compiler
6315 --------
6316
6317 - [rustc can now emit mir with `--emit mir`][39891]
6318 - [Improved LLVM IR for trivial functions][40367]
6319 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
6320 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
6321   opportunities found through profiling
6322 - [Improved backtrace formatting when panicking][38165]
6323
6324 Libraries
6325 ---------
6326
6327 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
6328   iterator hasn't been advanced the original `Vec` is reassembled with no actual
6329   iteration or reallocation.
6330 - [Simplified HashMap Bucket interface][40561] provides performance
6331   improvements for iterating and cloning.
6332 - [Specialize Vec::from_elem to use calloc][40409]
6333 - [Fixed Race condition in fs::create_dir_all][39799]
6334 - [No longer caching stdio on Windows][40516]
6335 - [Optimized insertion sort in slice][40807] insertion sort in some cases
6336   2.50%~ faster and in one case now 12.50% faster.
6337 - [Optimized `AtomicBool::fetch_nand`][41143]
6338
6339 Stabilized APIs
6340 ---------------
6341
6342 - [`Child::try_wait`]
6343 - [`HashMap::retain`]
6344 - [`HashSet::retain`]
6345 - [`PeekMut::pop`]
6346 - [`TcpStream::peek`]
6347 - [`UdpSocket::peek`]
6348 - [`UdpSocket::peek_from`]
6349
6350 Cargo
6351 -----
6352
6353 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
6354   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
6355 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
6356 - [Added Android build support][cargo/3885]
6357 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
6358   of a certain type, for example `cargo build --bins` will build all
6359   binaries.
6360 - [Added support for haiku][cargo/3952]
6361
6362 Misc
6363 ----
6364
6365 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
6366 - [Rust now uses the official cross compiler for NetBSD][40612]
6367 - [rustdoc now accepts `#` at the start of files][40828]
6368 - [Fixed jemalloc support for musl][41168]
6369
6370 Compatibility Notes
6371 -------------------
6372
6373 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
6374   always placed after the sign if it exists and before the digits. With the `#`
6375   flag the zeroes are placed after the prefix and before the digits.
6376 - [Due to the struct field optimisation][40377], using `transmute` on structs
6377   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
6378   always been undefined behavior, but is now more likely to break in practice.
6379 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
6380   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
6381   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
6382 - [Overlapping inherent `impl`s are now a hard error][40728]
6383 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
6384 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
6385   `out.asm` and `out.ll` instead of only one of the filetypes.
6386 - [ calling a function that returns `Self` will no longer work][41805] when
6387   the size of `Self` cannot be statically determined.
6388 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
6389   this has caused a few regressions namely:
6390
6391   - Changed the link order of local static/dynamic libraries (respecting the
6392     order on given rather than having the compiler reorder).
6393   - Changed how MinGW is linked, native code linked to dynamic libraries
6394     may require manually linking to the gcc support library (for the native
6395     code itself)
6396
6397 [38165]: https://github.com/rust-lang/rust/pull/38165
6398 [39799]: https://github.com/rust-lang/rust/pull/39799
6399 [39891]: https://github.com/rust-lang/rust/pull/39891
6400 [40043]: https://github.com/rust-lang/rust/pull/40043
6401 [40241]: https://github.com/rust-lang/rust/pull/40241
6402 [40338]: https://github.com/rust-lang/rust/pull/40338
6403 [40367]: https://github.com/rust-lang/rust/pull/40367
6404 [40377]: https://github.com/rust-lang/rust/pull/40377
6405 [40409]: https://github.com/rust-lang/rust/pull/40409
6406 [40516]: https://github.com/rust-lang/rust/pull/40516
6407 [40556]: https://github.com/rust-lang/rust/pull/40556
6408 [40561]: https://github.com/rust-lang/rust/pull/40561
6409 [40589]: https://github.com/rust-lang/rust/pull/40589
6410 [40612]: https://github.com/rust-lang/rust/pull/40612
6411 [40723]: https://github.com/rust-lang/rust/pull/40723
6412 [40728]: https://github.com/rust-lang/rust/pull/40728
6413 [40731]: https://github.com/rust-lang/rust/pull/40731
6414 [40734]: https://github.com/rust-lang/rust/pull/40734
6415 [40805]: https://github.com/rust-lang/rust/pull/40805
6416 [40807]: https://github.com/rust-lang/rust/pull/40807
6417 [40828]: https://github.com/rust-lang/rust/pull/40828
6418 [40870]: https://github.com/rust-lang/rust/pull/40870
6419 [41085]: https://github.com/rust-lang/rust/pull/41085
6420 [41143]: https://github.com/rust-lang/rust/pull/41143
6421 [41168]: https://github.com/rust-lang/rust/pull/41168
6422 [41270]: https://github.com/rust-lang/rust/issues/41270
6423 [41469]: https://github.com/rust-lang/rust/pull/41469
6424 [41805]: https://github.com/rust-lang/rust/issues/41805
6425 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
6426 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
6427 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
6428 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
6429 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
6430 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
6431 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
6432 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
6433 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
6434 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
6435 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
6436 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
6437 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
6438 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
6439
6440
6441 Version 1.17.0 (2017-04-27)
6442 ===========================
6443
6444 Language
6445 --------
6446
6447 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
6448 * [Fields of structs may be initialized without duplicating the field/variable
6449   names][39761]. [RFC 1682]
6450 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
6451 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6452   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
6453   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
6454   `'b`. Soundness fix.
6455 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
6456 * [Static variables may contain references to other statics][40027]
6457
6458 Compiler
6459 --------
6460
6461 * [Exit quickly on only `--emit dep-info`][40336]
6462 * [Make `-C relocation-model` more correctly determine whether the linker
6463   creates a position-independent executable][40245]
6464 * [Add `-C overflow-checks` to directly control whether integer overflow
6465   panics][40037]
6466 * [The rustc type checker now checks items on demand instead of in a single
6467   in-order pass][40008]. This is mostly an internal refactoring in support of
6468   future work, including incremental type checking, but also resolves [RFC
6469   1647], allowing `Self` to appear in `impl` `where` clauses.
6470 * [Optimize vtable loads][39995]
6471 * [Turn off vectorization for Emscripten targets][39990]
6472 * [Provide suggestions for unknown macros imported with `use`][39953]
6473 * [Fix ICEs in path resolution][39939]
6474 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
6475 * [Add clearer error message using `&str + &str`][39116]
6476
6477 Stabilized APIs
6478 ---------------
6479
6480 * [`Arc::into_raw`]
6481 * [`Arc::from_raw`]
6482 * [`Arc::ptr_eq`]
6483 * [`Rc::into_raw`]
6484 * [`Rc::from_raw`]
6485 * [`Rc::ptr_eq`]
6486 * [`Ordering::then`]
6487 * [`Ordering::then_with`]
6488 * [`BTreeMap::range`]
6489 * [`BTreeMap::range_mut`]
6490 * [`collections::Bound`]
6491 * [`process::abort`]
6492 * [`ptr::read_unaligned`]
6493 * [`ptr::write_unaligned`]
6494 * [`Result::expect_err`]
6495 * [`Cell::swap`]
6496 * [`Cell::replace`]
6497 * [`Cell::into_inner`]
6498 * [`Cell::take`]
6499
6500 Libraries
6501 ---------
6502
6503 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
6504 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
6505 * [`String` implements `FromIterator<&char>`][40028]
6506 * `Box` [implements][40009] a number of new conversions:
6507   `From<Box<str>> for String`,
6508   `From<Box<[T]>> for Vec<T>`,
6509   `From<Box<CStr>> for CString`,
6510   `From<Box<OsStr>> for OsString`,
6511   `From<Box<Path>> for PathBuf`,
6512   `Into<Box<str>> for String`,
6513   `Into<Box<[T]>> for Vec<T>`,
6514   `Into<Box<CStr>> for CString`,
6515   `Into<Box<OsStr>> for OsString`,
6516   `Into<Box<Path>> for PathBuf`,
6517   `Default for Box<str>`,
6518   `Default for Box<CStr>`,
6519   `Default for Box<OsStr>`,
6520   `From<&CStr> for Box<CStr>`,
6521   `From<&OsStr> for Box<OsStr>`,
6522   `From<&Path> for Box<Path>`
6523 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
6524 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
6525 * [Slightly optimize `slice::sort`][39538]
6526 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
6527 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
6528   `Box<str>` implements `From<&str>`][39438]
6529 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
6530   `From<(I, u16)> where I: Into<IpAddr>`][39372]
6531 * [`format!` estimates the needed capacity before writing a string][39356]
6532 * [Support unprivileged symlink creation in Windows][38921]
6533 * [`PathBuf` implements `Default`][38764]
6534 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
6535 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
6536   and poor hash functions.
6537
6538 Cargo
6539 -----
6540
6541 * [Add `cargo check --all`][cargo/3731]
6542 * [Add an option to ignore SSL revocation checking][cargo/3699]
6543 * [Add `cargo run --package`][cargo/3691]
6544 * [Add `required_features`][cargo/3667]
6545 * [Assume `build.rs` is a build script][cargo/3664]
6546 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
6547
6548 Misc
6549 ----
6550
6551 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
6552   `rustbook`][39633]
6553 * [The "Unstable Book" documents nightly-only features][ubook]
6554 * [Improve the style of the sidebar in rustdoc output][40265]
6555 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
6556 * [Fix MSP430 breakage due to `i128`][40257]
6557 * [Preliminary Solaris/SPARCv9 support][39903]
6558 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
6559   run without installing the MSVC runtime.
6560 * [`rustdoc --test` includes file names in test names][39788]
6561 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
6562   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
6563 * [Initial support for `aarch64-unknown-freebsd`][39491]
6564 * [Initial support for `i686-unknown-netbsd`][39426]
6565 * [This release no longer includes the old makefile build system][39431]. Rust
6566   is built with a custom build system, written in Rust, and with Cargo.
6567 * [Add Debug implementations for libcollection structs][39002]
6568 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
6569 * [`--test-threads=0` produces an error][38945]
6570 * [`rustup` installs documentation by default][40526]
6571 * [The Rust source includes NatVis visualizations][39843]. These can be used by
6572   WinDbg and Visual Studio to improve the debugging experience.
6573
6574 Compatibility Notes
6575 -------------------
6576
6577 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
6578   workaround, either use MSVC 2015 or run vcvars.bat.
6579 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6580   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
6581   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
6582   fix.
6583 * [`format!` and `Display::to_string` panic if an underlying formatting
6584   implementation returns an error][40117]. Previously the error was silently
6585   ignored. It is incorrect for `write_fmt` to return an error when writing
6586   to a string.
6587 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6588   crates were marked stable and could be accessed from the stable toolchain.
6589 * [Rust git source no longer includes vendored crates][39728]. Those that need
6590   to build with vendored crates should build from release tarballs.
6591 * [Fix inert attributes from `proc_macro_derives`][39572]
6592 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6593   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6594   build system.
6595 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6596   existing code generally ignores the type of dead-code unless a type-hint is
6597   provided; this can cause surprising inference interactions particularly around
6598   defaulting. The new code uniformly ignores the result type of dead-code.
6599 * [Tuple-struct constructors with private fields are no longer visible][38932]
6600 * [Lifetime parameters that do not appear in the arguments are now considered
6601   early-bound][38897], resolving a soundness bug (#[32330]). The
6602   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6603   April of 2016.
6604 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6605 * [Make transmuting from fn item types to pointer-sized types a hard
6606   error][34198]
6607
6608 [27787]: https://github.com/rust-lang/rust/issues/27787
6609 [32330]: https://github.com/rust-lang/rust/issues/32330
6610 [34198]: https://github.com/rust-lang/rust/pull/34198
6611 [38161]: https://github.com/rust-lang/rust/pull/38161
6612 [38368]: https://github.com/rust-lang/rust/pull/38368
6613 [38584]: https://github.com/rust-lang/rust/issues/38584
6614 [38661]: https://github.com/rust-lang/rust/pull/38661
6615 [38764]: https://github.com/rust-lang/rust/pull/38764
6616 [38864]: https://github.com/rust-lang/rust/issues/38864
6617 [38897]: https://github.com/rust-lang/rust/pull/38897
6618 [38921]: https://github.com/rust-lang/rust/pull/38921
6619 [38932]: https://github.com/rust-lang/rust/pull/38932
6620 [38945]: https://github.com/rust-lang/rust/pull/38945
6621 [38981]: https://github.com/rust-lang/rust/pull/38981
6622 [39002]: https://github.com/rust-lang/rust/pull/39002
6623 [39116]: https://github.com/rust-lang/rust/pull/39116
6624 [39193]: https://github.com/rust-lang/rust/pull/39193
6625 [39265]: https://github.com/rust-lang/rust/pull/39265
6626 [39356]: https://github.com/rust-lang/rust/pull/39356
6627 [39372]: https://github.com/rust-lang/rust/pull/39372
6628 [39426]: https://github.com/rust-lang/rust/pull/39426
6629 [39431]: https://github.com/rust-lang/rust/pull/39431
6630 [39438]: https://github.com/rust-lang/rust/pull/39438
6631 [39440]: https://github.com/rust-lang/rust/pull/39440
6632 [39485]: https://github.com/rust-lang/rust/pull/39485
6633 [39491]: https://github.com/rust-lang/rust/pull/39491
6634 [39518]: https://github.com/rust-lang/rust/pull/39518
6635 [39538]: https://github.com/rust-lang/rust/pull/39538
6636 [39572]: https://github.com/rust-lang/rust/pull/39572
6637 [39633]: https://github.com/rust-lang/rust/pull/39633
6638 [39642]: https://github.com/rust-lang/rust/pull/39642
6639 [39728]: https://github.com/rust-lang/rust/pull/39728
6640 [39761]: https://github.com/rust-lang/rust/pull/39761
6641 [39788]: https://github.com/rust-lang/rust/pull/39788
6642 [39793]: https://github.com/rust-lang/rust/pull/39793
6643 [39837]: https://github.com/rust-lang/rust/pull/39837
6644 [39843]: https://github.com/rust-lang/rust/pull/39843
6645 [39851]: https://github.com/rust-lang/rust/pull/39851
6646 [39903]: https://github.com/rust-lang/rust/pull/39903
6647 [39939]: https://github.com/rust-lang/rust/pull/39939
6648 [39953]: https://github.com/rust-lang/rust/pull/39953
6649 [39960]: https://github.com/rust-lang/rust/pull/39960
6650 [39990]: https://github.com/rust-lang/rust/pull/39990
6651 [39995]: https://github.com/rust-lang/rust/pull/39995
6652 [40008]: https://github.com/rust-lang/rust/pull/40008
6653 [40009]: https://github.com/rust-lang/rust/pull/40009
6654 [40027]: https://github.com/rust-lang/rust/pull/40027
6655 [40028]: https://github.com/rust-lang/rust/pull/40028
6656 [40037]: https://github.com/rust-lang/rust/pull/40037
6657 [40117]: https://github.com/rust-lang/rust/pull/40117
6658 [40166]: https://github.com/rust-lang/rust/pull/40166
6659 [40245]: https://github.com/rust-lang/rust/pull/40245
6660 [40257]: https://github.com/rust-lang/rust/pull/40257
6661 [40261]: https://github.com/rust-lang/rust/pull/40261
6662 [40265]: https://github.com/rust-lang/rust/pull/40265
6663 [40319]: https://github.com/rust-lang/rust/pull/40319
6664 [40336]: https://github.com/rust-lang/rust/pull/40336
6665 [40526]: https://github.com/rust-lang/rust/pull/40526
6666 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6667 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6668 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6669 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6670 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6671 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6672 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6673 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6674 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6675 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6676 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6677 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6678 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6679 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6680 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6681 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6682 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6683 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6684 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6685 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6686 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6687 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6688 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6689 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6690 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6691 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6692 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6693 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6694 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6695 [ubook]: https://doc.rust-lang.org/unstable-book/
6696
6697
6698 Version 1.16.0 (2017-03-16)
6699 ===========================
6700
6701 Language
6702 --------
6703
6704 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6705 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6706   match patterns][38069]
6707 * [Clean up semantics of `self` in an import list][38313]
6708 * [`Self` may appear in `impl` headers][38920]
6709 * [`Self` may appear in struct expressions][39282]
6710
6711 Compiler
6712 --------
6713
6714 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6715   a `.rmeta` file containing only crate metadata][38571]. This can be
6716   used by tools like the Rust Language Service to perform
6717   metadata-only builds.
6718 * [Levenshtein based typo suggestions now work in most places, while
6719   previously they worked only for fields and sometimes for local
6720   variables][38927]. Together with the overhaul of "no
6721   resolution"/"unexpected resolution" errors (#[38154]) they result in
6722   large and systematic improvement in resolution diagnostics.
6723 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6724   `U`][38670]
6725 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6726 * [`rustc` no longer attempts to provide "consider using an explicit
6727   lifetime" suggestions][37057]. They were inaccurate.
6728
6729 Stabilized APIs
6730 ---------------
6731
6732 * [`VecDeque::truncate`]
6733 * [`VecDeque::resize`]
6734 * [`String::insert_str`]
6735 * [`Duration::checked_add`]
6736 * [`Duration::checked_sub`]
6737 * [`Duration::checked_div`]
6738 * [`Duration::checked_mul`]
6739 * [`str::replacen`]
6740 * [`str::repeat`]
6741 * [`SocketAddr::is_ipv4`]
6742 * [`SocketAddr::is_ipv6`]
6743 * [`IpAddr::is_ipv4`]
6744 * [`IpAddr::is_ipv6`]
6745 * [`Vec::dedup_by`]
6746 * [`Vec::dedup_by_key`]
6747 * [`Result::unwrap_or_default`]
6748 * [`<*const T>::wrapping_offset`]
6749 * [`<*mut T>::wrapping_offset`]
6750 * `CommandExt::creation_flags`
6751 * [`File::set_permissions`]
6752 * [`String::split_off`]
6753
6754 Libraries
6755 ---------
6756
6757 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6758   their argument by `Borrow` parameter][37761]
6759 * [All public types in std implement `Debug`][38006]
6760 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6761 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6762 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6763   Windows][38274]
6764 * [std: Fix partial writes in `LineWriter`][38062]
6765 * [std: Clamp max read/write sizes on Unix][38622]
6766 * [Use more specific panic message for `&str` slicing errors][38066]
6767 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6768   functionality cannot be achieved in std currently.
6769 * [`writeln!`, like `println!`, now accepts a form with no string
6770   or formatting arguments, to just print a newline][38469]
6771 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6772 * [Reduce the size of static data in `std_unicode::tables`][38781]
6773 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6774   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6775   `Display`][38909]
6776 * [`Duration` implements `Sum`][38712]
6777 * [`String` implements `ToSocketAddrs`][39048]
6778
6779 Cargo
6780 -----
6781
6782 * [The `cargo check` command does a type check of a project without
6783   building it][cargo/3296]
6784 * [crates.io will display CI badges from Travis and AppVeyor, if
6785   specified in Cargo.toml][cargo/3546]
6786 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6787 * [Compilation profiles accept integer values for `debug`, in addition
6788   to `true` and `false`. These are passed to `rustc` as the value to
6789   `-C debuginfo`][cargo/3534]
6790 * [Implement `cargo --version --verbose`][cargo/3604]
6791 * [All builds now output 'dep-info' build dependencies compatible with
6792   make and ninja][cargo/3557]
6793 * [Build all workspace members with `build --all`][cargo/3511]
6794 * [Document all workspace members with `doc --all`][cargo/3515]
6795 * [Path deps outside workspace are not members][cargo/3443]
6796
6797 Misc
6798 ----
6799
6800 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6801   the path to the Rust implementation][38589]
6802 * [The `armv7-linux-androideabi` target no longer enables NEON
6803   extensions, per Google's ABI guide][38413]
6804 * [The stock standard library can be compiled for Redox OS][38401]
6805 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6806   available.
6807 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6808   builds available.
6809 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6810
6811 Compatibility Notes
6812 -------------------
6813
6814 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6815   match patterns][38069]
6816 * In this release, references to uninhabited types can not be
6817   pattern-matched. This was accidentally allowed in 1.15.
6818 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6819 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6820   Windows][38274]
6821 * [Clean up semantics of `self` in an import list][38313]
6822 * Reimplemented lifetime elision. This change was almost entirely compatible
6823   with existing code, but it did close a number of small bugs and loopholes,
6824   as well as being more accepting in some other [cases][41105].
6825
6826 [37057]: https://github.com/rust-lang/rust/pull/37057
6827 [37761]: https://github.com/rust-lang/rust/pull/37761
6828 [38006]: https://github.com/rust-lang/rust/pull/38006
6829 [38051]: https://github.com/rust-lang/rust/pull/38051
6830 [38062]: https://github.com/rust-lang/rust/pull/38062
6831 [38622]: https://github.com/rust-lang/rust/pull/38622
6832 [38066]: https://github.com/rust-lang/rust/pull/38066
6833 [38069]: https://github.com/rust-lang/rust/pull/38069
6834 [38131]: https://github.com/rust-lang/rust/pull/38131
6835 [38154]: https://github.com/rust-lang/rust/pull/38154
6836 [38274]: https://github.com/rust-lang/rust/pull/38274
6837 [38304]: https://github.com/rust-lang/rust/pull/38304
6838 [38313]: https://github.com/rust-lang/rust/pull/38313
6839 [38327]: https://github.com/rust-lang/rust/pull/38327
6840 [38401]: https://github.com/rust-lang/rust/pull/38401
6841 [38413]: https://github.com/rust-lang/rust/pull/38413
6842 [38469]: https://github.com/rust-lang/rust/pull/38469
6843 [38559]: https://github.com/rust-lang/rust/pull/38559
6844 [38571]: https://github.com/rust-lang/rust/pull/38571
6845 [38580]: https://github.com/rust-lang/rust/pull/38580
6846 [38589]: https://github.com/rust-lang/rust/pull/38589
6847 [38670]: https://github.com/rust-lang/rust/pull/38670
6848 [38712]: https://github.com/rust-lang/rust/pull/38712
6849 [38726]: https://github.com/rust-lang/rust/pull/38726
6850 [38781]: https://github.com/rust-lang/rust/pull/38781
6851 [38798]: https://github.com/rust-lang/rust/pull/38798
6852 [38909]: https://github.com/rust-lang/rust/pull/38909
6853 [38920]: https://github.com/rust-lang/rust/pull/38920
6854 [38927]: https://github.com/rust-lang/rust/pull/38927
6855 [39048]: https://github.com/rust-lang/rust/pull/39048
6856 [39282]: https://github.com/rust-lang/rust/pull/39282
6857 [39379]: https://github.com/rust-lang/rust/pull/39379
6858 [41105]: https://github.com/rust-lang/rust/issues/41105
6859 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6860 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6861 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6862 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6863 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6864 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6865 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6866 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6867 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6868 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6869 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6870 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6871 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6872 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6873 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6874 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6875 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6876 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6877 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6878 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6879 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6880 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6881 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6882 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6883 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6884 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6885 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6886 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6887 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6888
6889
6890 Version 1.15.1 (2017-02-09)
6891 ===========================
6892
6893 * [Fix IntoIter::as_mut_slice's signature][39466]
6894 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6895
6896 [39466]: https://github.com/rust-lang/rust/pull/39466
6897 [39523]: https://github.com/rust-lang/rust/pull/39523
6898
6899
6900 Version 1.15.0 (2017-02-02)
6901 ===========================
6902
6903 Language
6904 --------
6905
6906 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6907   stable. This allows popular code-generating crates like Serde and Diesel to
6908   work ergonomically. [RFC 1681].
6909 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6910   with curly braces][36868]. Part of [RFC 1506].
6911 * [A number of minor changes to name resolution have been activated][37127].
6912   They add up to more consistent semantics, allowing for future evolution of
6913   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6914   details of what is different. The breaking changes here have been transitioned
6915   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6916 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6917   bounds][38279]
6918 * [`?Sized` can be used in `where` clauses][37791]
6919 * [There is now a limit on the size of monomorphized types and it can be
6920   modified with the `#![type_size_limit]` crate attribute, similarly to
6921   the `#![recursion_limit]` attribute][37789]
6922
6923 Compiler
6924 --------
6925
6926 * [On Windows, the compiler will apply dllimport attributes when linking to
6927   extern functions][37973]. Additional attributes and flags can control which
6928   library kind is linked and its name. [RFC 1717].
6929 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6930 * [The `--test` flag works with procedural macro crates][38107]
6931 * [Fix `extern "aapcs" fn` ABI][37814]
6932 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6933 * [The `format!` expander recognizes incorrect `printf` and shell-style
6934   formatting directives and suggests the correct format][37613].
6935 * [Only report one error for all unused imports in an import list][37456]
6936
6937 Compiler Performance
6938 --------------------
6939
6940 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6941 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6942 * [Don't clone in `UnificationTable::probe`][37848]
6943 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6944 * [Use small vectors in type walker][37760]
6945 * [Macro expansion performance was improved][37701]
6946 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6947 * [Replace FNV with a faster hash function][37229]
6948
6949 Stabilized APIs
6950 ---------------
6951
6952 * [`std::iter::Iterator::min_by`]
6953 * [`std::iter::Iterator::max_by`]
6954 * [`std::os::*::fs::FileExt`]
6955 * [`std::sync::atomic::Atomic*::get_mut`]
6956 * [`std::sync::atomic::Atomic*::into_inner`]
6957 * [`std::vec::IntoIter::as_slice`]
6958 * [`std::vec::IntoIter::as_mut_slice`]
6959 * [`std::sync::mpsc::Receiver::try_iter`]
6960 * [`std::os::unix::process::CommandExt::before_exec`]
6961 * [`std::rc::Rc::strong_count`]
6962 * [`std::rc::Rc::weak_count`]
6963 * [`std::sync::Arc::strong_count`]
6964 * [`std::sync::Arc::weak_count`]
6965 * [`std::char::encode_utf8`]
6966 * [`std::char::encode_utf16`]
6967 * [`std::cell::Ref::clone`]
6968 * [`std::io::Take::into_inner`]
6969
6970 Libraries
6971 ---------
6972
6973 * [The standard sorting algorithm has been rewritten for dramatic performance
6974   improvements][38192]. It is a hybrid merge sort, drawing influences from
6975   Timsort. Previously it was a naive merge sort.
6976 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6977 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6978   performance.
6979 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6980   and `char_indices().last()`][37882]
6981 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6982 * [Chinese characters display correctly in `fmt::Debug`][37855]
6983 * [Derive `Default` for `Duration`][37699]
6984 * [Support creation of anonymous pipes on WinXP/2k][37677]
6985 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6986 * [Don't pass overlapped handles to processes][38835]
6987
6988 Cargo
6989 -----
6990
6991 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6992   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6993   should instead check the variable at runtime with `std::env`. That the value
6994   was set at build time was a bug, and incorrect when cross-compiling. This
6995   change is known to cause breakage.
6996 * [Add `--all` flag to `cargo test`][cargo/3221]
6997 * [Compile statically against the MSVC CRT][cargo/3363]
6998 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6999 * [Link OpenSSL statically on OSX][cargo/3311]
7000 * [Apply new fingerprinting to build dir outputs][cargo/3310]
7001 * [Test for bad path overrides with summaries][cargo/3336]
7002 * [Require `cargo install --vers` to take a semver version][cargo/3338]
7003 * [Fix retrying crate downloads for network errors][cargo/3348]
7004 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
7005 * [Emit more info on --message-format=json][cargo/3319]
7006 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
7007 * [Don't ignore errors in workspace manifest][cargo/3409]
7008 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
7009
7010 Tooling
7011 -------
7012
7013 * [Test runners (binaries built with `--test`) now support a `--list` argument
7014   that lists the tests it contains][38185]
7015 * [Test runners now support a `--exact` argument that makes the test filter
7016   match exactly, instead of matching only a substring of the test name][38181]
7017 * [rustdoc supports a `--playground-url` flag][37763]
7018 * [rustdoc provides more details about `#[should_panic]` errors][37749]
7019
7020 Misc
7021 ----
7022
7023 * [The Rust build system is now written in Rust][37817]. The Makefiles may
7024   continue to be used in this release by passing `--disable-rustbuild` to the
7025   configure script, but they will be deleted soon. Note that the new build
7026   system uses a different on-disk layout that will likely affect any scripts
7027   building Rust.
7028 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
7029   releases.
7030 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
7031 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
7032   releases.
7033
7034 Compatibility Notes
7035 -------------------
7036
7037 * [A number of minor changes to name resolution have been activated][37127].
7038   They add up to more consistent semantics, allowing for future evolution of
7039   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
7040   details of what is different. The breaking changes here have been transitioned
7041   through the [`legacy_imports`] lint since 1.14, with no known regressions.
7042 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
7043   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
7044   should instead check the variable at runtime with `std::env`. That the value
7045   was set at build time was a bug, and incorrect when cross-compiling. This
7046   change is known to cause breakage.
7047 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
7048   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
7049   1.10 and is now an error by default. It will become a hard error in the near
7050   future.
7051 * [The semantics relating modules to file system directories are changing in
7052   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
7053   lint, which is a warning in this release, and will become a hard error in the
7054   future.
7055 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
7056 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
7057   the underlying iterator][37834]
7058
7059 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
7060 [33685]: https://github.com/rust-lang/rust/issues/33685
7061 [36868]: https://github.com/rust-lang/rust/pull/36868
7062 [37127]: https://github.com/rust-lang/rust/pull/37127
7063 [37229]: https://github.com/rust-lang/rust/pull/37229
7064 [37456]: https://github.com/rust-lang/rust/pull/37456
7065 [37527]: https://github.com/rust-lang/rust/pull/37527
7066 [37602]: https://github.com/rust-lang/rust/pull/37602
7067 [37613]: https://github.com/rust-lang/rust/pull/37613
7068 [37615]: https://github.com/rust-lang/rust/pull/37615
7069 [37636]: https://github.com/rust-lang/rust/pull/37636
7070 [37627]: https://github.com/rust-lang/rust/pull/37627
7071 [37642]: https://github.com/rust-lang/rust/pull/37642
7072 [37677]: https://github.com/rust-lang/rust/pull/37677
7073 [37699]: https://github.com/rust-lang/rust/pull/37699
7074 [37701]: https://github.com/rust-lang/rust/pull/37701
7075 [37705]: https://github.com/rust-lang/rust/pull/37705
7076 [37749]: https://github.com/rust-lang/rust/pull/37749
7077 [37760]: https://github.com/rust-lang/rust/pull/37760
7078 [37763]: https://github.com/rust-lang/rust/pull/37763
7079 [37764]: https://github.com/rust-lang/rust/pull/37764
7080 [37789]: https://github.com/rust-lang/rust/pull/37789
7081 [37791]: https://github.com/rust-lang/rust/pull/37791
7082 [37814]: https://github.com/rust-lang/rust/pull/37814
7083 [37817]: https://github.com/rust-lang/rust/pull/37817
7084 [37834]: https://github.com/rust-lang/rust/pull/37834
7085 [37848]: https://github.com/rust-lang/rust/pull/37848
7086 [37855]: https://github.com/rust-lang/rust/pull/37855
7087 [37882]: https://github.com/rust-lang/rust/pull/37882
7088 [37888]: https://github.com/rust-lang/rust/pull/37888
7089 [37973]: https://github.com/rust-lang/rust/pull/37973
7090 [37979]: https://github.com/rust-lang/rust/pull/37979
7091 [38086]: https://github.com/rust-lang/rust/pull/38086
7092 [38107]: https://github.com/rust-lang/rust/pull/38107
7093 [38117]: https://github.com/rust-lang/rust/pull/38117
7094 [38134]: https://github.com/rust-lang/rust/pull/38134
7095 [38146]: https://github.com/rust-lang/rust/pull/38146
7096 [38181]: https://github.com/rust-lang/rust/pull/38181
7097 [38182]: https://github.com/rust-lang/rust/pull/38182
7098 [38185]: https://github.com/rust-lang/rust/pull/38185
7099 [38192]: https://github.com/rust-lang/rust/pull/38192
7100 [38279]: https://github.com/rust-lang/rust/pull/38279
7101 [38835]: https://github.com/rust-lang/rust/pull/38835
7102 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7103 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
7104 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
7105 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
7106 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
7107 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
7108 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
7109 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
7110 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
7111 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
7112 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
7113 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
7114 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
7115 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
7116 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
7117 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
7118 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
7119 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
7120 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
7121 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
7122 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
7123 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
7124 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
7125 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
7126 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
7127 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
7128 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
7129 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
7130 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
7131 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
7132 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
7133 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
7134 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
7135 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
7136 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
7137 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
7138 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
7139
7140
7141 Version 1.14.0 (2016-12-22)
7142 ===========================
7143
7144 Language
7145 --------
7146
7147 * [`..` matches multiple tuple fields in enum variants, structs
7148   and tuples][36843]. [RFC 1492].
7149 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
7150 * [`use *` and `use ::*` both glob-import from the crate root][37367]
7151 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
7152   dereferencing][36822]
7153
7154 Compiler
7155 --------
7156
7157 * [Mark enums with non-zero discriminant as non-zero][37224]
7158 * [Lower-case `static mut` names are linted like other
7159   statics and consts][37162]
7160 * [Fix ICE on some macros in const integer positions
7161    (e.g. `[u8; m!()]`)][36819]
7162 * [Improve error message and snippet for "did you mean `x`"][36798]
7163 * [Add a panic-strategy field to the target specification][36794]
7164 * [Include LLVM version in `--version --verbose`][37200]
7165
7166 Compile-time Optimizations
7167 --------------------------
7168
7169 * [Improve macro expansion performance][37569]
7170 * [Shrink `Expr_::ExprInlineAsm`][37445]
7171 * [Replace all uses of SHA-256 with BLAKE2b][37439]
7172 * [Reduce the number of bytes hashed by `IchHasher`][37427]
7173 * [Avoid more allocations when compiling html5ever][37373]
7174 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
7175 * [Avoid some allocations in the macro parser][37318]
7176 * [Use a faster deflate setting][37298]
7177 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
7178   during interning of slices][37270]
7179 * [Optimize `write_metadata`][37267]
7180 * [Don't process obligation forest cycles when stalled][37231]
7181 * [Avoid many `CrateConfig` clones][37161]
7182 * [Optimize `Substs::super_fold_with`][37108]
7183 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
7184 * [Speed up `plug_leaks`][36917]
7185
7186 Libraries
7187 ---------
7188
7189 * [`println!()`, with no arguments, prints newline][36825].
7190   Previously, an empty string was required to achieve the same.
7191 * [`Wrapping` impls standard binary and unary operators, as well as
7192    the `Sum` and `Product` iterators][37356]
7193 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
7194   Vec<T>`][37326]
7195 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
7196   `VecDeque` iterators][37315]
7197 * [Improve `SipHasher` performance on small values][37312]
7198 * [Add Iterator trait TrustedLen to enable better FromIterator /
7199   Extend][37306]
7200 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
7201 * [`ReadDir` implements `Debug`][37221]
7202 * [Implement `RefUnwindSafe` for atomic types][37178]
7203 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
7204 * [Avoid allocations in `Decoder::read_str`][37064]
7205 * [`io::Error` implements `From<io::ErrorKind>`][37037]
7206 * [Impl `Debug` for raw pointers to unsized data][36880]
7207 * [Don't reuse `HashMap` random seeds][37470]
7208 * [The internal memory layout of `HashMap` is more cache-friendly, for
7209   significant improvements in some operations][36692]
7210 * [`HashMap` uses less memory on 32-bit architectures][36595]
7211 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
7212
7213 Cargo
7214 -----
7215
7216 * [Expose rustc cfg values to build scripts][cargo/3243]
7217 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
7218 * [Fix passing --features when testing multiple packages][cargo/3280]
7219 * [Use a single profile set per workspace][cargo/3249]
7220 * [Load `replace` sections from lock files][cargo/3220]
7221 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
7222
7223 Tooling
7224 -------
7225
7226 * [rustup is the recommended Rust installation method][1.14rustup]
7227 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
7228   S390x. These are [tier 2] platforms and may have major defects. Follow the
7229   instructions on the website to install, or add the targets to an existing
7230   installation with `rustup target add`. The new target triples are:
7231   - `mips-unknown-linux-gnu`
7232   - `mipsel-unknown-linux-gnu`
7233   - `mips64-unknown-linux-gnuabi64`
7234   - `mips64el-unknown-linux-gnuabi64 `
7235   - `powerpc-unknown-linux-gnu`
7236   - `powerpc64-unknown-linux-gnu`
7237   - `powerpc64le-unknown-linux-gnu`
7238   - `s390x-unknown-linux-gnu `
7239 * This release includes target (std) builds for ARM Linux running MUSL
7240   libc. These are [tier 2] platforms and may have major defects. Add the
7241   following triples to an existing rustup installation with `rustup target add`:
7242   - `arm-unknown-linux-musleabi`
7243   - `arm-unknown-linux-musleabihf`
7244   - `armv7-unknown-linux-musleabihf`
7245 * This release includes [experimental support for WebAssembly][1.14wasm], via
7246   the `wasm32-unknown-emscripten` target. This target is known to have major
7247   defects. Please test, report, and fix.
7248 * rustup no longer installs documentation by default. Run `rustup
7249   component add rust-docs` to install.
7250 * [Fix line stepping in debugger][37310]
7251 * [Enable line number debuginfo in releases][37280]
7252
7253 Misc
7254 ----
7255
7256 * [Disable jemalloc on aarch64/powerpc/mips][37392]
7257 * [Add support for Fuchsia OS][37313]
7258 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
7259
7260 Compatibility Notes
7261 -------------------
7262
7263 * [A number of forward-compatibility lints used by the compiler
7264   to gradually introduce language changes have been converted
7265   to deny by default][36894]:
7266   - ["use of inaccessible extern crate erroneously allowed"][36886]
7267   - ["type parameter default erroneously allowed in invalid location"][36887]
7268   - ["detects super or self keywords at the beginning of global path"][36888]
7269   - ["two overlapping inherent impls define an item with the same name
7270     were erroneously allowed"][36889]
7271   - ["floating-point constants cannot be used in patterns"][36890]
7272   - ["constants of struct or enum type can only be used in a pattern if
7273      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
7274   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
7275 * [Prohibit patterns in trait methods without bodies][37378]
7276 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
7277 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
7278 * [The `$crate` macro variable is accepted in fewer locations][37213]
7279 * [Impls specifying extra region requirements beyond the trait
7280   they implement are rejected][37167]
7281 * [Enums may not be unsized][37111]. Unsized enums are intended to
7282   work but never have. For now they are forbidden.
7283 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
7284
7285 [tier 2]: https://forge.rust-lang.org/platform-support.html
7286 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
7287 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
7288 [36430]: https://github.com/rust-lang/rust/pull/36430
7289 [36595]: https://github.com/rust-lang/rust/pull/36595
7290 [36692]: https://github.com/rust-lang/rust/pull/36692
7291 [36767]: https://github.com/rust-lang/rust/pull/36767
7292 [36794]: https://github.com/rust-lang/rust/pull/36794
7293 [36798]: https://github.com/rust-lang/rust/pull/36798
7294 [36819]: https://github.com/rust-lang/rust/pull/36819
7295 [36822]: https://github.com/rust-lang/rust/pull/36822
7296 [36825]: https://github.com/rust-lang/rust/pull/36825
7297 [36843]: https://github.com/rust-lang/rust/pull/36843
7298 [36880]: https://github.com/rust-lang/rust/pull/36880
7299 [36886]: https://github.com/rust-lang/rust/issues/36886
7300 [36887]: https://github.com/rust-lang/rust/issues/36887
7301 [36888]: https://github.com/rust-lang/rust/issues/36888
7302 [36889]: https://github.com/rust-lang/rust/issues/36889
7303 [36890]: https://github.com/rust-lang/rust/issues/36890
7304 [36891]: https://github.com/rust-lang/rust/issues/36891
7305 [36892]: https://github.com/rust-lang/rust/issues/36892
7306 [36894]: https://github.com/rust-lang/rust/pull/36894
7307 [36917]: https://github.com/rust-lang/rust/pull/36917
7308 [36993]: https://github.com/rust-lang/rust/pull/36993
7309 [37037]: https://github.com/rust-lang/rust/pull/37037
7310 [37064]: https://github.com/rust-lang/rust/pull/37064
7311 [37094]: https://github.com/rust-lang/rust/pull/37094
7312 [37108]: https://github.com/rust-lang/rust/pull/37108
7313 [37111]: https://github.com/rust-lang/rust/pull/37111
7314 [37161]: https://github.com/rust-lang/rust/pull/37161
7315 [37162]: https://github.com/rust-lang/rust/pull/37162
7316 [37167]: https://github.com/rust-lang/rust/pull/37167
7317 [37178]: https://github.com/rust-lang/rust/pull/37178
7318 [37200]: https://github.com/rust-lang/rust/pull/37200
7319 [37213]: https://github.com/rust-lang/rust/pull/37213
7320 [37221]: https://github.com/rust-lang/rust/pull/37221
7321 [37224]: https://github.com/rust-lang/rust/pull/37224
7322 [37230]: https://github.com/rust-lang/rust/pull/37230
7323 [37231]: https://github.com/rust-lang/rust/pull/37231
7324 [37247]: https://github.com/rust-lang/rust/pull/37247
7325 [37267]: https://github.com/rust-lang/rust/pull/37267
7326 [37270]: https://github.com/rust-lang/rust/pull/37270
7327 [37273]: https://github.com/rust-lang/rust/pull/37273
7328 [37280]: https://github.com/rust-lang/rust/pull/37280
7329 [37298]: https://github.com/rust-lang/rust/pull/37298
7330 [37306]: https://github.com/rust-lang/rust/pull/37306
7331 [37310]: https://github.com/rust-lang/rust/pull/37310
7332 [37312]: https://github.com/rust-lang/rust/pull/37312
7333 [37313]: https://github.com/rust-lang/rust/pull/37313
7334 [37315]: https://github.com/rust-lang/rust/pull/37315
7335 [37318]: https://github.com/rust-lang/rust/pull/37318
7336 [37322]: https://github.com/rust-lang/rust/pull/37322
7337 [37326]: https://github.com/rust-lang/rust/pull/37326
7338 [37351]: https://github.com/rust-lang/rust/pull/37351
7339 [37356]: https://github.com/rust-lang/rust/pull/37356
7340 [37367]: https://github.com/rust-lang/rust/pull/37367
7341 [37373]: https://github.com/rust-lang/rust/pull/37373
7342 [37378]: https://github.com/rust-lang/rust/pull/37378
7343 [37389]: https://github.com/rust-lang/rust/pull/37389
7344 [37392]: https://github.com/rust-lang/rust/pull/37392
7345 [37427]: https://github.com/rust-lang/rust/pull/37427
7346 [37439]: https://github.com/rust-lang/rust/pull/37439
7347 [37445]: https://github.com/rust-lang/rust/pull/37445
7348 [37470]: https://github.com/rust-lang/rust/pull/37470
7349 [37569]: https://github.com/rust-lang/rust/pull/37569
7350 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
7351 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
7352 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
7353 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
7354 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
7355 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
7356 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
7357
7358
7359 Version 1.13.0 (2016-11-10)
7360 ===========================
7361
7362 Language
7363 --------
7364
7365 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
7366   errors, like the `try!` macro, described in [RFC 0243].
7367 * [Stabilize macros in type position][36014]. Described in [RFC 873].
7368 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
7369 * [Fix `#[derive]` for empty tuple structs/variants][35728]
7370 * [Fix lifetime rules for 'if' conditions][36029]
7371 * [Avoid loading and parsing unconfigured non-inline modules][36482]
7372
7373 Compiler
7374 --------
7375
7376 * [Add the `-C link-arg` argument][36574]
7377 * [Remove the old AST-based backend from rustc_trans][35764]
7378 * [Don't enable NEON by default on armv7 Linux][35814]
7379 * [Fix debug line number info for macro expansions][35238]
7380 * [Do not emit "class method" debuginfo for types that are not
7381   DICompositeType][36008]
7382 * [Warn about multiple conflicting #[repr] hints][34623]
7383 * [When sizing DST, don't double-count nested struct prefixes][36351]
7384 * [Default RUST_MIN_STACK to 16MiB for now][36505]
7385 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
7386 * [Reject macros with empty repetitions to avoid infinite loop][36721]
7387 * [Expand macros without recursing to avoid stack overflows][36214]
7388
7389 Diagnostics
7390 -----------
7391
7392 * [Replace macro backtraces with labeled local uses][35702]
7393 * [Improve error message for misplaced doc comments][33922]
7394 * [Buffer unix and lock windows to prevent message interleaving][35975]
7395 * [Update lifetime errors to specifically note temporaries][36171]
7396 * [Special case a few colors for Windows][36178]
7397 * [Suggest `use self` when such an import resolves][36289]
7398 * [Be more specific when type parameter shadows primitive type][36338]
7399 * Many minor improvements
7400
7401 Compile-time Optimizations
7402 --------------------------
7403
7404 * [Compute and cache HIR hashes at beginning][35854]
7405 * [Don't hash types in loan paths][36004]
7406 * [Cache projections in trans][35761]
7407 * [Optimize the parser's last token handling][36527]
7408 * [Only instantiate #[inline] functions in codegen units referencing
7409   them][36524]. This leads to big improvements in cases where crates export
7410   define many inline functions without using them directly.
7411 * [Lazily allocate TypedArena's first chunk][36592]
7412 * [Don't allocate during default HashSet creation][36734]
7413
7414 Stabilized APIs
7415 ---------------
7416
7417 * [`checked_abs`]
7418 * [`wrapping_abs`]
7419 * [`overflowing_abs`]
7420 * [`RefCell::try_borrow`]
7421 * [`RefCell::try_borrow_mut`]
7422
7423 Libraries
7424 ---------
7425
7426 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
7427 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
7428   covariant][35354]
7429 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
7430 * [Implement `Debug` for `std::vec::IntoIter`][35707]
7431 * [`CString`: avoid excessive growth just to 0-terminate][35871]
7432 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
7433 * [Use arc4rand on FreeBSD][35884]
7434 * [memrchr: Correct aligned offset computation][35969]
7435 * [Improve Demangling of Rust Symbols][36059]
7436 * [Use monotonic time in condition variables][35048]
7437 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
7438 * [Implement conversion traits for `char`][35755]
7439 * [Fix illegal instruction caused by overflow in channel cloning][36104]
7440 * [Zero first byte of CString on drop][36264]
7441 * [Inherit overflow checks for sum and product][36372]
7442 * [Add missing Eq implementations][36423]
7443 * [Implement `Debug` for `DirEntry`][36631]
7444 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
7445   `errno`][36754]
7446 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7447 * [Implement more traits for `std::io::ErrorKind`][35911]
7448 * [Optimize BinaryHeap bounds checking][36072]
7449 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
7450   `extend_with_element`][36355]
7451 * [Fix overflow checking in unsigned pow()][34942]
7452
7453 Cargo
7454 -----
7455
7456 * This release includes security fixes to both curl and OpenSSL.
7457 * [Fix transitive doctests when panic=abort][cargo/3021]
7458 * [Add --all-features flag to cargo][cargo/3038]
7459 * [Reject path-based dependencies in `cargo package`][cargo/3060]
7460 * [Don't parse the home directory more than once][cargo/3078]
7461 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
7462 * [Update OpenSSL to 1.0.2j][cargo/3121]
7463 * [Add license and license_file to cargo metadata output][cargo/3110]
7464 * [Make crates-io registry URL optional in config; ignore all changes to
7465   source.crates-io][cargo/3089]
7466 * [Don't download dependencies from other platforms][cargo/3123]
7467 * [Build transitive dev-dependencies when needed][cargo/3125]
7468 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
7469 * [Avoid updating registry when adding existing deps][cargo/3144]
7470 * [Warn about path overrides that won't work][cargo/3136]
7471 * [Use workspaces during `cargo install`][cargo/3146]
7472 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
7473 * [Add --message-format flag][cargo/3000]
7474 * [Pass target environment for rustdoc][cargo/3205]
7475 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
7476 * [Update curl and curl-sys][cargo/3241]
7477 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
7478
7479 Tooling
7480 -------
7481
7482 * [rustdoc: Add the `--sysroot` argument][36586]
7483 * [rustdoc: Fix a couple of issues with the search results][35655]
7484 * [rustdoc: remove the `!` from macro URLs and titles][35234]
7485 * [gdb: Fix pretty-printing special-cased Rust types][35585]
7486 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
7487
7488 Misc
7489 ----
7490
7491 * [Remove unmaintained style guide][35124]
7492 * [Add s390x support][36369]
7493 * [Initial work at Haiku OS support][36727]
7494 * [Add mips-uclibc targets][35734]
7495 * [Crate-ify compiler-rt into compiler-builtins][35021]
7496 * [Add rustc version info (git hash + date) to dist tarball][36213]
7497 * Many documentation improvements
7498
7499 Compatibility Notes
7500 -------------------
7501
7502 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7503 * [Deny (by default) transmuting from fn item types to pointer-sized
7504   types][34923]. Continuing the long transition to zero-sized fn items,
7505   per [RFC 401].
7506 * [Fix `#[derive]` for empty tuple structs/variants][35728].
7507   Part of [RFC 1506].
7508 * [Issue deprecation warnings for safe accesses to extern statics][36173]
7509 * [Fix lifetime rules for 'if' conditions][36029].
7510 * [Inherit overflow checks for sum and product][36372].
7511 * [Forbid user-defined macros named "macro_rules"][36730].
7512
7513 [33922]: https://github.com/rust-lang/rust/pull/33922
7514 [34623]: https://github.com/rust-lang/rust/pull/34623
7515 [34923]: https://github.com/rust-lang/rust/pull/34923
7516 [34942]: https://github.com/rust-lang/rust/pull/34942
7517 [35021]: https://github.com/rust-lang/rust/pull/35021
7518 [35048]: https://github.com/rust-lang/rust/pull/35048
7519 [35074]: https://github.com/rust-lang/rust/pull/35074
7520 [35124]: https://github.com/rust-lang/rust/pull/35124
7521 [35234]: https://github.com/rust-lang/rust/pull/35234
7522 [35238]: https://github.com/rust-lang/rust/pull/35238
7523 [35354]: https://github.com/rust-lang/rust/pull/35354
7524 [35559]: https://github.com/rust-lang/rust/pull/35559
7525 [35585]: https://github.com/rust-lang/rust/pull/35585
7526 [35627]: https://github.com/rust-lang/rust/pull/35627
7527 [35655]: https://github.com/rust-lang/rust/pull/35655
7528 [35702]: https://github.com/rust-lang/rust/pull/35702
7529 [35707]: https://github.com/rust-lang/rust/pull/35707
7530 [35728]: https://github.com/rust-lang/rust/pull/35728
7531 [35734]: https://github.com/rust-lang/rust/pull/35734
7532 [35755]: https://github.com/rust-lang/rust/pull/35755
7533 [35761]: https://github.com/rust-lang/rust/pull/35761
7534 [35764]: https://github.com/rust-lang/rust/pull/35764
7535 [35814]: https://github.com/rust-lang/rust/pull/35814
7536 [35854]: https://github.com/rust-lang/rust/pull/35854
7537 [35871]: https://github.com/rust-lang/rust/pull/35871
7538 [35884]: https://github.com/rust-lang/rust/pull/35884
7539 [35911]: https://github.com/rust-lang/rust/pull/35911
7540 [35969]: https://github.com/rust-lang/rust/pull/35969
7541 [35975]: https://github.com/rust-lang/rust/pull/35975
7542 [36004]: https://github.com/rust-lang/rust/pull/36004
7543 [36008]: https://github.com/rust-lang/rust/pull/36008
7544 [36014]: https://github.com/rust-lang/rust/pull/36014
7545 [36029]: https://github.com/rust-lang/rust/pull/36029
7546 [36059]: https://github.com/rust-lang/rust/pull/36059
7547 [36072]: https://github.com/rust-lang/rust/pull/36072
7548 [36101]: https://github.com/rust-lang/rust/pull/36101
7549 [36104]: https://github.com/rust-lang/rust/pull/36104
7550 [36171]: https://github.com/rust-lang/rust/pull/36171
7551 [36173]: https://github.com/rust-lang/rust/pull/36173
7552 [36178]: https://github.com/rust-lang/rust/pull/36178
7553 [36213]: https://github.com/rust-lang/rust/pull/36213
7554 [36214]: https://github.com/rust-lang/rust/pull/36214
7555 [36264]: https://github.com/rust-lang/rust/pull/36264
7556 [36266]: https://github.com/rust-lang/rust/pull/36266
7557 [36289]: https://github.com/rust-lang/rust/pull/36289
7558 [36338]: https://github.com/rust-lang/rust/pull/36338
7559 [36351]: https://github.com/rust-lang/rust/pull/36351
7560 [36355]: https://github.com/rust-lang/rust/pull/36355
7561 [36369]: https://github.com/rust-lang/rust/pull/36369
7562 [36372]: https://github.com/rust-lang/rust/pull/36372
7563 [36423]: https://github.com/rust-lang/rust/pull/36423
7564 [36482]: https://github.com/rust-lang/rust/pull/36482
7565 [36505]: https://github.com/rust-lang/rust/pull/36505
7566 [36524]: https://github.com/rust-lang/rust/pull/36524
7567 [36527]: https://github.com/rust-lang/rust/pull/36527
7568 [36551]: https://github.com/rust-lang/rust/pull/36551
7569 [36574]: https://github.com/rust-lang/rust/pull/36574
7570 [36586]: https://github.com/rust-lang/rust/pull/36586
7571 [36592]: https://github.com/rust-lang/rust/pull/36592
7572 [36631]: https://github.com/rust-lang/rust/pull/36631
7573 [36721]: https://github.com/rust-lang/rust/pull/36721
7574 [36727]: https://github.com/rust-lang/rust/pull/36727
7575 [36730]: https://github.com/rust-lang/rust/pull/36730
7576 [36734]: https://github.com/rust-lang/rust/pull/36734
7577 [36754]: https://github.com/rust-lang/rust/pull/36754
7578 [36995]: https://github.com/rust-lang/rust/pull/36995
7579 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
7580 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
7581 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7582 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
7583 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
7584 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
7585 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
7586 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
7587 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7588 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7589 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7590 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7591 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7592 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7593 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7594 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7595 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7596 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7597 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7598 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7599 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7600 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7601 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7602 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7603 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7604 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7605 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7606 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7607 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7608 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7609 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7610 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7611
7612
7613 Version 1.12.1 (2016-10-20)
7614 ===========================
7615
7616 Regression Fixes
7617 ----------------
7618
7619 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7620 * [Confusion with double negation and booleans][36856]
7621 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7622 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7623 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7624 * [Corrupted memory after updated to 1.12][36936]
7625 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7626 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7627 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7628
7629 [36381]: https://github.com/rust-lang/rust/issues/36381
7630 [36856]: https://github.com/rust-lang/rust/issues/36856
7631 [36875]: https://github.com/rust-lang/rust/issues/36875
7632 [36924]: https://github.com/rust-lang/rust/issues/36924
7633 [36926]: https://github.com/rust-lang/rust/issues/36926
7634 [36936]: https://github.com/rust-lang/rust/issues/36936
7635 [37026]: https://github.com/rust-lang/rust/issues/37026
7636 [37112]: https://github.com/rust-lang/rust/issues/37112
7637 [37153]: https://github.com/rust-lang/rust/issues/37153
7638
7639
7640 Version 1.12.0 (2016-09-29)
7641 ===========================
7642
7643 Highlights
7644 ----------
7645
7646 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7647   This translation pass is far simpler than the previous AST->LLVM pass, and
7648   creates opportunities to perform new optimizations directly on the MIR. It
7649   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7650 * [`rustc` presents a new, more readable error format, along with
7651   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7652   Most common editors supporting Rust have been updated to work with it. It was
7653   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7654
7655 Compiler
7656 --------
7657
7658 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7659   This translation pass is far simpler than the previous AST->LLVM pass, and
7660   creates opportunities to perform new optimizations directly on the MIR. It
7661   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7662 * [Print the Rust target name, not the LLVM target name, with
7663   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7664 * [The computation of `TypeId` is correct in some cases where it was previously
7665   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7666 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7667 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7668   `--print relocation-models`, and `--print code-models` print the available
7669   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7670   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7671 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7672   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7673   These targets produce statically-linked binaries. There are no binary release
7674   builds yet though.
7675
7676 Diagnostics
7677 -----------
7678
7679 * [`rustc` presents a new, more readable error format, along with
7680   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7681   Most common editors supporting Rust have been updated to work with it. It was
7682   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7683 * [In error descriptions, references are now described in plain English,
7684   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7685 * [In error type descriptions, unknown numeric types are named `{integer}` or
7686   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7687 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7688
7689 Language
7690 --------
7691
7692 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7693 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7694 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7695   useful](https://github.com/rust-lang/rust/pull/34908)
7696 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7697   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7698 * [Semicolons are properly required as statement delimiters inside
7699   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7700 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7701
7702 Stabilized APIs
7703 ---------------
7704
7705 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7706 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7707 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7708 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7709 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7710 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7711 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7712 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7713 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7714 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7715   Both on Unix and Windows.
7716 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7717 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7718 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7719 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7720 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7721 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7722 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7723 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7724
7725 Libraries
7726 ---------
7727
7728 * [The `format!` macro and friends now allow a single argument to be formatted
7729   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7730 * [The lifetime bounds on `[T]::binary_search_by` and
7731   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7732 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7733 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7734 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7735 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7736 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7737 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7738 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7739 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7740   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7741 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7742   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7743 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7744 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7745   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7746 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7747 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7748 * [`mpsc::sync_channel` `Receiver`s return any available message before
7749   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7750 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7751 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7752
7753 Cargo
7754 -----
7755
7756 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7757 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7758 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7759 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7760 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7761 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7762 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7763 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7764 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7765 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7766 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7767 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7768 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7769 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7770 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7771 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7772
7773 Performance
7774 -----------
7775
7776 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7777 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7778
7779 Tooling
7780 -------
7781
7782 * [Test binaries now support a `--test-threads` argument to specify the number
7783   of threads used to run tests, and which acts the same as the
7784   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7785 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7786 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7787 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7788 * [Rust releases now come with source packages that can be installed by rustup
7789   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7790   The resulting source code can be used by tools and IDES, located in the
7791   sysroot under `lib/rustlib/src`.
7792
7793 Misc
7794 ----
7795
7796 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7797 * Many minor improvements to the documentation.
7798 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7799
7800 Compatibility Notes
7801 -------------------
7802
7803 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7804   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7805 * [When formatting strings, if "precision" is specified, the "fill",
7806   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7807 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7808
7809
7810 Version 1.11.0 (2016-08-18)
7811 ===========================
7812
7813 Language
7814 --------
7815
7816 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7817 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7818 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7819 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7820
7821 Stabilized APIs
7822 ---------------
7823
7824 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7825 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7826 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7827 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7828 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7829 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7830   (in libcore - previously stabilized in libstd)
7831 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7832   (in libcore - previously stabilized in libstd)
7833 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7834   (in libcore - previously stabilized in libstd)
7835 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7836   (in libcore - previously stabilized in libstd)
7837 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7838 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7839 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7840 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7841
7842 Libraries
7843 ---------
7844
7845 * [The `thread_local!` macro supports multiple definitions in a single
7846    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7847 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7848 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7849   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7850 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7851 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7852 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7853 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7854
7855 Cargo
7856 -----
7857
7858 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7859 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7860 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7861 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7862 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7863   and `-vv` prints warnings for all crates.
7864 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7865 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7866   This provides room for expansion by arbitrary tools.
7867 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7868 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7869 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7870 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7871 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7872 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7873 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7874
7875 Performance
7876 -----------
7877
7878 * [Caching projections speeds up type check dramatically for some
7879   workloads](https://github.com/rust-lang/rust/pull/33816)
7880 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7881   This hasher is faster, but is believed to provide sufficient
7882   protection from collision attacks.
7883 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7884
7885 Rustdoc
7886 -------
7887
7888 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7889 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7890 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7891 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7892 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7893
7894 Tooling
7895 -------
7896
7897 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7898 * [When emitting debug info, rustc emits frame pointers for closures,
7899   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7900 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7901 * Many more errors have been given error codes and extended
7902   explanations
7903 * API documentation continues to be improved, with many new examples
7904
7905 Misc
7906 ----
7907
7908 * [rustc no longer hangs when dependencies recursively re-export
7909   submodules](https://github.com/rust-lang/rust/pull/34542)
7910 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7911 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7912   rewritten](https://github.com/rust-lang/rust/pull/33895)
7913 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7914   No targets use this yet, but it works toward AVR support.
7915
7916 Compatibility Notes
7917 -------------------
7918
7919 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7920 * [The new follow-set rules that place restrictions on `macro_rules!`
7921   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7922   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7923   and has been a warning since 1.10.
7924 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7925   This causes breakage in some corner cases.
7926
7927
7928 Version 1.10.0 (2016-07-07)
7929 ===========================
7930
7931 Language
7932 --------
7933
7934 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7935   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7936 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7937 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7938 * [`panic!` can be converted to a runtime abort with the
7939   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7940   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7941 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7942   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7943   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7944   Note that Cargo does not yet directly support cdylibs.
7945
7946 Stabilized APIs
7947 ---------------
7948
7949 * `os::windows::fs::OpenOptionsExt::access_mode`
7950 * `os::windows::fs::OpenOptionsExt::share_mode`
7951 * `os::windows::fs::OpenOptionsExt::custom_flags`
7952 * `os::windows::fs::OpenOptionsExt::attributes`
7953 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7954 * `os::unix::fs::OpenOptionsExt::custom_flags`
7955 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7956 * `Default for sync::Weak`
7957 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7958 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7959 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7960 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7961 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7962 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7963 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7964 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7965 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7966 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7967 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7968 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7969 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7970 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7971 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7972 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7973 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7974 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7975 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7976 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7977 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7978 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7979 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7980 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7981 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7982 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7983 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7984 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7985 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7986 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7987 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7988 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7989 * Read/Write/RawFd impls for `UnixStream`
7990 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7991 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7992 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7993 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7994 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7995 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7996 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7997 * RawFd impls for `UnixListener`
7998 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7999 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
8000 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
8001 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
8002 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
8003 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
8004 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
8005 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
8006 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
8007 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
8008 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
8009 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
8010 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
8011 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
8012 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
8013 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
8014 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
8015 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
8016 * RawFd impls for `UnixDatagram`
8017 * `{BTree,Hash}Map::values_mut`
8018 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
8019
8020 Libraries
8021 ---------
8022
8023 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
8024   The semantics of this minor method are subtle and probably not what
8025   most people want.
8026 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
8027 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
8028   will fall back to `/dev/urandom` temporarily to avoid blocking
8029   during early boot](https://github.com/rust-lang/rust/pull/33086).
8030 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
8031 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
8032 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
8033 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
8034 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
8035 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
8036   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
8037
8038 Cargo
8039 -----
8040 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
8041   This controls the runtime behavior of the `panic!` macro
8042   and can be either "unwind" (the default), or "abort".
8043   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
8044 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
8045 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
8046 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
8047   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
8048 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
8049 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
8050 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
8051   By default they are retried twice, which can be customized with the
8052   `net.retry` value in `.cargo/config`.
8053 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
8054 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
8055 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
8056 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
8057   Makes it possible to install multiple crates in parallel.
8058 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
8059 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
8060 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
8061 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
8062 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
8063 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
8064
8065 Performance
8066 -----------
8067
8068 * [rustc memory usage was reduced by refactoring the context used for
8069   type checking](https://github.com/rust-lang/rust/pull/33425).
8070 * [Speed up creation of `HashMap`s by caching the random keys used
8071   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
8072 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
8073 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
8074 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
8075   10x faster than the previous lookup tables.
8076 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
8077
8078 Usability
8079 ---------
8080
8081 * Many incremental improvements to documentation and rustdoc.
8082 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
8083 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
8084 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
8085 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
8086 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
8087 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
8088 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
8089
8090 Misc
8091 ----
8092
8093 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
8094 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
8095 * [`std` no longer prints backtraces on platforms where the running
8096   module must be loaded with `env::current_exe`, which can't be relied
8097   on](https://github.com/rust-lang/rust/pull/33554).
8098 * This release includes std binaries for the i586-unknown-linux-gnu,
8099   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
8100   i586 target is for old x86 hardware without SSE2, and the armv7
8101   target is for Android running on modern ARM architectures.
8102 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
8103   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
8104 * [On Unix the runtime aborts by calling `libc::abort` instead of
8105   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
8106 * [Rust is now bootstrapped from the previous release of Rust,
8107   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
8108
8109 Compatibility Notes
8110 -------------------
8111
8112 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
8113 * [`target_env` for Linux ARM targets is just `gnu`, not
8114   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
8115 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
8116 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
8117 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
8118   Affects how macros are parsed.
8119 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
8120 * [Feature-gated attributes on macro-generated macro invocations are
8121   now rejected](https://github.com/rust-lang/rust/pull/32791).
8122 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
8123   This caused some minor changes to type inference.
8124
8125
8126 Version 1.9.0 (2016-05-26)
8127 ==========================
8128
8129 Language
8130 --------
8131
8132 * The `#[deprecated]` attribute when applied to an API will generate
8133   warnings when used. The warnings may be suppressed with
8134   `#[allow(deprecated)]`. [RFC 1270].
8135 * [`fn` item types are zero sized, and each `fn` names a unique
8136   type][1.9fn]. This will break code that transmutes `fn`s, so calling
8137   `transmute` on a `fn` type will generate a warning for a few cycles,
8138   then will be converted to an error.
8139 * [Field and method resolution understand visibility, so private
8140   fields and methods cannot prevent the proper use of public fields
8141   and methods][1.9fv].
8142 * [The parser considers unicode codepoints in the
8143   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
8144
8145 Stabilized APIs
8146 ---------------
8147
8148 * [`std::panic`]
8149 * [`std::panic::catch_unwind`] (renamed from `recover`)
8150 * [`std::panic::resume_unwind`] (renamed from `propagate`)
8151 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
8152 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
8153 * [`str::is_char_boundary`]
8154 * [`<*const T>::as_ref`]
8155 * [`<*mut T>::as_ref`]
8156 * [`<*mut T>::as_mut`]
8157 * [`AsciiExt::make_ascii_uppercase`]
8158 * [`AsciiExt::make_ascii_lowercase`]
8159 * [`char::decode_utf16`]
8160 * [`char::DecodeUtf16`]
8161 * [`char::DecodeUtf16Error`]
8162 * [`char::DecodeUtf16Error::unpaired_surrogate`]
8163 * [`BTreeSet::take`]
8164 * [`BTreeSet::replace`]
8165 * [`BTreeSet::get`]
8166 * [`HashSet::take`]
8167 * [`HashSet::replace`]
8168 * [`HashSet::get`]
8169 * [`OsString::with_capacity`]
8170 * [`OsString::clear`]
8171 * [`OsString::capacity`]
8172 * [`OsString::reserve`]
8173 * [`OsString::reserve_exact`]
8174 * [`OsStr::is_empty`]
8175 * [`OsStr::len`]
8176 * [`std::os::unix::thread`]
8177 * [`RawPthread`]
8178 * [`JoinHandleExt`]
8179 * [`JoinHandleExt::as_pthread_t`]
8180 * [`JoinHandleExt::into_pthread_t`]
8181 * [`HashSet::hasher`]
8182 * [`HashMap::hasher`]
8183 * [`CommandExt::exec`]
8184 * [`File::try_clone`]
8185 * [`SocketAddr::set_ip`]
8186 * [`SocketAddr::set_port`]
8187 * [`SocketAddrV4::set_ip`]
8188 * [`SocketAddrV4::set_port`]
8189 * [`SocketAddrV6::set_ip`]
8190 * [`SocketAddrV6::set_port`]
8191 * [`SocketAddrV6::set_flowinfo`]
8192 * [`SocketAddrV6::set_scope_id`]
8193 * [`slice::copy_from_slice`]
8194 * [`ptr::read_volatile`]
8195 * [`ptr::write_volatile`]
8196 * [`OpenOptions::create_new`]
8197 * [`TcpStream::set_nodelay`]
8198 * [`TcpStream::nodelay`]
8199 * [`TcpStream::set_ttl`]
8200 * [`TcpStream::ttl`]
8201 * [`TcpStream::set_only_v6`]
8202 * [`TcpStream::only_v6`]
8203 * [`TcpStream::take_error`]
8204 * [`TcpStream::set_nonblocking`]
8205 * [`TcpListener::set_ttl`]
8206 * [`TcpListener::ttl`]
8207 * [`TcpListener::set_only_v6`]
8208 * [`TcpListener::only_v6`]
8209 * [`TcpListener::take_error`]
8210 * [`TcpListener::set_nonblocking`]
8211 * [`UdpSocket::set_broadcast`]
8212 * [`UdpSocket::broadcast`]
8213 * [`UdpSocket::set_multicast_loop_v4`]
8214 * [`UdpSocket::multicast_loop_v4`]
8215 * [`UdpSocket::set_multicast_ttl_v4`]
8216 * [`UdpSocket::multicast_ttl_v4`]
8217 * [`UdpSocket::set_multicast_loop_v6`]
8218 * [`UdpSocket::multicast_loop_v6`]
8219 * [`UdpSocket::set_multicast_ttl_v6`]
8220 * [`UdpSocket::multicast_ttl_v6`]
8221 * [`UdpSocket::set_ttl`]
8222 * [`UdpSocket::ttl`]
8223 * [`UdpSocket::set_only_v6`]
8224 * [`UdpSocket::only_v6`]
8225 * [`UdpSocket::join_multicast_v4`]
8226 * [`UdpSocket::join_multicast_v6`]
8227 * [`UdpSocket::leave_multicast_v4`]
8228 * [`UdpSocket::leave_multicast_v6`]
8229 * [`UdpSocket::take_error`]
8230 * [`UdpSocket::connect`]
8231 * [`UdpSocket::send`]
8232 * [`UdpSocket::recv`]
8233 * [`UdpSocket::set_nonblocking`]
8234
8235 Libraries
8236 ---------
8237
8238 * [`std::sync::Once` is poisoned if its initialization function
8239   fails][1.9o].
8240 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
8241 * [Most types implement `fmt::Debug`][1.9db].
8242 * [The default buffer size used by `BufReader` and `BufWriter` was
8243   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
8244   used by other languages.
8245 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
8246   `Duration` additionally implements `*=` and `/=`][1.9ta].
8247 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
8248 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
8249 * [`Chain` implements `BufRead`][1.9ch].
8250 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
8251
8252 Cargo
8253 -----
8254
8255 * [Cargo can now run concurrently][1.9cc].
8256 * [Top-level overrides allow specific revisions of crates to be
8257   overridden through the entire crate graph][1.9ct].  This is intended
8258   to make upgrades easier for large projects, by allowing crates to be
8259   forked temporarily until they've been upgraded and republished.
8260 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
8261 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
8262   on the commandline][1.9cf]. `rustc` arguments can also be specified
8263   in the `build.rustflags` configuration key.
8264
8265 Performance
8266 -----------
8267
8268 * [The time complexity of comparing variables for equivalence during type
8269   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
8270   to major compilation time improvement in some scenarios.
8271 * [`ToString` is specialized for `str`, giving it the same performance
8272   as `to_owned`][1.9ts].
8273 * [Spawning processes with `Command::output` no longer creates extra
8274   threads][1.9sp].
8275 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
8276   for C-like enums][1.9cl].
8277
8278 Misc
8279 ----
8280
8281 * [Passing the `--quiet` flag to a test runner will produce
8282   much-abbreviated output][1.9q].
8283 * The Rust Project now publishes std binaries for the
8284   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
8285   `i586-pc-windows-msvc` targets.
8286
8287 Compatibility Notes
8288 -------------------
8289
8290 * [`std::sync::Once` is poisoned if its initialization function
8291   fails][1.9o].
8292 * [It is illegal to define methods with the same name in overlapping
8293   inherent `impl` blocks][1.9sn].
8294 * [`fn` item types are zero sized, and each `fn` names a unique
8295   type][1.9fn]. This will break code that transmutes `fn`s, so calling
8296   `transmute` on a `fn` type will generate a warning for a few cycles,
8297   then will be converted to an error.
8298 * [Improvements to const evaluation may trigger new errors when integer
8299   literals are out of range][1.9ce].
8300
8301
8302 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
8303 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
8304 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
8305 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
8306 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
8307 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
8308 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
8309 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
8310 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
8311 [1.9db]: https://github.com/rust-lang/rust/pull/32054
8312 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
8313 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
8314 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
8315 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
8316 [1.9o]: https://github.com/rust-lang/rust/pull/32325
8317 [1.9q]: https://github.com/rust-lang/rust/pull/31887
8318 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
8319 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
8320 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
8321 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
8322 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
8323 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
8324 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
8325 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
8326 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
8327 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
8328 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
8329 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
8330 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
8331 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
8332 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
8333 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
8334 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
8335 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
8336 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
8337 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
8338 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
8339 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
8340 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
8341 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
8342 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
8343 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
8344 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
8345 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
8346 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
8347 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
8348 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
8349 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
8350 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
8351 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
8352 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
8353 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
8354 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
8355 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
8356 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
8357 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
8358 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
8359 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
8360 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
8361 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
8362 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
8363 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
8364 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
8365 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
8366 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
8367 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
8368 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
8369 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
8370 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
8371 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
8372 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
8373 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
8374 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
8375 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
8376 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
8377 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
8378 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
8379 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
8380 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
8381 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
8382 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
8383 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
8384 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
8385 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
8386 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
8387 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
8388 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
8389 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
8390 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
8391 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
8392 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
8393 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
8394 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
8395 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
8396 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
8397 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
8398 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
8399 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
8400 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
8401 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
8402 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
8403 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
8404 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
8405 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
8406 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
8407 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
8408 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
8409 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
8410 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
8411 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
8412
8413
8414 Version 1.8.0 (2016-04-14)
8415 ==========================
8416
8417 Language
8418 --------
8419
8420 * Rust supports overloading of compound assignment statements like
8421   `+=` by implementing the [`AddAssign`], [`SubAssign`],
8422   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
8423   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
8424   traits. [RFC 953].
8425 * Empty structs can be defined with braces, as in `struct Foo { }`, in
8426   addition to the non-braced form, `struct Foo;`. [RFC 218].
8427
8428 Libraries
8429 ---------
8430
8431 * Stabilized APIs:
8432   * [`str::encode_utf16`] (renamed from `utf16_units`)
8433   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
8434   * [`Ref::map`]
8435   * [`RefMut::map`]
8436   * [`ptr::drop_in_place`]
8437   * [`time::Instant`]
8438   * [`time::SystemTime`]
8439   * [`Instant::now`]
8440   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
8441   * [`Instant::elapsed`]
8442   * [`SystemTime::now`]
8443   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
8444   * [`SystemTime::elapsed`]
8445   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
8446   * [`SystemTimeError`]
8447   * [`SystemTimeError::duration`]
8448   * Various impls for `SystemTimeError`
8449   * [`UNIX_EPOCH`]
8450   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
8451     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
8452     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
8453 * [The `write!` and `writeln!` macros correctly emit errors if any of
8454   their arguments can't be formatted][1.8w].
8455 * [Various I/O functions support large files on 32-bit Linux][1.8l].
8456 * [The Unix-specific `raw` modules, which contain a number of
8457   redefined C types are deprecated][1.8r], including `os::raw::unix`,
8458   `os::raw::macos`, and `os::raw::linux`. These modules defined types
8459   such as `ino_t` and `dev_t`. The inconsistency of these definitions
8460   across platforms was making it difficult to implement `std`
8461   correctly. Those that need these definitions should use the `libc`
8462   crate. [RFC 1415].
8463 * The Unix-specific `MetadataExt` traits, including
8464   `os::unix::fs::MetadataExt`, which expose values such as inode
8465   numbers [no longer return platform-specific types][1.8r], but
8466   instead return widened integers. [RFC 1415].
8467 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
8468 * [Atomic loads and stores are not volatile][1.8a].
8469 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
8470
8471 Performance
8472 -----------
8473
8474 * [Inlining hash functions lead to a 3% compile-time improvement in
8475   some workloads][1.8h].
8476 * When using jemalloc, its symbols are [unprefixed so that it
8477   overrides the libc malloc implementation][1.8h]. This means that for
8478   rustc, LLVM is now using jemalloc, which results in a 6%
8479   compile-time improvement on a specific workload.
8480 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
8481
8482 Misc
8483 ----
8484
8485 * [32-bit MSVC builds finally implement unwinding][1.8ms].
8486   i686-pc-windows-msvc is now considered a tier-1 platform.
8487 * [The `--print targets` flag prints a list of supported targets][1.8t].
8488 * [The `--print cfg` flag prints the `cfg`s defined for the current
8489   target][1.8cf].
8490 * [`rustc` can be built with an new Cargo-based build system, written
8491   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
8492   build system. To enable it configure with `configure --rustbuild`.
8493 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
8494   variants while also indicating the total number of missing variants
8495   if more than 3][1.8m].
8496 * [Executable stacks are disabled on Linux and BSD][1.8nx].
8497 * The Rust Project now publishes binary releases of the standard
8498   library for a number of tier-2 targets:
8499   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
8500   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
8501   `x86_64-rumprun-netbsd`. These can be installed with
8502   tools such as [multirust][1.8mr].
8503
8504 Cargo
8505 -----
8506
8507 * [`cargo init` creates a new Cargo project in the current
8508   directory][1.8ci].  It is otherwise like `cargo new`.
8509 * [Cargo has configuration keys for `-v` and
8510   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
8511   `[term]` section of `.cargo/config`.
8512 * [Configuration keys that evaluate to strings or integers can be set
8513   via environment variables][1.8ce]. For example the `build.jobs` key
8514   can be set via `CARGO_BUILD_JOBS`. Environment variables take
8515   precedence over config files.
8516 * [Target-specific dependencies support Rust `cfg` syntax for
8517   describing targets][1.8cfg] so that dependencies for multiple
8518   targets can be specified together. [RFC 1361].
8519 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
8520   `RUSTDOC` take precedence over the `build.target-dir`,
8521   `build.rustc`, and `build.rustdoc` configuration values][1.8cfv].
8522 * [The child process tree is killed on Windows when Cargo is
8523   killed][1.8ck].
8524 * [The `build.target` configuration value sets the target platform,
8525   like `--target`][1.8ct].
8526
8527 Compatibility Notes
8528 -------------------
8529
8530 * [Unstable compiler flags have been further restricted][1.8u]. Since
8531   1.0 `-Z` flags have been considered unstable, and other flags that
8532   were considered unstable additionally required passing `-Z
8533   unstable-options` to access. Unlike unstable language and library
8534   features though, these options have been accessible on the stable
8535   release channel. Going forward, *new unstable flags will not be
8536   available on the stable release channel*, and old unstable flags
8537   will warn about their usage. In the future, all unstable flags will
8538   be unavailable on the stable release channel.
8539 * [It is no longer possible to `match` on empty enum variants using
8540   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
8541 * The Unix-specific `MetadataExt` traits, including
8542   `os::unix::fs::MetadataExt`, which expose values such as inode
8543   numbers [no longer return platform-specific types][1.8r], but
8544   instead return widened integers. [RFC 1415].
8545 * [Modules sourced from the filesystem cannot appear within arbitrary
8546   blocks, but only within other modules][1.8mf].
8547 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
8548 * On Unix, [stack overflow triggers a runtime abort instead of a
8549   SIGSEGV][1.8so].
8550 * [`Command::spawn` and its equivalents return an error if any of
8551   its command-line arguments contain interior `NUL`s][1.8n].
8552 * [Tuple and unit enum variants from other crates are in the type
8553   namespace][1.8tn].
8554 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
8555   type instead of `.a` files][1.8st]. Additionally, for the MSVC
8556   toolchain, `rustc` emits import libraries named `foo.dll.lib`
8557   instead of `foo.lib`.
8558
8559
8560 [1.8a]: https://github.com/rust-lang/rust/pull/30962
8561 [1.8b]: https://github.com/rust-lang/rust/pull/31123
8562 [1.8c]: https://github.com/rust-lang/rust/pull/31530
8563 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
8564 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
8565 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
8566 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
8567 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
8568 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
8569 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
8570 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
8571 [1.8cfv]: https://github.com/rust-lang/cargo/issues/2365
8572 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
8573 [1.8h]: https://github.com/rust-lang/rust/pull/31460
8574 [1.8l]: https://github.com/rust-lang/rust/pull/31668
8575 [1.8m]: https://github.com/rust-lang/rust/pull/31020
8576 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
8577 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
8578 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
8579 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
8580 [1.8n]: https://github.com/rust-lang/rust/pull/31056
8581 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
8582 [1.8r]: https://github.com/rust-lang/rust/pull/31551
8583 [1.8so]: https://github.com/rust-lang/rust/pull/31333
8584 [1.8st]: https://github.com/rust-lang/rust/pull/29520
8585 [1.8t]: https://github.com/rust-lang/rust/pull/31358
8586 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
8587 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8588 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8589 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8590 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8591 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8592 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8593 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8594 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8595 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8596 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8597 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8598 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8599 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8600 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8601 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8602 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8603 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8604 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8605 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8606 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8607 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8608 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8609 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8610 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8611 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8612 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8613 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8614 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8615 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8616 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8617 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8618 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8619 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8620
8621
8622 Version 1.7.0 (2016-03-03)
8623 ==========================
8624
8625 Libraries
8626 ---------
8627
8628 * Stabilized APIs
8629   * `Path`
8630     * [`Path::strip_prefix`] (renamed from relative_from)
8631     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8632   * `Ipv4Addr`
8633     * [`Ipv4Addr::is_loopback`]
8634     * [`Ipv4Addr::is_private`]
8635     * [`Ipv4Addr::is_link_local`]
8636     * [`Ipv4Addr::is_multicast`]
8637     * [`Ipv4Addr::is_broadcast`]
8638     * [`Ipv4Addr::is_documentation`]
8639   * `Ipv6Addr`
8640     * [`Ipv6Addr::is_unspecified`]
8641     * [`Ipv6Addr::is_loopback`]
8642     * [`Ipv6Addr::is_multicast`]
8643   * `Vec`
8644     * [`Vec::as_slice`]
8645     * [`Vec::as_mut_slice`]
8646   * `String`
8647     * [`String::as_str`]
8648     * [`String::as_mut_str`]
8649   * Slices
8650     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8651     be the same length
8652     * `<[T]>::`[`sort_by_key`]
8653   * checked, saturated, and overflowing operations
8654     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8655     * [`i32::saturating_mul`]
8656     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8657     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8658     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8659     * [`u32::saturating_mul`]
8660     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8661     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8662     * and checked, saturated, and overflowing operations for other primitive types
8663   * FFI
8664     * [`ffi::IntoStringError`]
8665     * [`CString::into_string`]
8666     * [`CString::into_bytes`]
8667     * [`CString::into_bytes_with_nul`]
8668     * `From<CString> for Vec<u8>`
8669   * `IntoStringError`
8670     * [`IntoStringError::into_cstring`]
8671     * [`IntoStringError::utf8_error`]
8672     * `Error for IntoStringError`
8673   * Hashing
8674     * [`std::hash::BuildHasher`]
8675     * [`BuildHasher::Hasher`]
8676     * [`BuildHasher::build_hasher`]
8677     * [`std::hash::BuildHasherDefault`]
8678     * [`HashMap::with_hasher`]
8679     * [`HashMap::with_capacity_and_hasher`]
8680     * [`HashSet::with_hasher`]
8681     * [`HashSet::with_capacity_and_hasher`]
8682     * [`std::collections::hash_map::RandomState`]
8683     * [`RandomState::new`]
8684 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8685   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8686   from bytes is faster.
8687 * [The performance of `LineWriter` (and thus `io::stdout`) was
8688   improved by using `memchr` to search for newlines][1.7m].
8689 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8690   `f64` variants were stabilized previously.
8691 * [`BTreeMap` was rewritten to use less memory and improve the performance
8692   of insertion and iteration, the latter by as much as 5x][1.7bm].
8693 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8694   covariant over their contained type][1.7bt].
8695 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8696   over their contained type][1.7ll].
8697 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8698   searching methods.
8699 * [`Any` is implemented for unsized types][1.7a].
8700 * [`Hash` is implemented for `Duration`][1.7h].
8701
8702 Misc
8703 ----
8704
8705 * [When running tests with `--test`, rustdoc will pass `--cfg`
8706   arguments to the compiler][1.7dt].
8707 * [The compiler is built with RPATH information by default][1.7rpa].
8708   This means that it will be possible to run `rustc` when installed in
8709   unusual configurations without configuring the dynamic linker search
8710   path explicitly.
8711 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8712   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8713   over `LD_LIBRARY_PATH`.
8714
8715 Cargo
8716 -----
8717
8718 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8719   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8720 * [The `rerun-if-changed` build script directive no longer causes the
8721   build script to incorrectly run twice in certain scenarios][1.7rr].
8722
8723 Compatibility Notes
8724 -------------------
8725
8726 * Soundness fixes to the interactions between associated types and
8727   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8728   code that violates the new rules. This is a significant change that
8729   is known to break existing code, so it has emitted warnings for the
8730   new error cases since 1.4 to give crate authors time to adapt. The
8731   details of what is changing are subtle; read the RFC for more.
8732 * [Several bugs in the compiler's visibility calculations were
8733   fixed][1.7v]. Since this was found to break significant amounts of
8734   code, the new errors will be emitted as warnings for several release
8735   cycles, under the `private_in_public` lint.
8736 * Defaulted type parameters were accidentally accepted in positions
8737   that were not intended. In this release, [defaulted type parameters
8738   appearing outside of type definitions will generate a
8739   warning][1.7d], which will become an error in future releases.
8740 * [Parsing "." as a float results in an error instead of 0][1.7p].
8741   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8742 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8743
8744 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8745 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8746 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8747 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8748 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8749 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8750 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8751 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8752 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8753 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8754 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8755 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8756 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8757 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8758 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8759 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8760 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8761 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8762 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8763 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8764 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8765 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8766 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8767 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8768 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8769 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8770 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8771 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8772 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8773 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8774 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8775 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8776 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8777 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8778 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8779 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8780 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8781 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8782 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8783 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8784 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8785 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8786 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8787 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8788 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8789 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8790 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8791 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8792 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8793 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8794 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8795 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8796 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8797 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8798 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8799 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8800 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8801 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8802 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8803 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8804 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8805 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8806 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8807 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8808 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8809 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8810 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8811 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8812 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8813 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8814 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8815 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8816 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8817 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8818 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8819 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8820 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8821 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8822 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8823
8824
8825 Version 1.6.0 (2016-01-21)
8826 ==========================
8827
8828 Language
8829 --------
8830
8831 * The `#![no_std]` attribute causes a crate to not be linked to the
8832   standard library, but only the [core library][1.6co], as described
8833   in [RFC 1184]. The core library defines common types and traits but
8834   has no platform dependencies whatsoever, and is the basis for Rust
8835   software in environments that cannot support a full port of the
8836   standard library, such as operating systems. Most of the core
8837   library is now stable.
8838
8839 Libraries
8840 ---------
8841
8842 * Stabilized APIs:
8843   [`Read::read_exact`],
8844   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8845   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8846   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8847   [`os::unix::fs::DirBuilderExt`],
8848   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8849   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8850   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8851   [`collections::hash_map::Drain`],
8852   [`collections::hash_map::HashMap::drain`],
8853   [`collections::hash_set::Drain`],
8854   [`collections::hash_set::HashSet::drain`],
8855   [`collections::binary_heap::Drain`],
8856   [`collections::binary_heap::BinaryHeap::drain`],
8857   [`Vec::extend_from_slice`] (renamed from `push_all`),
8858   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8859   [`RwLock::into_inner`],
8860   [`Iterator::min_by_key`] (renamed from `min_by`),
8861   [`Iterator::max_by_key`] (renamed from `max_by`).
8862 * The [core library][1.6co] is stable, as are most of its APIs.
8863 * [The `assert_eq!` macro supports arguments that don't implement
8864   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8865   `assert!`.
8866 * Several timer functions that take duration in milliseconds [are
8867   deprecated in favor of those that take `Duration`][1.6ms]. These
8868   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8869   `thread::park_timeout_ms`.
8870 * The algorithm by which `Vec` reserves additional elements was
8871   [tweaked to not allocate excessive space][1.6a] while still growing
8872   exponentially.
8873 * `From` conversions are [implemented from integers to floats][1.6f]
8874   in cases where the conversion is lossless. Thus they are not
8875   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8876   or `f64`. They are also not implemented for `isize` and `usize`
8877   because the implementations would be platform-specific. `From` is
8878   also implemented from `f32` to `f64`.
8879 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8880 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8881 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8882 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8883   improvements.
8884 * Sorting slices that are already sorted [is 50% faster in some
8885   cases][1.6s].
8886
8887 Cargo
8888 -----
8889
8890 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8891 * Cargo build scripts can specify their dependencies by emitting the
8892   [`rerun-if-changed`][1.6rr] key.
8893 * crates.io will reject publication of crates with dependencies that
8894   have a wildcard version constraint. Crates with wildcard
8895   dependencies were seen to cause a variety of problems, as described
8896   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8897   warning.
8898 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8899   release folder.  A variety of artifacts that Cargo failed to clean
8900   are now correctly deleted.
8901
8902 Misc
8903 ----
8904
8905 * The `unreachable_code` lint [warns when a function call's argument
8906   diverges][1.6dv].
8907 * The parser indicates [failures that may be caused by
8908   confusingly-similar Unicode characters][1.6uc]
8909 * Certain macro errors [are reported at definition time][1.6m], not
8910   expansion.
8911
8912 Compatibility Notes
8913 -------------------
8914
8915 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8916   environment variable when locating crates. This was a pre-cargo
8917   feature for integrating with the package manager that was
8918   accidentally never removed.
8919 * [A number of bugs were fixed in the privacy checker][1.6p] that
8920   could cause previously-accepted code to break.
8921 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8922 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8923   struct pattern syntax (`Foo(..)`) can no longer be used to match
8924   unit structs. This is a warning now, but will become an error in
8925   future releases. Patterns that share the same name as a const are
8926   now an error.
8927 * A bug was fixed that causes [rustc not to apply default type
8928   parameters][1.6xc] when resolving certain method implementations of
8929   traits defined in other crates.
8930
8931 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8932 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8933 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8934 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8935 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8936 [1.6co]: http://doc.rust-lang.org/core/index.html
8937 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8938 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8939 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8940 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8941 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8942 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8943 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8944 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8945 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8946 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8947 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8948 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8949 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8950 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8951 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8952 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8953 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8954 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8955 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8956 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8957 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8958 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8959 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8960 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8961 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8962 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8963 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8964 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8965 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8966 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8967 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8968 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8969 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8970 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8971 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8972 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8973 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8974 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8975 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8976 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8977 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8978
8979
8980 Version 1.5.0 (2015-12-10)
8981 ==========================
8982
8983 * ~700 changes, numerous bugfixes
8984
8985 Highlights
8986 ----------
8987
8988 * Stabilized APIs:
8989   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8990   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8991   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8992   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8993   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8994   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8995   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8996   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8997   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8998   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8999   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
9000   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
9001   [`Path::read_link`], [`Path::symlink_metadata`],
9002   [`Utf8Error::valid_up_to`], [`Vec::resize`],
9003   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
9004   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
9005   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
9006   [`slice::split_first_mut`], [`slice::split_first`],
9007   [`slice::split_last_mut`], [`slice::split_last`],
9008   [`char::from_u32_unchecked`], [`fs::canonicalize`],
9009   [`str::MatchIndices`], [`str::RMatchIndices`],
9010   [`str::match_indices`], [`str::rmatch_indices`],
9011   [`str::slice_mut_unchecked`], [`string::ParseError`].
9012 * Rust applications hosted on crates.io can be installed locally to
9013   `~/.cargo/bin` with the [`cargo install`] command. Among other
9014   things this makes it easier to augment Cargo with new subcommands:
9015   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
9016   invoked as `cargo foo`.
9017 * Crates with wildcard (`*`) dependencies will [emit warnings when
9018   published][1.5w]. In 1.6 it will no longer be possible to publish
9019   crates with wildcard dependencies.
9020
9021 Breaking Changes
9022 ----------------
9023
9024 * The rules determining when a particular lifetime must outlive
9025   a particular value (known as '[dropck]') have been [modified
9026   to not rely on parametricity][1.5p].
9027 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
9028   and `Arc`][1.5a]. Because these smart pointer types implement
9029   `Deref`, this causes breakage in cases where the interior type
9030   contains methods of the same name.
9031 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
9032   that they could drop their content. Soundness fix.
9033 * All method invocations are [properly checked][1.5wf1] for
9034   [well-formedness][1.5wf2]. Soundness fix.
9035 * Traits whose supertraits contain `Self` are [not object
9036   safe][1.5o]. Soundness fix.
9037 * Target specifications support a [`no_default_libraries`][1.5nd]
9038   setting that controls whether `-nodefaultlibs` is passed to the
9039   linker, and in turn the `is_like_windows` setting no longer affects
9040   the `-nodefaultlibs` flag.
9041 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
9042 * The `#[inline]` and `#[repr]` attributes [can only appear
9043   in valid locations][1.5at].
9044 * Native libraries linked from the local crate are [passed to
9045   the linker before native libraries from upstream crates][1.5nl].
9046 * Two rarely-used attributes, `#[no_debug]` and
9047   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
9048 * Negation of unsigned integers, which has been a warning for
9049   several releases, [is now behind a feature gate and will
9050   generate errors][1.5nu].
9051 * The parser accidentally accepted visibility modifiers on
9052   enum variants, a bug [which has been fixed][1.5ev].
9053 * [A bug was fixed that allowed `use` statements to import unstable
9054   features][1.5use].
9055
9056 Language
9057 --------
9058
9059 * When evaluating expressions at compile-time that are not
9060   compile-time constants (const-evaluating expressions in non-const
9061   contexts), incorrect code such as overlong bitshifts and arithmetic
9062   overflow will [generate a warning instead of an error][1.5ce],
9063   delaying the error until runtime. This will allow the
9064   const-evaluator to be expanded in the future backwards-compatibly.
9065 * The `improper_ctypes` lint [no longer warns about using `isize` and
9066   `usize` in FFI][1.5ict].
9067
9068 Libraries
9069 ---------
9070
9071 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
9072   invariant][1.5c].
9073 * `Default` is [implemented for mutable slices][1.5d].
9074 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
9075 * There are now `From` conversions [between floating point
9076   types][1.5f] where the conversions are lossless.
9077 * There are now `From` conversions [between integer types][1.5i] where
9078   the conversions are lossless.
9079 * [`fs::Metadata` implements `Clone`][1.5fs].
9080 * The `parse` method [accepts a leading "+" when parsing
9081   integers][1.5pi].
9082 * [`AsMut` is implemented for `Vec`][1.5am].
9083 * The `clone_from` implementations for `String` and `BinaryHeap` [have
9084   been optimized][1.5cf] and no longer rely on the default impl.
9085 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
9086   `unsafe extern "C"` function types now [implement `Clone`,
9087   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
9088   `fmt::Debug` for up to 12 arguments][1.5fp].
9089 * [Dropping `Vec`s is much faster in unoptimized builds when the
9090   element types don't implement `Drop`][1.5dv].
9091 * A bug that caused in incorrect behavior when [combining `VecDeque`
9092   with zero-sized types][1.5vdz] was resolved.
9093 * [`PartialOrd` for slices is faster][1.5po].
9094
9095 Miscellaneous
9096 -------------
9097
9098 * [Crate metadata size was reduced by 20%][1.5md].
9099 * [Improvements to code generation reduced the size of libcore by 3.3
9100   MB and rustc's memory usage by 18MB][1.5m].
9101 * [Improvements to deref translation increased performance in
9102   unoptimized builds][1.5dr].
9103 * Various errors in trait resolution [are deduplicated to only be
9104   reported once][1.5te].
9105 * Rust has preliminary [support for rumprun kernels][1.5rr].
9106 * Rust has preliminary [support for NetBSD on amd64][1.5na].
9107
9108 [1.5use]: https://github.com/rust-lang/rust/pull/28364
9109 [1.5po]: https://github.com/rust-lang/rust/pull/28436
9110 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
9111 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
9112 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
9113 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
9114 [1.5md]: https://github.com/rust-lang/rust/pull/28521
9115 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
9116 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
9117 [1.5na]: https://github.com/rust-lang/rust/pull/28543
9118 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
9119 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
9120 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
9121 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
9122 [1.5te]: https://github.com/rust-lang/rust/pull/28645
9123 [1.5at]: https://github.com/rust-lang/rust/pull/28650
9124 [1.5am]: https://github.com/rust-lang/rust/pull/28663
9125 [1.5m]: https://github.com/rust-lang/rust/pull/28778
9126 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
9127 [1.5a]: https://github.com/rust-lang/rust/pull/28811
9128 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
9129 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
9130 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
9131 [1.5i]: https://github.com/rust-lang/rust/pull/28921
9132 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
9133 [1.5f]: https://github.com/rust-lang/rust/pull/29129
9134 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
9135 [1.5s]: https://github.com/rust-lang/rust/pull/29190
9136 [1.5d]: https://github.com/rust-lang/rust/pull/29245
9137 [1.5o]: https://github.com/rust-lang/rust/pull/29259
9138 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
9139 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9140 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
9141 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
9142 [1.5c]: https://github.com/rust-lang/rust/pull/29110
9143 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
9144 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
9145 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
9146 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
9147 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
9148 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
9149 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
9150 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
9151 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
9152 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
9153 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
9154 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
9155 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
9156 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
9157 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
9158 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
9159 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
9160 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
9161 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
9162 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
9163 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
9164 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
9165 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
9166 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
9167 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
9168 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
9169 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
9170 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
9171 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
9172 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
9173 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
9174 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
9175 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
9176 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
9177 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
9178 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
9179 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
9180 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
9181 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
9182 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
9183 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
9184 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
9185 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
9186 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
9187 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
9188 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
9189 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
9190 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
9191 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
9192 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
9193 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
9194 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
9195 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
9196 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
9197
9198 Version 1.4.0 (2015-10-29)
9199 ==========================
9200
9201 * ~1200 changes, numerous bugfixes
9202
9203 Highlights
9204 ----------
9205
9206 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
9207   GNU) are now supported and recommended for use.
9208
9209 Breaking Changes
9210 ----------------
9211
9212 * [Several changes have been made to fix type soundness and improve
9213   the behavior of associated types][sound]. See [RFC 1214]. Although
9214   we have mostly introduced these changes as warnings this release, to
9215   become errors next release, there are still some scenarios that will
9216   see immediate breakage.
9217 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
9218   line breaks in addition to `\n`][crlf].
9219 * [Loans of `'static` lifetime extend to the end of a function][stat].
9220 * [`str::parse` no longer introduces avoidable rounding error when
9221   parsing floating point numbers. Together with earlier changes to
9222   float formatting/output, "round trips" like f.to_string().parse()
9223   now preserve the value of f exactly. Additionally, leading plus
9224   signs are now accepted][fp3].
9225
9226
9227 Language
9228 --------
9229
9230 * `use` statements that import multiple items [can now rename
9231   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
9232 * [Binops work correctly on fat pointers][binfat].
9233 * `pub extern crate`, which does not behave as expected, [issues a
9234   warning][pec] until a better solution is found.
9235
9236 Libraries
9237 ---------
9238
9239 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
9240   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
9241   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
9242   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
9243   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
9244   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
9245   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
9246   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
9247   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
9248   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
9249   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
9250   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
9251   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
9252   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
9253   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
9254   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
9255   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
9256   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
9257   [`thread::sleep`].
9258 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
9259   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
9260   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
9261   `f64::from_str_radix`.
9262 * [Reverse-searching strings is faster with the 'two-way'
9263   algorithm][s].
9264 * [`std::io::copy` allows `?Sized` arguments][cc].
9265 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
9266   [override `count`, `nth` and `last` with an *O*(1)
9267   implementation][it].
9268 * [`Default` is implemented for arrays up to `[T; 32]`][d].
9269 * [`IntoRawFd` has been added to the Unix-specific prelude,
9270   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
9271   prelude][pr].
9272 * [`Extend<String>` and `FromIterator<String` are both implemented for
9273   `String`][es].
9274 * [`IntoIterator` is implemented for references to `Option` and
9275   `Result`][into2].
9276 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
9277   Copy`][ext] as part of [RFC 839]. This will cause type inference
9278   breakage in rare situations.
9279 * [`BinaryHeap` implements `Debug`][bh2].
9280 * [`Borrow` and `BorrowMut` are implemented for fixed-size
9281   arrays][bm].
9282 * [`extern fn`s with the "Rust" and "C" ABIs implement common
9283   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
9284 * [String comparison is faster][faststr].
9285 * `&mut T` where `T: std::fmt::Write` [also implements
9286   `std::fmt::Write`][mutw].
9287 * [A stable regression in `VecDeque::push_back` and other
9288   capacity-altering methods that caused panics for zero-sized types
9289   was fixed][vd].
9290 * [Function pointers implement traits for up to 12 parameters][fp2].
9291
9292 Miscellaneous
9293 -------------
9294
9295 * The compiler [no longer uses the 'morestack' feature to prevent
9296   stack overflow][mm]. Instead it uses guard pages and stack
9297   probes (though stack probes are not yet implemented on any platform
9298   but Windows).
9299 * [The compiler matches traits faster when projections are involved][p].
9300 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
9301   `usize`][ffi].
9302 * [Cargo now displays useful information about what its doing during
9303   `cargo update`][cu].
9304
9305 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
9306 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
9307 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
9308 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
9309 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
9310 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
9311 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
9312 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
9313 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
9314 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
9315 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
9316 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
9317 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
9318 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
9319 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
9320 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
9321 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
9322 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
9323 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
9324 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
9325 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
9326 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
9327 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
9328 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
9329 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
9330 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
9331 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
9332 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
9333 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
9334 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
9335 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
9336 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
9337 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
9338 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
9339 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
9340 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
9341 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
9342 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
9343 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
9344 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
9345 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
9346 [bh2]: https://github.com/rust-lang/rust/pull/28156
9347 [binfat]: https://github.com/rust-lang/rust/pull/28270
9348 [bm]: https://github.com/rust-lang/rust/pull/28197
9349 [cc]: https://github.com/rust-lang/rust/pull/27531
9350 [crlf]: https://github.com/rust-lang/rust/pull/28034
9351 [cu]: https://github.com/rust-lang/cargo/pull/1931
9352 [d]: https://github.com/rust-lang/rust/pull/27825
9353 [dep]: https://github.com/rust-lang/rust/pull/28339
9354 [es]: https://github.com/rust-lang/rust/pull/27956
9355 [ext]: https://github.com/rust-lang/rust/pull/28094
9356 [faststr]: https://github.com/rust-lang/rust/pull/28338
9357 [ffi]: https://github.com/rust-lang/rust/pull/28779
9358 [fp]: https://github.com/rust-lang/rust/pull/28268
9359 [fp2]: https://github.com/rust-lang/rust/pull/28560
9360 [fp3]: https://github.com/rust-lang/rust/pull/27307
9361 [i]: https://github.com/rust-lang/rust/pull/27451
9362 [into2]: https://github.com/rust-lang/rust/pull/28039
9363 [it]: https://github.com/rust-lang/rust/pull/27652
9364 [mm]: https://github.com/rust-lang/rust/pull/27338
9365 [mutw]: https://github.com/rust-lang/rust/pull/28368
9366 [sound]: https://github.com/rust-lang/rust/pull/27641
9367 [p]: https://github.com/rust-lang/rust/pull/27866
9368 [pec]: https://github.com/rust-lang/rust/pull/28486
9369 [pr]: https://github.com/rust-lang/rust/pull/27896
9370 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9371 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
9372 [s]: https://github.com/rust-lang/rust/pull/27474
9373 [stab]: https://github.com/rust-lang/rust/pull/28339
9374 [stat]: https://github.com/rust-lang/rust/pull/28321
9375 [vd]: https://github.com/rust-lang/rust/pull/28494
9376
9377 Version 1.3.0 (2015-09-17)
9378 ==============================
9379
9380 * ~900 changes, numerous bugfixes
9381
9382 Highlights
9383 ----------
9384
9385 * The [new object lifetime defaults][nold] have been [turned
9386   on][nold2] after a cycle of warnings about the change. Now types
9387   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
9388   being interpreted as `&'a Box<Trait+'a>` to `&'a
9389   Box<Trait+'static>`.
9390 * [The Rustonomicon][nom] is a new book in the official documentation
9391   that dives into writing unsafe Rust.
9392 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
9393   timekeeping is employed by other std APIs, as well as out-of-tree
9394   time crates.
9395
9396 Breaking Changes
9397 ----------------
9398
9399 * The [new object lifetime defaults][nold] have been [turned
9400   on][nold2] after a cycle of warnings about the change.
9401 * There is a known [regression][lr] in how object lifetime elision is
9402   interpreted, the proper solution for which is undetermined.
9403 * The `#[prelude_import]` attribute, an internal implementation
9404   detail, was accidentally stabilized previously. [It has been put
9405   behind the `prelude_import` feature gate][pi]. This change is
9406   believed to break no existing code.
9407 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9408   [more sane for dynamically sized types][dst3]. Code that relied on
9409   the previous behavior is thought to be broken.
9410 * The `dropck` rules, which checks that destructors can't access
9411   destroyed values, [have been updated][dropck] to match the
9412   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
9413   cause some previously-compiling code to no longer build.
9414
9415 Language
9416 --------
9417
9418 * The [new object lifetime defaults][nold] have been [turned
9419   on][nold2] after a cycle of warnings about the change.
9420 * Semicolons may [now follow types and paths in
9421   macros](https://github.com/rust-lang/rust/pull/27000).
9422 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9423   [more sane for dynamically sized types][dst3]. Code that relied on
9424   the previous behavior is not known to exist, and suspected to be
9425   broken.
9426 * `'static` variables [may now be recursive][st].
9427 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
9428   implementations correctly.
9429 * The `dropck` rules, which checks that destructors can't access
9430   destroyed values, [have been updated][dropck] to match the
9431   [RFC][dropckrfc].
9432
9433 Libraries
9434 ---------
9435
9436 * The [`Duration`] API, [has been stabilized][ds], as well as the
9437   `std::time` module, which presently contains only `Duration`.
9438 * `Box<str>` and `Box<[T]>` both implement `Clone`.
9439 * The owned C string, [`CString`], implements [`Borrow`] and the
9440   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
9441   these allow C strings to be borrowed and cloned in generic code.
9442 * [`CStr`] implements [`Debug`].
9443 * [`AtomicPtr`] implements [`Debug`].
9444 * [`Error`] trait objects [can be downcast to their concrete types][e]
9445   in many common configurations, using the [`is`], [`downcast`],
9446   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
9447   [`Any`] trait.
9448 * Searching for substrings now [employs the two-way algorithm][search]
9449   instead of doing a naive search. This gives major speedups to a
9450   number of methods, including [`contains`][sc], [`find`][sf],
9451   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
9452   [`ends_with`][sew] are also faster.
9453 * The performance of `PartialEq` for slices is [much faster][ps].
9454 * The [`Hash`] trait offers the default method, [`hash_slice`], which
9455   is overridden and optimized by the implementations for scalars.
9456 * The [`Hasher`] trait now has a number of specialized `write_*`
9457   methods for primitive types, for efficiency.
9458 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
9459   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
9460   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
9461   of [`std::error::Error::cause`][iec] also delegates to the inner
9462   error.
9463 * [`process::Child`][pc] gained the [`id`] method, which returns a
9464   `u32` representing the platform-specific process identifier.
9465 * The [`connect`] method on slices is deprecated, replaced by the new
9466   [`join`] method (note that both of these are on the *unstable*
9467   [`SliceConcatExt`] trait, but through the magic of the prelude are
9468   available to stable code anyway).
9469 * The [`Div`] operator is implemented for [`Wrapping`] types.
9470 * [`DerefMut` is implemented for `String`][dms].
9471 * Performance of SipHash (the default hasher for `HashMap`) is
9472   [better for long data][sh].
9473 * [`AtomicPtr`] implements [`Send`].
9474 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
9475   are now [specialized to use uninitialized buffers for increased
9476   performance][rte].
9477 * Lifetime parameters of foreign functions [are now resolved
9478   properly][f].
9479
9480 Misc
9481 ----
9482
9483 * Rust can now, with some coercion, [produce programs that run on
9484   Windows XP][xp], though XP is not considered a supported platform.
9485 * Porting Rust on Windows from the GNU toolchain to MSVC continues
9486   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
9487   recommended for use in 1.3, though should be fully-functional
9488   in the [64-bit 1.4 beta][b14].
9489 * On Fedora-based systems installation will [properly configure the
9490   dynamic linker][fl].
9491 * The compiler gained many new extended error descriptions, which can
9492   be accessed with the `--explain` flag.
9493 * The `dropck` pass, which checks that destructors can't access
9494   destroyed values, [has been rewritten][27261]. This fixes some
9495   soundness holes, and as such will cause some previously-compiling
9496   code to no longer build.
9497 * `rustc` now uses [LLVM to write archive files where possible][ar].
9498   Eventually this will eliminate the compiler's dependency on the ar
9499   utility.
9500 * Rust has [preliminary support for i686 FreeBSD][26959] (it has long
9501   supported FreeBSD on x86_64).
9502 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
9503   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
9504   more strict.
9505 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
9506   will kill the process instead of leaking][nlp].
9507
9508 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
9509 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
9510 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
9511 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
9512 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
9513 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9514 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9515 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
9516 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
9517 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
9518 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
9519 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
9520 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
9521 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9522 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
9523 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
9524 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
9525 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
9526 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9527 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
9528 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
9529 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
9530 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
9531 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9532 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
9533 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
9534 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
9535 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
9536 [ar]: https://github.com/rust-lang/rust/pull/26926
9537 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
9538 [dms]: https://github.com/rust-lang/rust/pull/26241
9539 [27261]: https://github.com/rust-lang/rust/pull/27261
9540 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9541 [ds]: https://github.com/rust-lang/rust/pull/26818
9542 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
9543 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
9544 [dst3]: https://github.com/rust-lang/rust/pull/27351
9545 [e]: https://github.com/rust-lang/rust/pull/24793
9546 [f]: https://github.com/rust-lang/rust/pull/26588
9547 [26959]: https://github.com/rust-lang/rust/pull/26959
9548 [fl]: https://github.com/rust-lang/rust-installer/pull/41
9549 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
9550 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
9551 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
9552 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
9553 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
9554 [lic]: https://github.com/rust-lang/rust/pull/26583
9555 [lnu]: https://github.com/rust-lang/rust/pull/27026
9556 [lr]: https://github.com/rust-lang/rust/issues/27248
9557 [lum]: https://github.com/rust-lang/rust/pull/26378
9558 [lur]: https://github.com/rust-lang/rust/pull/26783
9559 [nlp]: https://github.com/rust-lang/rust/pull/27176
9560 [nold2]: https://github.com/rust-lang/rust/pull/27045
9561 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
9562 [nom]: http://doc.rust-lang.org/nightly/nomicon/
9563 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
9564 [pi]: https://github.com/rust-lang/rust/pull/26699
9565 [ps]: https://github.com/rust-lang/rust/pull/26884
9566 [rte]: https://github.com/rust-lang/rust/pull/26950
9567 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
9568 [search]: https://github.com/rust-lang/rust/pull/26327
9569 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
9570 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
9571 [sh]: https://github.com/rust-lang/rust/pull/27280
9572 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
9573 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
9574 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
9575 [st]: https://github.com/rust-lang/rust/pull/26630
9576 [win1]: https://github.com/rust-lang/rust/pull/26569
9577 [win2]: https://github.com/rust-lang/rust/pull/26741
9578 [win3]: https://github.com/rust-lang/rust/pull/26741
9579 [win4]: https://github.com/rust-lang/rust/pull/27210
9580 [xp]: https://github.com/rust-lang/rust/pull/26569
9581
9582 Version 1.2.0 (2015-08-07)
9583 ==========================
9584
9585 * ~1200 changes, numerous bugfixes
9586
9587 Highlights
9588 ----------
9589
9590 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9591   like `Rc` to contain types without a fixed size, arrays and trait
9592   objects, finally enabling use of `Rc<[T]>` and completing the
9593   implementation of DST.
9594 * [Parallel codegen][parcodegen] is now working again, which can
9595   substantially speed up large builds in debug mode; It also gets
9596   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9597   jobs). It's not enabled by default, but will be "in the near
9598   future". It can be activated with the `-C codegen-units=N` flag to
9599   `rustc`.
9600 * This is the first release with [experimental support for linking
9601   with the MSVC linker and lib C on Windows (instead of using the GNU
9602   variants via MinGW)][win]. It is yet recommended only for the most
9603   intrepid Rustaceans.
9604 * Benchmark compilations are showing a 30% improvement in
9605   bootstrapping over 1.1.
9606
9607 Breaking Changes
9608 ----------------
9609
9610 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9611   unicode case mapping, which is a previously-planned change in
9612   behavior and considered a bugfix.
9613 * [`mem::align_of`] now specifies [the *minimum alignment* for
9614   T][align], which is usually the alignment programs are interested
9615   in, and the same value reported by clang's
9616   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9617   break real code.
9618 * [The `#[packed]` attribute is no longer silently accepted by the
9619   compiler][packed]. This attribute did nothing and code that
9620   mentioned it likely did not work as intended.
9621 * Associated type defaults are [now behind the
9622   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9623   defaults *did not work*, but could be mentioned syntactically. As
9624   such this breakage has minimal impact.
9625
9626 Language
9627 --------
9628
9629 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9630   matching against dereferenceable values.
9631
9632 Libraries
9633 ---------
9634
9635 * The [`Extend`] trait, which grows a collection from an iterator, is
9636   implemented over iterators of references, for `String`, `Vec`,
9637   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9638   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9639 * The [`iter::once`] function returns an iterator that yields a single
9640   element, and [`iter::empty`] returns an iterator that yields no
9641   elements.
9642 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9643   over substring matches.
9644 * [`Cell`] and [`RefCell`] both implement `Eq`.
9645 * A number of methods for wrapping arithmetic are added to the
9646   integral types, [`wrapping_div`], [`wrapping_rem`],
9647   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9648   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9649   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9650   type.. It is illegal for the default arithmetic operations in Rust
9651   to overflow; the desire to wrap must be explicit.
9652 * The `{:#?}` formatting specifier [displays the alternate,
9653   pretty-printed][debugfmt] form of the `Debug` formatter. This
9654   feature was actually introduced prior to 1.0 with little
9655   fanfare.
9656 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9657   for writing data to formatted strings, similar to [`io::Write`].
9658 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9659   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9660   are used by code generators to emit implementations of [`Debug`].
9661 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9662   methods that convert case, following Unicode case mapping.
9663 * It is now easier to handle poisoned locks. The [`PoisonError`]
9664   type, returned by failing lock operations, exposes `into_inner`,
9665   `get_ref`, and `get_mut`, which all give access to the inner lock
9666   guard, and allow the poisoned lock to continue to operate. The
9667   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9668   poisoned lock without attempting to take the lock.
9669 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9670   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9671   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9672   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9673   `ChildStderr`.
9674 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9675   malformed input.
9676
9677 Misc
9678 ----
9679
9680 * `rustc` employs smarter heuristics for guessing at [typos].
9681 * `rustc` emits more efficient code for [no-op conversions between
9682   unsafe pointers][nop].
9683 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9684   resulting in faster compile times and smaller code.
9685
9686 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9687 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9688 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9689 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9690 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9691 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9692 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9693 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9694 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9695 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9696 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9697 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9698 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9699 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9700 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9701 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9702 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9703 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9704 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9705 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9706 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9707 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9708 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9709 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9710 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9711 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9712 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9713 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9714 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9715 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9716 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9717 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9718 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9719 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9720 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9721 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9722 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9723 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9724 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9725 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9726 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9727 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9728 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9729 [align]: https://github.com/rust-lang/rust/pull/25646
9730 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9731 [typos]: https://github.com/rust-lang/rust/pull/26087
9732 [nop]: https://github.com/rust-lang/rust/pull/26336
9733 [fat]: https://github.com/rust-lang/rust/pull/26411
9734 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9735 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9736 [packed]: https://github.com/rust-lang/rust/pull/25541
9737 [ad]: https://github.com/rust-lang/rust/pull/27382
9738 [win]: https://github.com/rust-lang/rust/pull/25350
9739
9740 Version 1.1.0 (2015-06-25)
9741 =========================
9742
9743 * ~850 changes, numerous bugfixes
9744
9745 Highlights
9746 ----------
9747
9748 * The [`std::fs` module has been expanded][fs] to expand the set of
9749   functionality exposed:
9750   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9751     don't incur a syscall on some platforms.
9752   * A `symlink_metadata` function has been added.
9753   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9754     access to all underlying information.
9755 * The compiler now contains extended explanations of many errors. When an error
9756   with an explanation occurs the compiler suggests using the `--explain` flag
9757   to read the explanation. Error explanations are also [available online][err-index].
9758 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9759   well as other work, the time to bootstrap the compiler decreased by
9760   32%.
9761
9762 Libraries
9763 ---------
9764
9765 * The [`str::split_whitespace`] method splits a string on unicode
9766   whitespace boundaries.
9767 * On both Windows and Unix, new extension traits provide conversion of
9768   I/O types to and from the underlying system handles. On Unix, these
9769   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9770   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9771   `TcpListener`, and `UpdSocket`. Further implementations for
9772   `std::process` will be stabilized later.
9773 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9774   Windows, symlinks can be created with
9775   `std::os::windows::symlink_dir` and
9776   `std::os::windows::symlink_file`.
9777 * The `mpsc::Receiver` type can now be converted into an iterator with
9778   `into_iter` on the [`IntoIterator`] trait.
9779 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9780   implementation of the [`From`] trait.
9781 * The `Debug` implementation for `RangeFull` [creates output that is
9782   more consistent with other implementations][rf].
9783 * [`Debug` is implemented for `File`][file].
9784 * The `Default` implementation for `Arc` [no longer requires `Sync +
9785   Send`][arc].
9786 * [The `Iterator` methods `count`, `nth`, and `last` have been
9787   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9788 * Incorrect handling of paths on Windows has been improved in both the
9789   compiler and the standard library.
9790 * [`AtomicPtr` gained a `Default` implementation][ap].
9791 * In accordance with Rust's policy on arithmetic overflow `abs` now
9792   [panics on overflow when debug assertions are enabled][abs].
9793 * The [`Cloned`] iterator, which was accidentally left unstable for
9794   1.0 [has been stabilized][c].
9795 * The [`Incoming`] iterator, which iterates over incoming TCP
9796   connections, and which was accidentally unnamable in 1.0, [is now
9797   properly exported][inc].
9798 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9799   `sift_up` or `sift_down` panic][bh].
9800 * The [`split_off`] method of `LinkedList` [no longer corrupts
9801   the list in certain scenarios][ll].
9802
9803 Misc
9804 ----
9805
9806 * Type checking performance [has improved notably][sk] with
9807   [multiple improvements][pre].
9808 * The compiler [suggests code changes][ch] for more errors.
9809 * rustc and it's build system have experimental support for [building
9810   toolchains against MUSL][m] instead of glibc on Linux.
9811 * The compiler defines the `target_env` cfg value, which is used for
9812   distinguishing toolchains that are otherwise for the same
9813   platform. Presently this is set to `gnu` for common GNU Linux
9814   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9815 * The [`cargo rustc`][crc] command invokes a build with custom flags
9816   to rustc.
9817 * [Android executables are always position independent][pie].
9818 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9819   with `Drop`][24935].
9820
9821 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9822 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9823 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9824 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9825 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9826 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9827 [rf]: https://github.com/rust-lang/rust/pull/24491
9828 [err-index]: https://doc.rust-lang.org/error-index.html
9829 [sk]: https://github.com/rust-lang/rust/pull/24615
9830 [pre]: https://github.com/rust-lang/rust/pull/25323
9831 [file]: https://github.com/rust-lang/rust/pull/24598
9832 [ch]: https://github.com/rust-lang/rust/pull/24683
9833 [arc]: https://github.com/rust-lang/rust/pull/24695
9834 [si]: https://github.com/rust-lang/rust/pull/24701
9835 [ap]: https://github.com/rust-lang/rust/pull/24834
9836 [m]: https://github.com/rust-lang/rust/pull/24777
9837 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9838 [crc]: https://github.com/rust-lang/cargo/pull/1568
9839 [pie]: https://github.com/rust-lang/rust/pull/24953
9840 [abs]: https://github.com/rust-lang/rust/pull/25441
9841 [c]: https://github.com/rust-lang/rust/pull/25496
9842 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9843 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9844 [inc]: https://github.com/rust-lang/rust/pull/25522
9845 [bh]: https://github.com/rust-lang/rust/pull/25856
9846 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9847 [ll]: https://github.com/rust-lang/rust/pull/26022
9848 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9849 [24935]: https://github.com/rust-lang/rust/pull/24935
9850
9851 Version 1.0.0 (2015-05-15)
9852 ========================
9853
9854 * ~1500 changes, numerous bugfixes
9855
9856 Highlights
9857 ----------
9858
9859 * The vast majority of the standard library is now `#[stable]`. It is
9860   no longer possible to use unstable features with a stable build of
9861   the compiler.
9862 * Many popular crates on [crates.io] now work on the stable release
9863   channel.
9864 * Arithmetic on basic integer types now [checks for overflow in debug
9865   builds][overflow].
9866
9867 Language
9868 --------
9869
9870 * Several [restrictions have been added to trait coherence][coh] in
9871   order to make it easier for upstream authors to change traits
9872   without breaking downstream code.
9873 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9874   improve error messages and macro behavior. For example, `0b1234` is
9875   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9876 * Trait bounds [are always invariant][inv], eliminating the need for
9877   the `PhantomFn` and `MarkerTrait` lang items, which have been
9878   removed.
9879 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9880   "foo" as bar` syntax has been replaced with `extern crate foo as
9881   bar`, and Cargo now automatically translates "-" in *package* names
9882   to underscore for the crate name.
9883 * [Lifetime shadowing is an error][lt].
9884 * [`Send` no longer implies `'static`][send-rfc].
9885 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9886   `MyType::default()`.
9887 * Primitive types [now have inherent methods][prim-inherent],
9888   obviating the need for extension traits like `SliceExt`.
9889 * Methods with `Self: Sized` in their `where` clause are [considered
9890   object-safe][self-sized], allowing many extension traits like
9891   `IteratorExt` to be merged into the traits they extended.
9892 * You can now [refer to associated types][assoc-where] whose
9893   corresponding trait bounds appear only in a `where` clause.
9894 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9895   like `Send` and `Sync` are now library-defined.
9896 * A [Reflect trait][reflect] was introduced, which means that
9897   downcasting via the `Any` trait is effectively limited to concrete
9898   types. This helps retain the potentially-important "parametricity"
9899   property: generic code cannot behave differently for different type
9900   arguments except in minor ways.
9901 * The `unsafe_destructor` feature is now deprecated in favor of the
9902   [new `dropck`][rfc769]. This change is a major reduction in unsafe
9903   code.
9904
9905 Libraries
9906 ---------
9907
9908 * The `thread_local` module [has been renamed to `std::thread`][th].
9909 * The methods of `IteratorExt` [have been moved to the `Iterator`
9910   trait itself][23300].
9911 * Several traits that implement Rust's conventions for type
9912   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9913   [centralized in the `std::convert` module][con].
9914 * The `FromError` trait [was removed in favor of `From`][fe].
9915 * The basic sleep function [has moved to
9916   `std::thread::sleep_ms`][slp].
9917 * The `splitn` function now takes an `n` parameter that represents the
9918   number of items yielded by the returned iterator [instead of the
9919   number of 'splits'][spl].
9920 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9921 * [Derived implementations of `PartialOrd` now order enums according
9922   to their explicitly-assigned discriminants][po].
9923 * [Methods for searching strings are generic over `Pattern`s][pat],
9924   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9925   some others.
9926 * [In method resolution, object methods are resolved before inherent
9927   methods][meth].
9928 * [`String::from_str` has been deprecated in favor of the `From` impl,
9929   `String::from`][24517].
9930 * [`io::Error` implements `Sync`][ios].
9931 * [The `words` method on `&str` has been replaced with
9932   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9933   a word?'
9934 * The new path and IO modules are complete and `#[stable]`. This
9935   was the major library focus for this cycle.
9936 * The path API was [revised][path-normalize] to normalize `.`,
9937   adjusting the tradeoffs in favor of the most common usage.
9938 * A large number of remaining APIs in `std` were also stabilized
9939   during this cycle; about 75% of the non-deprecated API surface
9940   is now stable.
9941 * The new [string pattern API][string-pattern] landed, which makes
9942   the string slice API much more internally consistent and flexible.
9943 * A new set of [generic conversion traits][conversion] replaced
9944   many existing ad hoc traits.
9945 * Generic numeric traits were [completely removed][num-traits]. This
9946   was made possible thanks to inherent methods for primitive types,
9947   and the removal gives maximal flexibility for designing a numeric
9948   hierarchy in the future.
9949 * The `Fn` traits are now related via [inheritance][fn-inherit]
9950   and provide ergonomic [blanket implementations][fn-blanket].
9951 * The `Index` and `IndexMut` traits were changed to
9952   [take the index by value][index-value], enabling code like
9953   `hash_map["string"]` to work.
9954 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9955   `Copy` data is known to be `Clone` as well.
9956
9957 Misc
9958 ----
9959
9960 * Many errors now have extended explanations that can be accessed with
9961   the `--explain` flag to `rustc`.
9962 * Many new examples have been added to the standard library
9963   documentation.
9964 * rustdoc has received a number of improvements focused on completion
9965   and polish.
9966 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9967 * Much headway was made on ecosystem-wide CI, making it possible
9968   to [compare builds for breakage][ci-compare].
9969
9970
9971 [crates.io]: http://crates.io
9972 [clo]: https://github.com/rust-lang/rust/pull/24034
9973 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9974 [con]: https://github.com/rust-lang/rust/pull/23875
9975 [cr]: https://github.com/rust-lang/rust/pull/23419
9976 [fe]: https://github.com/rust-lang/rust/pull/23879
9977 [23300]: https://github.com/rust-lang/rust/pull/23300
9978 [inv]: https://github.com/rust-lang/rust/pull/23938
9979 [ios]: https://github.com/rust-lang/rust/pull/24133
9980 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9981 [lt]: https://github.com/rust-lang/rust/pull/24057
9982 [meth]: https://github.com/rust-lang/rust/pull/24056
9983 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9984 [po]: https://github.com/rust-lang/rust/pull/24270
9985 [24517]: https://github.com/rust-lang/rust/pull/24517
9986 [slp]: https://github.com/rust-lang/rust/pull/23949
9987 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9988 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9989 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9990 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9991 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9992 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9993 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9994 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9995 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9996 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9997 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9998 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9999 [reflect]: https://github.com/rust-lang/rust/pull/23712
10000 [conversion]: https://github.com/rust-lang/rfcs/pull/529
10001 [num-traits]: https://github.com/rust-lang/rust/pull/23549
10002 [index-value]: https://github.com/rust-lang/rust/pull/23601
10003 [rfc769]: https://github.com/rust-lang/rfcs/pull/769
10004 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
10005 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
10006 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
10007 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
10008 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
10009
10010
10011 Version 1.0.0-alpha.2 (2015-02-20)
10012 =====================================
10013
10014 * ~1300 changes, numerous bugfixes
10015
10016 * Highlights
10017
10018     * The various I/O modules were [overhauled][io-rfc] to reduce
10019       unnecessary abstractions and provide better interoperation with
10020       the underlying platform. The old `io` module remains temporarily
10021       at `std::old_io`.
10022     * The standard library now [participates in feature gating][feat],
10023       so use of unstable libraries now requires a `#![feature(...)]`
10024       attribute. The impact of this change is [described on the
10025       forum][feat-forum]. [RFC][feat-rfc].
10026
10027 * Language
10028
10029     * `for` loops [now operate on the `IntoIterator` trait][into],
10030       which eliminates the need to call `.iter()`, etc. to iterate
10031       over collections. There are some new subtleties to remember
10032       though regarding what sort of iterators various types yield, in
10033       particular that `for foo in bar { }` yields values from a move
10034       iterator, destroying the original collection. [RFC][into-rfc].
10035     * Objects now have [default lifetime bounds][obj], so you don't
10036       have to write `Box<Trait+'static>` when you don't care about
10037       storing references. [RFC][obj-rfc].
10038     * In types that implement `Drop`, [lifetimes must outlive the
10039       value][drop]. This will soon make it possible to safely
10040       implement `Drop` for types where `#[unsafe_destructor]` is now
10041       required. Read the [gorgeous RFC][drop-rfc] for details.
10042     * The fully qualified <T as Trait>::X syntax lets you set the Self
10043       type for a trait method or associated type. [RFC][ufcs-rfc].
10044     * References to types that implement `Deref<U>` now [automatically
10045       coerce to references][deref] to the dereferenced type `U`,
10046       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
10047       should eliminate many unsightly uses of `&*`, as when converting
10048       from references to vectors into references to
10049       slices. [RFC][deref-rfc].
10050     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
10051       `|:|`) is obsolete and closure kind is inferred from context.
10052     * [`Self` is a keyword][Self].
10053
10054 * Libraries
10055
10056     * The `Show` and `String` formatting traits [have been
10057       renamed][fmt] to `Debug` and `Display` to more clearly reflect
10058       their related purposes. Automatically getting a string
10059       conversion to use with `format!("{:?}", something_to_debug)` is
10060       now written `#[derive(Debug)]`.
10061     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
10062       OsStr}`, provide strings in platform-specific encodings for easier
10063       interop with system APIs. [RFC][osstr-rfc].
10064     * The `boxed::into_raw` and `Box::from_raw` functions [convert
10065       between `Box<T>` and `*mut T`][boxraw], a common pattern for
10066       creating raw pointers.
10067
10068 * Tooling
10069
10070     * Certain long error messages of the form 'expected foo found bar'
10071       are now [split neatly across multiple
10072       lines][multiline]. Examples in the PR.
10073     * On Unix Rust can be [uninstalled][un] by running
10074       `/usr/local/lib/rustlib/uninstall.sh`.
10075     * The `#[rustc_on_unimplemented]` attribute, requiring the
10076       'on_unimplemented' feature, lets rustc [display custom error
10077       messages when a trait is expected to be implemented for a type
10078       but is not][onun].
10079
10080 * Misc
10081
10082     * Rust is tested against a [LALR grammar][lalr], which parses
10083       almost all the Rust files that rustc does.
10084
10085 [boxraw]: https://github.com/rust-lang/rust/pull/21318
10086 [close]: https://github.com/rust-lang/rust/pull/21843
10087 [deref]: https://github.com/rust-lang/rust/pull/21351
10088 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
10089 [drop]: https://github.com/rust-lang/rust/pull/21972
10090 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
10091 [feat]: https://github.com/rust-lang/rust/pull/21248
10092 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
10093 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
10094 [fmt]: https://github.com/rust-lang/rust/pull/21457
10095 [into]: https://github.com/rust-lang/rust/pull/20790
10096 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
10097 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
10098 [lalr]: https://github.com/rust-lang/rust/pull/21452
10099 [multiline]: https://github.com/rust-lang/rust/pull/19870
10100 [obj]: https://github.com/rust-lang/rust/pull/22230
10101 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
10102 [onun]: https://github.com/rust-lang/rust/pull/20889
10103 [osstr]: https://github.com/rust-lang/rust/pull/21488
10104 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
10105 [Self]: https://github.com/rust-lang/rust/pull/22158
10106 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
10107 [un]: https://github.com/rust-lang/rust/pull/22256
10108
10109
10110 Version 1.0.0-alpha (2015-01-09)
10111 ==================================
10112
10113   * ~2400 changes, numerous bugfixes
10114
10115   * Highlights
10116
10117     * The language itself is considered feature complete for 1.0,
10118       though there will be many usability improvements and bugfixes
10119       before the final release.
10120     * Nearly 50% of the public API surface of the standard library has
10121       been declared 'stable'. Those interfaces are unlikely to change
10122       before 1.0.
10123     * The long-running debate over integer types has been
10124       [settled][ints]: Rust will ship with types named `isize` and
10125       `usize`, rather than `int` and `uint`, for pointer-sized
10126       integers. Guidelines will be rolled out during the alpha cycle.
10127     * Most crates that are not `std` have been moved out of the Rust
10128       distribution into the Cargo ecosystem so they can evolve
10129       separately and don't need to be stabilized as quickly, including
10130       'time', 'getopts', 'num', 'regex', and 'term'.
10131     * Documentation continues to be expanded with more API coverage, more
10132       examples, and more in-depth explanations. The guides have been
10133       consolidated into [The Rust Programming Language][trpl].
10134     * "[Rust By Example][rbe]" is now maintained by the Rust team.
10135     * All official Rust binary installers now come with [Cargo], the
10136       Rust package manager.
10137
10138 * Language
10139
10140     * Closures have been [completely redesigned][unboxed] to be
10141       implemented in terms of traits, can now be used as generic type
10142       bounds and thus monomorphized and inlined, or via an opaque
10143       pointer (boxed) as in the old system. The new system is often
10144       referred to as 'unboxed' closures.
10145     * Traits now support [associated types][assoc], allowing families
10146       of related types to be defined together and used generically in
10147       powerful ways.
10148     * Enum variants are [namespaced by their type names][enum].
10149     * [`where` clauses][where] provide a more versatile and attractive
10150       syntax for specifying generic bounds, though the previous syntax
10151       remains valid.
10152     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
10153       numeric types.
10154     * Rust [no longer has a runtime][rt] of any description, and only
10155       supports OS threads, not green threads.
10156     * At long last, Rust has been overhauled for 'dynamically-sized
10157       types' ([DST]), which integrates 'fat pointers' (object types,
10158       arrays, and `str`) more deeply into the type system, making it
10159       more consistent.
10160     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
10161       `..j` that produce range types and which, when combined with the
10162       `Index` operator and multidispatch, leads to a convenient slice
10163       notation, `[i..j]`.
10164     * The new range syntax revealed an ambiguity in the fixed-length
10165       array syntax, so now fixed length arrays [are written `[T;
10166       N]`][arrays].
10167     * The `Copy` trait is no longer implemented automatically. Unsafe
10168       pointers no longer implement `Sync` and `Send` so types
10169       containing them don't automatically either. `Sync` and `Send`
10170       are now 'unsafe traits' so one can "forcibly" implement them via
10171       `unsafe impl` if a type confirms to the requirements for them
10172       even though the internals do not (e.g. structs containing unsafe
10173       pointers like `Arc`). These changes are intended to prevent some
10174       footguns and are collectively known as [opt-in built-in
10175       traits][oibit] (though `Sync` and `Send` will soon become pure
10176       library types unknown to the compiler).
10177     * Operator traits now take their operands [by value][ops], and
10178       comparison traits can use multidispatch to compare one type
10179       against multiple other types, allowing e.g. `String` to be
10180       compared with `&str`.
10181     * `if let` and `while let` are no longer feature-gated.
10182     * Rust has adopted a more [uniform syntax for escaping unicode
10183       characters][unicode].
10184     * `macro_rules!` [has been declared stable][mac]. Though it is a
10185       flawed system it is sufficiently popular that it must be usable
10186       for 1.0. Effort has gone into [future-proofing][mac-future] it
10187       in ways that will allow other macro systems to be developed in
10188       parallel, and won't otherwise impact the evolution of the
10189       language.
10190     * The prelude has been [pared back significantly][prelude] such
10191       that it is the minimum necessary to support the most pervasive
10192       code patterns, and through [generalized where clauses][where]
10193       many of the prelude extension traits have been consolidated.
10194     * Rust's rudimentary reflection [has been removed][refl], as it
10195       incurred too much code generation for little benefit.
10196     * [Struct variants][structvars] are no longer feature-gated.
10197     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
10198       known as 'higher-ranked trait bounds', this crucially allows
10199       unboxed closures to work.
10200     * Macros invocations surrounded by parens or square brackets and
10201       not terminated by a semicolon are [parsed as
10202       expressions][macros], which makes expressions like `vec![1i32,
10203       2, 3].len()` work as expected.
10204     * Trait objects now implement their traits automatically, and
10205       traits that can be coerced to objects now must be [object
10206       safe][objsafe].
10207     * Automatically deriving traits is now done with `#[derive(...)]`
10208       not `#[deriving(...)]` for [consistency with other naming
10209       conventions][derive].
10210     * Importing the containing module or enum at the same time as
10211       items or variants they contain is [now done with `self` instead
10212       of `mod`][self], as in use `foo::{self, bar}`
10213     * Glob imports are no longer feature-gated.
10214     * The `box` operator and `box` patterns have been feature-gated
10215       pending a redesign. For now unique boxes should be allocated
10216       like other containers, with `Box::new`.
10217
10218 * Libraries
10219
10220     * A [series][coll1] of [efforts][coll2] to establish
10221       [conventions][coll3] for collections types has resulted in API
10222       improvements throughout the standard library.
10223     * New [APIs for error handling][err] provide ergonomic interop
10224       between error types, and [new conventions][err-conv] describe
10225       more clearly the recommended error handling strategies in Rust.
10226     * The `fail!` macro has been renamed to [`panic!`][panic] so that
10227       it is easier to discuss failure in the context of error handling
10228       without making clarifications as to whether you are referring to
10229       the 'fail' macro or failure more generally.
10230     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
10231       syscall when available.
10232     * The 'serialize' crate has been renamed 'rustc-serialize' and
10233       moved out of the distribution to Cargo. Although it is widely
10234       used now, it is expected to be superseded in the near future.
10235     * The `Show` formatter, typically implemented with
10236       `#[derive(Show)]` is [now requested with the `{:?}`
10237       specifier][show] and is intended for use by all types, for uses
10238       such as `println!` debugging. The new `String` formatter must be
10239       implemented by hand, uses the `{}` specifier, and is intended
10240       for full-fidelity conversions of things that can logically be
10241       represented as strings.
10242
10243 * Tooling
10244
10245     * [Flexible target specification][flex] allows rustc's code
10246       generation to be configured to support otherwise-unsupported
10247       platforms.
10248     * Rust comes with rust-gdb and rust-lldb scripts that launch their
10249       respective debuggers with Rust-appropriate pretty-printing.
10250     * The Windows installation of Rust is distributed with the
10251       MinGW components currently required to link binaries on that
10252       platform.
10253
10254 * Misc
10255
10256     * Nullable enum optimizations have been extended to more types so
10257       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
10258       space than the inner types themselves.
10259     * Work has begun on supporting AArch64.
10260
10261 [Cargo]: https://crates.io
10262 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
10263 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
10264 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
10265 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
10266 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
10267 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
10268 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
10269 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
10270 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
10271 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
10272 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
10273 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
10274 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
10275 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
10276 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
10277 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
10278 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
10279 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
10280 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
10281 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
10282 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
10283 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
10284 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
10285 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
10286 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
10287 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
10288 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
10289 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
10290 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
10291 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
10292 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
10293 [trpl]: https://doc.rust-lang.org/book/index.html
10294 [rbe]: http://rustbyexample.com/
10295
10296
10297 Version 0.12.0 (2014-10-09)
10298 =============================
10299
10300   * ~1900 changes, numerous bugfixes
10301
10302   * Highlights
10303
10304     * The introductory documentation (now called The Rust Guide) has
10305       been completely rewritten, as have a number of supplementary
10306       guides.
10307     * Rust's package manager, Cargo, continues to improve and is
10308       sometimes considered to be quite awesome.
10309     * Many API's in `std` have been reviewed and updated for
10310       consistency with the in-development Rust coding
10311       guidelines. The standard library documentation tracks
10312       stabilization progress.
10313     * Minor libraries have been moved out-of-tree to the rust-lang org
10314       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
10315       be installed with Cargo.
10316     * Lifetime elision allows lifetime annotations to be left off of
10317       function declarations in many common scenarios.
10318     * Rust now works on 64-bit Windows.
10319
10320   * Language
10321     * Indexing can be overloaded with the `Index` and `IndexMut`
10322       traits.
10323     * The `if let` construct takes a branch only if the `let` pattern
10324       matches, currently behind the 'if_let' feature gate.
10325     * 'where clauses', a more flexible syntax for specifying trait
10326       bounds that is more aesthetic, have been added for traits and
10327       free functions. Where clauses will in the future make it
10328       possible to constrain associated types, which would be
10329       impossible with the existing syntax.
10330     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
10331       the 'slicing_syntax' feature gate, and can be overloaded with
10332       the `Slice` or `SliceMut` traits.
10333     * The syntax for matching of sub-slices has been changed to use a
10334       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
10335       consistency with other uses of `..` and to future-proof
10336       potential additional uses of the syntax.
10337     * The syntax for matching inclusive ranges in patterns has changed
10338       from `0..3` to `0...4` to be consistent with the exclusive range
10339       syntax for slicing.
10340     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
10341       c]`) has been put behind the 'advanced_slice_patterns' feature
10342       gate and may be removed in the future.
10343     * Components of tuples and tuple structs can be extracted using
10344       the `value.0` syntax, currently behind the `tuple_indexing`
10345       feature gate.
10346     * The `#[crate_id]` attribute is no longer supported; versioning
10347       is handled by the package manager.
10348     * Renaming crate imports are now written `extern crate foo as bar`
10349       instead of `extern crate bar = foo`.
10350     * Renaming use statements are now written `use foo as bar` instead
10351       of `use bar = foo`.
10352     * `let` and `match` bindings and argument names in macros are now
10353       hygienic.
10354     * The new, more efficient, closure types ('unboxed closures') have
10355       been added under a feature gate, 'unboxed_closures'. These will
10356       soon replace the existing closure types, once higher-ranked
10357       trait lifetimes are added to the language.
10358     * `move` has been added as a keyword, for indicating closures
10359       that capture by value.
10360     * Mutation and assignment is no longer allowed in pattern guards.
10361     * Generic structs and enums can now have trait bounds.
10362     * The `Share` trait is now called `Sync` to free up the term
10363       'shared' to refer to 'shared reference' (the default reference
10364       type.
10365     * Dynamically-sized types have been mostly implemented,
10366       unifying the behavior of fat-pointer types with the rest of the
10367       type system.
10368     * As part of dynamically-sized types, the `Sized` trait has been
10369       introduced, which qualifying types implement by default, and
10370       which type parameters expect by default. To specify that a type
10371       parameter does not need to be sized, write `<Sized? T>`. Most
10372       types are `Sized`, notable exceptions being unsized arrays
10373       (`[T]`) and trait types.
10374     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
10375     * Lifetime bounds can now be applied to type parameters and object
10376       types.
10377     * The old, reference counted GC type, `Gc<T>` which was once
10378       denoted by the `@` sigil, has finally been removed. GC will be
10379       revisited in the future.
10380
10381   * Libraries
10382     * Library documentation has been improved for a number of modules.
10383     * Bit-vectors, collections::bitv has been modernized.
10384     * The url crate is deprecated in favor of
10385       http://github.com/servo/rust-url, which can be installed with
10386       Cargo.
10387     * Most I/O stream types can be cloned and subsequently closed from
10388       a different thread.
10389     * A `std::time::Duration` type has been added for use in I/O
10390       methods that rely on timers, as well as in the 'time' crate's
10391       `Timespec` arithmetic.
10392     * The runtime I/O abstraction layer that enabled the green thread
10393       scheduler to do non-thread-blocking I/O has been removed, along
10394       with the libuv-based implementation employed by the green thread
10395       scheduler. This will greatly simplify the future I/O work.
10396     * `collections::btree` has been rewritten to have a more
10397       idiomatic and efficient design.
10398
10399   * Tooling
10400     * rustdoc output now indicates the stability levels of API's.
10401     * The `--crate-name` flag can specify the name of the crate
10402       being compiled, like `#[crate_name]`.
10403     * The `-C metadata` specifies additional metadata to hash into
10404       symbol names, and `-C extra-filename` specifies additional
10405       information to put into the output filename, for use by the
10406       package manager for versioning.
10407     * debug info generation has continued to improve and should be
10408       more reliable under both gdb and lldb.
10409     * rustc has experimental support for compiling in parallel
10410       using the `-C codegen-units` flag.
10411     * rustc no longer encodes rpath information into binaries by
10412       default.
10413
10414   * Misc
10415     * Stack usage has been optimized with LLVM lifetime annotations.
10416     * Official Rust binaries on Linux are more compatible with older
10417       kernels and distributions, built on CentOS 5.10.
10418
10419
10420 Version 0.11.0 (2014-07-02)
10421 ==========================
10422
10423   * ~1700 changes, numerous bugfixes
10424
10425   * Language
10426     * ~[T] has been removed from the language. This type is superseded by
10427       the Vec<T> type.
10428     * ~str has been removed from the language. This type is superseded by
10429       the String type.
10430     * ~T has been removed from the language. This type is superseded by the
10431       Box<T> type.
10432     * @T has been removed from the language. This type is superseded by the
10433       standard library's std::gc::Gc<T> type.
10434     * Struct fields are now all private by default.
10435     * Vector indices and shift amounts are both required to be a `uint`
10436       instead of any integral type.
10437     * Byte character, byte string, and raw byte string literals are now all
10438       supported by prefixing the normal literal with a `b`.
10439     * Multiple ABIs are no longer allowed in an ABI string
10440     * The syntax for lifetimes on closures/procedures has been tweaked
10441       slightly: `<'a>|A, B|: 'b + K -> T`
10442     * Floating point modulus has been removed from the language; however it
10443       is still provided by a library implementation.
10444     * Private enum variants are now disallowed.
10445     * The `priv` keyword has been removed from the language.
10446     * A closure can no longer be invoked through a &-pointer.
10447     * The `use foo, bar, baz;` syntax has been removed from the language.
10448     * The transmute intrinsic no longer works on type parameters.
10449     * Statics now allow blocks/items in their definition.
10450     * Trait bounds are separated from objects with + instead of : now.
10451     * Objects can no longer be read while they are mutably borrowed.
10452     * The address of a static is now marked as insignificant unless the
10453       #[inline(never)] attribute is placed it.
10454     * The #[unsafe_destructor] attribute is now behind a feature gate.
10455     * Struct literals are no longer allowed in ambiguous positions such as
10456       if, while, match, and for..in.
10457     * Declaration of lang items and intrinsics are now feature-gated by
10458       default.
10459     * Integral literals no longer default to `int`, and floating point
10460       literals no longer default to `f64`. Literals must be suffixed with an
10461       appropriate type if inference cannot determine the type of the
10462       literal.
10463     * The Box<T> type is no longer implicitly borrowed to &mut T.
10464     * Procedures are now required to not capture borrowed references.
10465
10466   * Libraries
10467     * The standard library is now a "facade" over a number of underlying
10468       libraries. This means that development on the standard library should
10469       be speedier due to smaller crates, as well as a clearer line between
10470       all dependencies.
10471     * A new library, libcore, lives under the standard library's facade
10472       which is Rust's "0-assumption" library, suitable for embedded and
10473       kernel development for example.
10474     * A regex crate has been added to the standard distribution. This crate
10475       includes statically compiled regular expressions.
10476     * The unwrap/unwrap_err methods on Result require a Show bound for
10477       better error messages.
10478     * The return types of the std::comm primitives have been centralized
10479       around the Result type.
10480     * A number of I/O primitives have gained the ability to time out their
10481       operations.
10482     * A number of I/O primitives have gained the ability to close their
10483       reading/writing halves to cancel pending operations.
10484     * Reverse iterator methods have been removed in favor of `rev()` on
10485       their forward-iteration counterparts.
10486     * A bitflags! macro has been added to enable easy interop with C and
10487       management of bit flags.
10488     * A debug_assert! macro is now provided which is disabled when
10489       `--cfg ndebug` is passed to the compiler.
10490     * A graphviz crate has been added for creating .dot files.
10491     * The std::cast module has been migrated into std::mem.
10492     * The std::local_data api has been migrated from freestanding functions
10493       to being based on methods.
10494     * The Pod trait has been renamed to Copy.
10495     * jemalloc has been added as the default allocator for types.
10496     * The API for allocating memory has been changed to use proper alignment
10497       and sized deallocation
10498     * Connecting a TcpStream or binding a TcpListener is now based on a
10499       string address and a u16 port. This allows connecting to a hostname as
10500       opposed to an IP.
10501     * The Reader trait now contains a core method, read_at_least(), which
10502       correctly handles many repeated 0-length reads.
10503     * The process-spawning API is now centered around a builder-style
10504       Command struct.
10505     * The :? printing qualifier has been moved from the standard library to
10506       an external libdebug crate.
10507     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
10508       have been renamed to Eq/Ord.
10509     * The select/plural methods have been removed from format!. The escapes
10510       for { and } have also changed from \{ and \} to {{ and }},
10511       respectively.
10512     * The TaskBuilder API has been re-worked to be a true builder, and
10513       extension traits for spawning native/green tasks have been added.
10514
10515   * Tooling
10516     * All breaking changes to the language or libraries now have their
10517       commit message annotated with `[breaking-change]` to allow for easy
10518       discovery of breaking changes.
10519     * The compiler will now try to suggest how to annotate lifetimes if a
10520       lifetime-related error occurs.
10521     * Debug info continues to be improved greatly with general bug fixes and
10522       better support for situations like link time optimization (LTO).
10523     * Usage of syntax extensions when cross-compiling has been fixed.
10524     * Functionality equivalent to GCC & Clang's -ffunction-sections,
10525       -fdata-sections and --gc-sections has been enabled by default
10526     * The compiler is now stricter about where it will load module files
10527       from when a module is declared via `mod foo;`.
10528     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
10529       Syntax extensions are now discovered via a "plugin registrar" type
10530       which will be extended in the future to other various plugins.
10531     * Lints have been restructured to allow for dynamically loadable lints.
10532     * A number of rustdoc improvements:
10533       * The HTML output has been visually redesigned.
10534       * Markdown is now powered by hoedown instead of sundown.
10535       * Searching heuristics have been greatly improved.
10536       * The search index has been reduced in size by a great amount.
10537       * Cross-crate documentation via `pub use` has been greatly improved.
10538       * Primitive types are now hyperlinked and documented.
10539     * Documentation has been moved from static.rust-lang.org/doc to
10540       doc.rust-lang.org
10541     * A new sandbox, play.rust-lang.org, is available for running and
10542       sharing rust code examples on-line.
10543     * Unused attributes are now more robustly warned about.
10544     * The dead_code lint now warns about unused struct fields.
10545     * Cross-compiling to iOS is now supported.
10546     * Cross-compiling to mipsel is now supported.
10547     * Stability attributes are now inherited by default and no longer apply
10548       to intra-crate usage, only inter-crate usage.
10549     * Error message related to non-exhaustive match expressions have been
10550       greatly improved.
10551
10552
10553 Version 0.10 (2014-04-03)
10554 =========================
10555
10556   * ~1500 changes, numerous bugfixes
10557
10558   * Language
10559     * A new RFC process is now in place for modifying the language.
10560     * Patterns with `@`-pointers have been removed from the language.
10561     * Patterns with unique vectors (`~[T]`) have been removed from the
10562       language.
10563     * Patterns with unique strings (`~str`) have been removed from the
10564       language.
10565     * `@str` has been removed from the language.
10566     * `@[T]` has been removed from the language.
10567     * `@self` has been removed from the language.
10568     * `@Trait` has been removed from the language.
10569     * Headers on `~` allocations which contain `@` boxes inside the type for
10570       reference counting have been removed.
10571     * The semantics around the lifetimes of temporary expressions have changed,
10572       see #3511 and #11585 for more information.
10573     * Cross-crate syntax extensions are now possible, but feature gated. See
10574       #11151 for more information. This includes both `macro_rules!` macros as
10575       well as syntax extensions such as `format!`.
10576     * New lint modes have been added, and older ones have been turned on to be
10577       warn-by-default.
10578       * Unnecessary parentheses
10579       * Uppercase statics
10580       * Camel Case types
10581       * Uppercase variables
10582       * Publicly visible private types
10583       * `#[deriving]` with raw pointers
10584     * Unsafe functions can no longer be coerced to closures.
10585     * Various obscure macros such as `log_syntax!` are now behind feature gates.
10586     * The `#[simd]` attribute is now behind a feature gate.
10587     * Visibility is no longer allowed on `extern crate` statements, and
10588       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10589     * Trailing commas are now allowed in argument lists and tuple patterns.
10590     * The `do` keyword has been removed, it is now a reserved keyword.
10591     * Default type parameters have been implemented, but are feature gated.
10592     * Borrowed variables through captures in closures are now considered soundly.
10593     * `extern mod` is now `extern crate`
10594     * The `Freeze` trait has been removed.
10595     * The `Share` trait has been added for types that can be shared among
10596       threads.
10597     * Labels in macros are now hygienic.
10598     * Expression/statement macro invocations can be delimited with `{}` now.
10599     * Treatment of types allowed in `static mut` locations has been tweaked.
10600     * The `*` and `.` operators are now overloadable through the `Deref` and
10601       `DerefMut` traits.
10602     * `~Trait` and `proc` no longer have `Send` bounds by default.
10603     * Partial type hints are now supported with the `_` type marker.
10604     * An `Unsafe` type was introduced for interior mutability. It is now
10605       considered undefined to transmute from `&T` to `&mut T` without using the
10606       `Unsafe` type.
10607     * The #[linkage] attribute was implemented for extern statics/functions.
10608     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10609     * `Pod` was renamed to `Copy`.
10610
10611   * Libraries
10612     * The `libextra` library has been removed. It has now been decomposed into
10613       component libraries with smaller and more focused nuggets of
10614       functionality. The full list of libraries can be found on the
10615       documentation index page.
10616     * std: `std::condition` has been removed. All I/O errors are now propagated
10617       through the `Result` type. In order to assist with error handling, a
10618       `try!` macro for unwrapping errors with an early return and a lint for
10619       unused results has been added. See #12039 for more information.
10620     * std: The `vec` module has been renamed to `slice`.
10621     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10622       This will become the only growable vector in the future.
10623     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10624       are now found at `std::io::BufferedReader` instead of
10625       `std::io::buffered::BufferedReader`.
10626     * std: `print` and `println` are no longer in the prelude, the `print!` and
10627       `println!` macros are intended to be used instead.
10628     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10629       attempts to statically prevent cycles.
10630     * std: The standard distribution is adopting the policy of pushing failure
10631       to the user rather than failing in libraries. Many functions (such as
10632       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10633     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10634       deriving mode: `#[deriving(Show)]`.
10635     * std: `ToStr` is now implemented for all types implementing `Show`.
10636     * std: The formatting trait methods now take `&self` instead of `&T`
10637     * std: The `invert()` method on iterators has been renamed to `rev()`
10638     * std: `std::num` has seen a reduction in the genericity of its traits,
10639       consolidating functionality into a few core traits.
10640     * std: Backtraces are now printed on task failure if the environment
10641       variable `RUST_BACKTRACE` is present.
10642     * std: Naming conventions for iterators have been standardized. More details
10643       can be found on the wiki's style guide.
10644     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10645       still implement the function.
10646     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10647     * std: `assert_approx_eq!` has been removed
10648     * std: The `e` and `E` formatting specifiers for floats have been added to
10649       print them in exponential notation.
10650     * std: The `Times` trait has been removed
10651     * std: Indications of variance and opting out of builtin bounds is done
10652       through marker types in `std::kinds::marker` now
10653     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10654       `#[deriving(Hash)]` is now possible.
10655     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10656     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10657     * std: `Chan::new` is now `channel()`.
10658     * std: A new synchronous channel type has been implemented.
10659     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10660     * std: `hashmap` and `trie` have been moved to `libcollections`
10661     * std: `run` has been rolled into `io::process`
10662     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10663     * std: The equality and comparison traits have seen some reorganization.
10664     * std: `rand` has moved to `librand`.
10665     * std: `to_{lower,upper}case` has been implemented for `char`.
10666     * std: Logging has been moved to `liblog`.
10667     * collections: `HashMap` has been rewritten for higher performance and less
10668       memory usage.
10669     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10670       it can be booted manually. The runtime guide has more information and
10671       examples.
10672     * native: All I/O functionality except signals has been implemented.
10673     * green: Task spawning with `libgreen` has been optimized with stack caching
10674       and various trimming of code.
10675     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10676     * sync: The `extra::sync` module has been updated to modern rust (and moved
10677       to the `sync` library), tweaking and improving various interfaces while
10678       dropping redundant functionality.
10679     * sync: A new `Barrier` type has been added to the `sync` library.
10680     * sync: An efficient mutex for native and green tasks has been implemented.
10681     * serialize: The `base64` module has seen some improvement. It treats
10682       newlines better, has non-string error values, and has seen general
10683       cleanup.
10684     * fourcc: A `fourcc!` macro was introduced
10685     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10686       hexadecimal literal.
10687
10688   * Tooling
10689     * `rustpkg` has been deprecated and removed from the main repository. Its
10690       replacement, `cargo`, is under development.
10691     * Nightly builds of rust are now available
10692     * The memory usage of rustc has been improved many times throughout this
10693       release cycle.
10694     * The build process supports disabling rpath support for the rustc binary
10695       itself.
10696     * Code generation has improved in some cases, giving more information to the
10697       LLVM optimization passes to enable more extensive optimizations.
10698     * Debuginfo compatibility with lldb on OSX has been restored.
10699     * The master branch is now gated on an android bot, making building for
10700       android much more reliable.
10701     * Output flags have been centralized into one `--emit` flag.
10702     * Crate type flags have been centralized into one `--crate-type` flag.
10703     * Codegen flags have been consolidated behind a `-C` flag.
10704     * Linking against outdated crates now has improved error messages.
10705     * Error messages with lifetimes will often suggest how to annotate the
10706       function to fix the error.
10707     * Many more types are documented in the standard library, and new guides
10708       were written.
10709     * Many `rustdoc` improvements:
10710       * code blocks are syntax highlighted.
10711       * render standalone markdown files.
10712       * the --test flag tests all code blocks by default.
10713       * exported macros are displayed.
10714       * re-exported types have their documentation inlined at the location of the
10715         first re-export.
10716       * search works across crates that have been rendered to the same output
10717         directory.
10718
10719
10720 Version 0.9 (2014-01-09)
10721 ==========================
10722
10723    * ~1800 changes, numerous bugfixes
10724
10725    * Language
10726       * The `float` type has been removed. Use `f32` or `f64` instead.
10727       * A new facility for enabling experimental features (feature gating) has
10728         been added, using the crate-level `#[feature(foo)]` attribute.
10729       * Managed boxes (@) are now behind a feature gate
10730         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10731         standard library's `Gc` or `Rc` types instead.
10732       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10733       * Jumping back to the top of a loop is now done with `continue` instead of
10734         `loop`.
10735       * Strings can no longer be mutated through index assignment.
10736       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10737         hash delimiters, as in `r###"foo"###`.
10738       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10739         called once.
10740       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10741       * `@fn`s have been removed.
10742       * `do` only works with procs in order to make it obvious what the cost
10743         of `do` is.
10744       * Single-element tuple-like structs can no longer be dereferenced to
10745         obtain the inner value. A more comprehensive solution for overloading
10746         the dereference operator will be provided in the future.
10747       * The `#[link(...)]` attribute has been replaced with
10748         `#[crate_id = "name#vers"]`.
10749       * Empty `impl`s must be terminated with empty braces and may not be
10750         terminated with a semicolon.
10751       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10752         no longer has any special meaning.
10753       * The old `fmt!` string formatting macro has been removed.
10754       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10755         `print!` and `println!`.
10756       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10757       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10758         `extern mod foo = "bar"` instead.
10759       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10760       * Macros can have attributes.
10761       * Macros can expand to items with attributes.
10762       * Macros can expand to multiple items.
10763       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10764       * Comments may be nested.
10765       * Values automatically coerce to trait objects they implement, without
10766         an explicit `as`.
10767       * Enum discriminants are no longer an entire word but as small as needed to
10768         contain all the variants. The `repr` attribute can be used to override
10769         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10770         `#[repr(C)]` to match C enums.
10771       * Non-string literals are not allowed in attributes (they never worked).
10772       * The FFI now supports variadic functions.
10773       * Octal numeric literals, as in `0o7777`.
10774       * The `concat!` syntax extension performs compile-time string concatenation.
10775       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10776         removed as Rust no longer uses segmented stacks.
10777       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10778       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10779         not `*`; ignoring remaining fields of a struct is also done with `..`,
10780         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10781       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10782       * `rustc` supports the "system" calling convention, which defaults to the
10783         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10784         "C" elsewhere.
10785       * The `type_overflow` lint (default: warn) checks literals for overflow.
10786       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10787       * The `attribute_usage` lint (default: warn) warns about unknown
10788         attributes.
10789       * The `unknown_features` lint (default: warn) warns about unknown
10790         feature gates.
10791       * The `dead_code` lint (default: warn) checks for dead code.
10792       * Rust libraries can be linked statically to one another
10793       * `#[link_args]` is behind the `link_args` feature gate.
10794       * Native libraries are now linked with `#[link(name = "foo")]`
10795       * Native libraries can be statically linked to a rust crate
10796         (`#[link(name = "foo", kind = "static")]`).
10797       * Native OS X frameworks are now officially supported
10798         (`#[link(name = "foo", kind = "framework")]`).
10799       * The `#[thread_local]` attribute creates thread-local (not task-local)
10800         variables. Currently behind the `thread_local` feature gate.
10801       * The `return` keyword may be used in closures.
10802       * Types that can be copied via a memcpy implement the `Pod` kind.
10803       * The `cfg` attribute can now be used on struct fields and enum variants.
10804
10805    * Libraries
10806       * std: The `option` and `result` API's have been overhauled to make them
10807         simpler, more consistent, and more composable.
10808       * std: The entire `std::io` module has been replaced with one that is
10809         more comprehensive and that properly interfaces with the underlying
10810         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10811         implemented.
10812       * std: `io::util` contains a number of useful implementations of
10813         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10814         `ZeroReader`, `TeeReader`.
10815       * std: The reference counted pointer type `extra::rc` moved into std.
10816       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10817         just a wrapper around it).
10818       * std: The `Either` type has been removed.
10819       * std: `fmt::Default` can be implemented for any type to provide default
10820         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10821       * std: The `rand` API continues to be tweaked.
10822       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10823         on failure in gdb, is now named `rust_fail`.
10824       * std: The `each_key` and `each_value` methods on `HashMap` have been
10825         replaced by the `keys` and `values` iterators.
10826       * std: Functions dealing with type size and alignment have moved from the
10827         `sys` module to the `mem` module.
10828       * std: The `path` module was written and API changed.
10829       * std: `str::from_utf8` has been changed to cast instead of allocate.
10830       * std: `starts_with` and `ends_with` methods added to vectors via the
10831         `ImmutableEqVector` trait, which is in the prelude.
10832       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10833         if the index is out of bounds.
10834       * std: Task failure no longer propagates between tasks, as the model was
10835         complex, expensive, and incompatible with thread-based tasks.
10836       * std: The `Any` type can be used for dynamic typing.
10837       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10838         `task::try`.
10839       * std: Methods that produce iterators generally do not have an `_iter`
10840         suffix now.
10841       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10842         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10843       * std: `util::ignore` renamed to `prelude::drop`.
10844       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10845         trait.
10846       * std: `vec::raw` has seen a lot of cleanup and API changes.
10847       * std: The standard library no longer includes any C++ code, and very
10848         minimal C, eliminating the dependency on libstdc++.
10849       * std: Runtime scheduling and I/O functionality has been factored out into
10850         extensible interfaces and is now implemented by two different crates:
10851         libnative, for native threading and I/O; and libgreen, for green threading
10852         and I/O. This paves the way for using the standard library in more limited
10853         embedded environments.
10854       * std: The `comm` module has been rewritten to be much faster, have a
10855         simpler, more consistent API, and to work for both native and green
10856         threading.
10857       * std: All libuv dependencies have been moved into the rustuv crate.
10858       * native: New implementations of runtime scheduling on top of OS threads.
10859       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10860         and other I/O.
10861       * green: The green thread scheduler and message passing types are almost
10862         entirely lock-free.
10863       * extra: The `flatpipes` module had bitrotted and was removed.
10864       * extra: All crypto functions have been removed and Rust now has a policy of
10865         not reimplementing crypto in the standard library. In the future crypto
10866         will be provided by external crates with bindings to established libraries.
10867       * extra: `c_vec` has been modernized.
10868       * extra: The `sort` module has been removed. Use the `sort` method on
10869         mutable slices.
10870
10871    * Tooling
10872       * The `rust` and `rusti` commands have been removed, due to lack of
10873         maintenance.
10874       * `rustdoc` was completely rewritten.
10875       * `rustdoc` can test code examples in documentation.
10876       * `rustpkg` can test packages with the argument, 'test'.
10877       * `rustpkg` supports arbitrary dependencies, including C libraries.
10878       * `rustc`'s support for generating debug info is improved again.
10879       * `rustc` has better error reporting for unbalanced delimiters.
10880       * `rustc`'s JIT support was removed due to bitrot.
10881       * Executables and static libraries can be built with LTO (-Z lto)
10882       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10883         build tools.
10884
10885
10886 Version 0.8 (2013-09-26)
10887 ============================
10888
10889    * ~2200 changes, numerous bugfixes
10890
10891    * Language
10892       * The `for` loop syntax has changed to work with the `Iterator` trait.
10893       * At long last, unwinding works on Windows.
10894       * Default methods are ready for use.
10895       * Many trait inheritance bugs fixed.
10896       * Owned and borrowed trait objects work more reliably.
10897       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10898       * rustc can omit emission of code for the `debug!` macro if it is passed
10899         `--cfg ndebug`
10900       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10901         for foo.rs, then foo/mod.rs, and will generate an error when both are
10902         present.
10903       * Strings no longer contain trailing nulls. The new `std::c_str` module
10904         provides new mechanisms for converting to C strings.
10905       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10906       * The FFI has been overhauled such that foreign functions are called directly,
10907         instead of through a stack-switching wrapper.
10908       * Calling a foreign function must be done through a Rust function with the
10909         `#[fixed_stack_segment]` attribute.
10910       * The `externfn!` macro can be used to declare both a foreign function and
10911         a `#[fixed_stack_segment]` wrapper at once.
10912       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10913       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10914       * `priv` is disallowed everywhere except for struct fields and enum variants.
10915       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10916       * `ref` bindings in irrefutable patterns work correctly now.
10917       * `char` is now prevented from containing invalid code points.
10918       * Casting to `bool` is no longer allowed.
10919       * `\0` is now accepted as an escape in chars and strings.
10920       * `yield` is a reserved keyword.
10921       * `typeof` is a reserved keyword.
10922       * Crates may be imported by URL with `extern mod foo = "url";`.
10923       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10924       * Static vectors can be initialized with repeating elements,
10925         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10926       * Static structs can be initialized with functional record update,
10927         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10928       * `cfg!` can be used to conditionally execute code based on the crate
10929         configuration, similarly to `#[cfg(...)]`.
10930       * The `unnecessary_qualification` lint detects unneeded module
10931         prefixes (default: allow).
10932       * Arithmetic operations have been implemented on the SIMD types in
10933         `std::unstable::simd`.
10934       * Exchange allocation headers were removed, reducing memory usage.
10935       * `format!` implements a completely new, extensible, and higher-performance
10936         string formatting system. It will replace `fmt!`.
10937       * `print!` and `println!` write formatted strings (using the `format!`
10938         extension) to stdout.
10939       * `write!` and `writeln!` write formatted strings (using the `format!`
10940         extension) to the new Writers in `std::rt::io`.
10941       * The library section in which a function or static is placed may
10942         be specified with `#[link_section = "..."]`.
10943       * The `proto!` syntax extension for defining bounded message protocols
10944         was removed.
10945       * `macro_rules!` is hygienic for `let` declarations.
10946       * The `#[export_name]` attribute specifies the name of a symbol.
10947       * `unreachable!` can be used to indicate unreachable code, and fails
10948         if executed.
10949
10950    * Libraries
10951       * std: Transitioned to the new runtime, written in Rust.
10952       * std: Added an experimental I/O library, `rt::io`, based on the new
10953         runtime.
10954       * std: A new generic `range` function was added to the prelude, replacing
10955         `uint::range` and friends.
10956       * std: `range_rev` no longer exists. Since range is an iterator it can be
10957         reversed with `range(lo, hi).invert()`.
10958       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10959         renamed to `unwrap_or`.
10960       * std: The `iterator` module was renamed to `iter`.
10961       * std: Integral types now support the `checked_add`, `checked_sub`, and
10962         `checked_mul` operations for detecting overflow.
10963       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10964         consistency.
10965       * std: Methods are standardizing on conventions for casting methods:
10966         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10967         and cheap casts.
10968       * std: The `CString` type in `c_str` provides new ways to convert to and
10969         from C strings.
10970       * std: `DoubleEndedIterator` can yield elements in two directions.
10971       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10972         two splices.
10973       * std: `str::from_bytes` renamed to `str::from_utf8`.
10974       * std: `pop_opt` and `shift_opt` methods added to vectors.
10975       * std: The task-local data interface no longer uses @, and keys are
10976         no longer function pointers.
10977       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10978       * std: Added `SharedPort` to `comm`.
10979       * std: `Eq` has a default method for `ne`; only `eq` is required
10980         in implementations.
10981       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10982         is required in implementations.
10983       * std: `is_utf8` performance is improved, impacting many string functions.
10984       * std: `os::MemoryMap` provides cross-platform mmap.
10985       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10986         are not 'in-bounds' are considered undefined.
10987       * std: Many freestanding functions in `vec` removed in favor of methods.
10988       * std: Many freestanding functions on scalar types removed in favor of
10989         methods.
10990       * std: Many options to task builders were removed since they don't make
10991         sense in the new scheduler design.
10992       * std: More containers implement `FromIterator` so can be created by the
10993         `collect` method.
10994       * std: More complete atomic types in `unstable::atomics`.
10995       * std: `comm::PortSet` removed.
10996       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10997         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10998         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10999         default implementations.
11000       * std: Various `from_str` functions were removed in favor of a generic
11001         `from_str` which is available in the prelude.
11002       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
11003       * extra: `dlist`, the doubly-linked list was modernized.
11004       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
11005       * extra: Added `glob` module, replacing `std::os::glob`.
11006       * extra: `rope` was removed.
11007       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
11008       * extra: `net`, and `timer` were removed. The experimental replacements
11009         are `std::rt::io::net` and `std::rt::io::timer`.
11010       * extra: Iterators implemented for `SmallIntMap`.
11011       * extra: Iterators implemented for `Bitv` and `BitvSet`.
11012       * extra: `SmallIntSet` removed. Use `BitvSet`.
11013       * extra: Performance of JSON parsing greatly improved.
11014       * extra: `semver` updated to SemVer 2.0.0.
11015       * extra: `term` handles more terminals correctly.
11016       * extra: `dbg` module removed.
11017       * extra: `par` module removed.
11018       * extra: `future` was cleaned up, with some method renames.
11019       * extra: Most free functions in `getopts` were converted to methods.
11020
11021    * Other
11022       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
11023       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
11024         similarly to gcc's `--march` flag.
11025       * rustc's performance compiling small crates is much better.
11026       * rustpkg has received many improvements.
11027       * rustpkg supports git tags as package IDs.
11028       * rustpkg builds into target-specific directories so it can be used for
11029         cross-compiling.
11030       * The number of concurrent test tasks is controlled by the environment
11031         variable RUST_TEST_TASKS.
11032       * The test harness can now report metrics for benchmarks.
11033       * All tools have man pages.
11034       * Programs compiled with `--test` now support the `-h` and `--help` flags.
11035       * The runtime uses jemalloc for allocations.
11036       * Segmented stacks are temporarily disabled as part of the transition to
11037         the new runtime. Stack overflows are possible!
11038       * A new documentation backend, rustdoc_ng, is available for use. It is
11039         still invoked through the normal `rustdoc` command.
11040
11041
11042 Version 0.7 (2013-07-03)
11043 =======================
11044
11045    * ~2000 changes, numerous bugfixes
11046
11047    * Language
11048       * `impl`s no longer accept a visibility qualifier. Put them on methods
11049         instead.
11050       * The borrow checker has been rewritten with flow-sensitivity, fixing
11051         many bugs and inconveniences.
11052       * The `self` parameter no longer implicitly means `&'self self`,
11053         and can be explicitly marked with a lifetime.
11054       * Overloadable compound operators (`+=`, etc.) have been temporarily
11055         removed due to bugs.
11056       * The `for` loop protocol now requires `for`-iterators to return `bool`
11057         so they compose better.
11058       * The `Durable` trait is replaced with the `'static` bounds.
11059       * Trait default methods work more often.
11060       * Structs with the `#[packed]` attribute have byte alignment and
11061         no padding between fields.
11062       * Type parameters bound by `Copy` must now be copied explicitly with
11063         the `copy` keyword.
11064       * It is now illegal to move out of a dereferenced unsafe pointer.
11065       * `Option<~T>` is now represented as a nullable pointer.
11066       * `@mut` does dynamic borrow checks correctly.
11067       * The `main` function is only detected at the topmost level of the crate.
11068         The `#[main]` attribute is still valid anywhere.
11069       * Struct fields may no longer be mutable. Use inherited mutability.
11070       * The `#[no_send]` attribute makes a type that would otherwise be
11071         `Send`, not.
11072       * The `#[no_freeze]` attribute makes a type that would otherwise be
11073         `Freeze`, not.
11074       * Unbounded recursion will abort the process after reaching the limit
11075         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
11076       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
11077         are never implicitly copyable.
11078       * `#[static_assert]` makes compile-time assertions about static bools.
11079       * At long last, 'argument modes' no longer exist.
11080       * The rarely used `use mod` statement no longer exists.
11081
11082    * Syntax extensions
11083       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
11084         argument list.
11085       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
11086         `Rand`, `Zero` and `ToStr` can all be automatically derived with
11087         `#[deriving(...)]`.
11088       * The `bytes!` macro returns a vector of bytes for string, u8, char,
11089         and unsuffixed integer literals.
11090
11091    * Libraries
11092       * The `core` crate was renamed to `std`.
11093       * The `std` crate was renamed to `extra`.
11094       * More and improved documentation.
11095       * std: `iterator` module for external iterator objects.
11096       * Many old-style (internal, higher-order function) iterators replaced by
11097         implementations of `Iterator`.
11098       * std: Many old internal vector and string iterators,
11099         incl. `any`, `all`. removed.
11100       * std: The `finalize` method of `Drop` renamed to `drop`.
11101       * std: The `drop` method now takes `&mut self` instead of `&self`.
11102       * std: The prelude no longer re-exports any modules, only types and traits.
11103       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
11104         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
11105       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
11106         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
11107       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
11108         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
11109       * std: Many types implement `Clone`.
11110       * std: `path` type renamed to `Path`.
11111       * std: `mut` module and `Mut` type removed.
11112       * std: Many standalone functions removed in favor of methods and iterators
11113         in `vec`, `str`. In the future methods will also work as functions.
11114       * std: `reinterpret_cast` removed. Use `transmute`.
11115       * std: ascii string handling in `std::ascii`.
11116       * std: `Rand` is implemented for ~/@.
11117       * std: `run` module for spawning processes overhauled.
11118       * std: Various atomic types added to `unstable::atomic`.
11119       * std: Various types implement `Zero`.
11120       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
11121       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
11122       * std: Added `os::mkdir_recursive`.
11123       * std: Added `os::glob` function performs filesystems globs.
11124       * std: `FuzzyEq` renamed to `ApproxEq`.
11125       * std: `Map` now defines `pop` and `swap` methods.
11126       * std: `Cell` constructors converted to static methods.
11127       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
11128       * extra: `flate` module moved from `std` to `extra`.
11129       * extra: `fileinput` module for iterating over a series of files.
11130       * extra: `Complex` number type and `complex` module.
11131       * extra: `Rational` number type and `rational` module.
11132       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
11133       * extra: `term` uses terminfo now, is more correct.
11134       * extra: `arc` functions converted to methods.
11135       * extra: Implementation of fixed output size variations of SHA-2.
11136
11137    * Tooling
11138       * `unused_variables` lint mode for unused variables (default: warn).
11139       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
11140         (default: warn).
11141       * `unused_mut` lint mode for identifying unused `mut` qualifiers
11142         (default: warn).
11143       * `dead_assignment` lint mode for unread variables (default: warn).
11144       * `unnecessary_allocation` lint mode detects some heap allocations that are
11145         immediately borrowed so could be written without allocating (default: warn).
11146       * `missing_doc` lint mode (default: allow).
11147       * `unreachable_code` lint mode (default: warn).
11148       * The `rusti` command has been rewritten and a number of bugs addressed.
11149       * rustc outputs in color on more terminals.
11150       * rustc accepts a `--link-args` flag to pass arguments to the linker.
11151       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
11152       * Compiling with `-g` will make the binary record information about
11153         dynamic borrowcheck failures for debugging.
11154       * rustdoc has a nicer stylesheet.
11155       * Various improvements to rustdoc.
11156       * Improvements to rustpkg (see the detailed release notes).
11157
11158
11159 Version 0.6 (2013-04-03)
11160 ========================
11161
11162    * ~2100 changes, numerous bugfixes
11163
11164    * Syntax changes
11165       * The self type parameter in traits is now spelled `Self`
11166       * The `self` parameter in trait and impl methods must now be explicitly
11167         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
11168       * Static methods no longer require the `static` keyword and instead
11169         are distinguished by the lack of a `self` parameter
11170       * Replaced the `Durable` trait with the `'static` lifetime
11171       * The old closure type syntax with the trailing sigil has been
11172         removed in favor of the more consistent leading sigil
11173       * `super` is a keyword, and may be prefixed to paths
11174       * Trait bounds are separated with `+` instead of whitespace
11175       * Traits are implemented with `impl Trait for Type`
11176         instead of `impl Type: Trait`
11177       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
11178       * The `export` keyword has finally been removed
11179       * The `move` keyword has been removed (see "Semantic changes")
11180       * The interior mutability qualifier on vectors, `[mut T]`, has been
11181         removed. Use `&mut [T]`, etc.
11182       * `mut` is no longer valid in `~mut T`. Use inherited mutability
11183       * `fail` is no longer a keyword. Use `fail!()`
11184       * `assert` is no longer a keyword. Use `assert!()`
11185       * `log` is no longer a keyword. use `debug!`, etc.
11186       * 1-tuples may be represented as `(T,)`
11187       * Struct fields may no longer be `mut`. Use inherited mutability,
11188         `@mut T`, `core::mut` or `core::cell`
11189       * `extern mod { ... }` is no longer valid syntax for foreign
11190         function modules. Use extern blocks: `extern { ... }`
11191       * Newtype enums removed. Use tuple-structs.
11192       * Trait implementations no longer support visibility modifiers
11193       * Pattern matching over vectors improved and expanded
11194       * `const` renamed to `static` to correspond to lifetime name,
11195         and make room for future `static mut` unsafe mutable globals.
11196       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
11197       * `Clone` implementations can be automatically generated with
11198         `#[deriving(Clone)]`
11199       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
11200         instead of `foo as Bar`.
11201       * Fixed length vector types are now written as `[int, .. 3]`
11202         instead of `[int * 3]`.
11203       * Fixed length vector types can express the length as a constant
11204         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
11205
11206    * Semantic changes
11207       * Types with owned pointers or custom destructors move by default,
11208         eliminating the `move` keyword
11209       * All foreign functions are considered unsafe
11210       * &mut is now unaliasable
11211       * Writes to borrowed @mut pointers are prevented dynamically
11212       * () has size 0
11213       * The name of the main function can be customized using #[main]
11214       * The default type of an inferred closure is &fn instead of @fn
11215       * `use` statements may no longer be "chained" - they cannot import
11216         identifiers imported by previous `use` statements
11217       * `use` statements are crate relative, importing from the "top"
11218         of the crate by default. Paths may be prefixed with `super::`
11219         or `self::` to change the search behavior.
11220       * Method visibility is inherited from the implementation declaration
11221       * Structural records have been removed
11222       * Many more types can be used in static items, including enums
11223         'static-lifetime pointers and vectors
11224       * Pattern matching over vectors improved and expanded
11225       * Typechecking of closure types has been overhauled to
11226         improve inference and eliminate unsoundness
11227       * Macros leave scope at the end of modules, unless that module is
11228         tagged with #[macro_escape]
11229
11230    * Libraries
11231       * Added big integers to `std::bigint`
11232       * Removed `core::oldcomm` module
11233       * Added pipe-based `core::comm` module
11234       * Numeric traits have been reorganized under `core::num`
11235       * `vec::slice` finally returns a slice
11236       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
11237       * Containers reorganized around traits in `core::container`
11238       * `core::dvec` removed, `~[T]` is a drop-in replacement
11239       * `core::send_map` renamed to `core::hashmap`
11240       * `std::map` removed; replaced with `core::hashmap`
11241       * `std::treemap` reimplemented as an owned balanced tree
11242       * `std::deque` and `std::smallintmap` reimplemented as owned containers
11243       * `core::trie` added as a fast ordered map for integer keys
11244       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
11245       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
11246         overload the comparison operators, whereas `TotalOrd` is used
11247         by certain container types
11248
11249    * Other
11250       * Replaced the 'cargo' package manager with 'rustpkg'
11251       * Added all-purpose 'rust' tool
11252       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
11253       * rustc now *attempts* to offer spelling suggestions
11254       * Improved support for ARM and Android
11255       * Preliminary MIPS backend
11256       * Improved foreign function ABI implementation for x86, x86_64
11257       * Various memory usage improvements
11258       * Rust code may be embedded in foreign code under limited circumstances
11259       * Inline assembler supported by new asm!() syntax extension.
11260
11261
11262 Version 0.5 (2012-12-21)
11263 ===========================
11264
11265    * ~900 changes, numerous bugfixes
11266
11267    * Syntax changes
11268       * Removed `<-` move operator
11269       * Completed the transition from the `#fmt` extension syntax to `fmt!`
11270       * Removed old fixed length vector syntax - `[T]/N`
11271       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
11272       * Macros may now expand to items and statements
11273       * `a.b()` is always parsed as a method call, never as a field projection
11274       * `Eq` and `IterBytes` implementations can be automatically generated
11275         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
11276       * Removed the special crate language for `.rc` files
11277       * Function arguments may consist of any irrefutable pattern
11278
11279    * Semantic changes
11280       * `&` and `~` pointers may point to objects
11281       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
11282       * Enum variants may be structs
11283       * Destructors can be added to all nominal types with the Drop trait
11284       * Structs and nullary enum variants may be constants
11285       * Values that cannot be implicitly copied are now automatically moved
11286         without writing `move` explicitly
11287       * `&T` may now be coerced to `*T`
11288       * Coercions happen in `let` statements as well as function calls
11289       * `use` statements now take crate-relative paths
11290       * The module and type namespaces have been merged so that static
11291         method names can be resolved under the trait in which they are
11292         declared
11293
11294    * Improved support for language features
11295       * Trait inheritance works in many scenarios
11296       * More support for explicit self arguments in methods - `self`, `&self`
11297         `@self`, and `~self` all generally work as expected
11298       * Static methods work in more situations
11299       * Experimental: Traits may declare default methods for the implementations
11300         to use
11301
11302    * Libraries
11303       * New condition handling system in `core::condition`
11304       * Timsort added to `std::sort`
11305       * New priority queue, `std::priority_queue`
11306       * Pipes for serializable types, `std::flatpipes'
11307       * Serialization overhauled to be trait-based
11308       * Expanded `getopts` definitions
11309       * Moved futures to `std`
11310       * More functions are pure now
11311       * `core::comm` renamed to `oldcomm`. Still deprecated
11312       * `rustdoc` and `cargo` are libraries now
11313
11314    * Misc
11315       * Added a preliminary REPL, `rusti`
11316       * License changed from MIT to dual MIT/APL2
11317
11318
11319 Version 0.4 (2012-10-15)
11320 ==========================
11321
11322    * ~2000 changes, numerous bugfixes
11323
11324    * Syntax
11325       * All keywords are now strict and may not be used as identifiers anywhere
11326       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
11327         'of', 'with', 'to', 'class'.
11328       * Classes are replaced with simpler structs
11329       * Explicit method self types
11330       * `ret` became `return` and `alt` became `match`
11331       * `import` is now `use`; `use is now `extern mod`
11332       * `extern mod { ... }` is now `extern { ... }`
11333       * `use mod` is the recommended way to import modules
11334       * `pub` and `priv` replace deprecated export lists
11335       * The syntax of `match` pattern arms now uses fat arrow (=>)
11336       * `main` no longer accepts an args vector; use `os::args` instead
11337
11338    * Semantics
11339       * Trait implementations are now coherent, ala Haskell typeclasses
11340       * Trait methods may be static
11341       * Argument modes are deprecated
11342       * Borrowed pointers are much more mature and recommended for use
11343       * Strings and vectors in the static region are stored in constant memory
11344       * Typestate was removed
11345       * Resolution rewritten to be more reliable
11346       * Support for 'dual-mode' data structures (freezing and thawing)
11347
11348    * Libraries
11349       * Most binary operators can now be overloaded via the traits in
11350         `core::ops'
11351       * `std::net::url` for representing URLs
11352       * Sendable hash maps in `core::send_map`
11353       * `core::task' gained a (currently unsafe) task-local storage API
11354
11355    * Concurrency
11356       * An efficient new intertask communication primitive called the pipe,
11357         along with a number of higher-level channel types, in `core::pipes`
11358       * `std::arc`, an atomically reference counted, immutable, shared memory
11359         type
11360       * `std::sync`, various exotic synchronization tools based on arcs and pipes
11361       * Futures are now based on pipes and sendable
11362       * More robust linked task failure
11363       * Improved task builder API
11364
11365    * Other
11366       * Improved error reporting
11367       * Preliminary JIT support
11368       * Preliminary work on precise GC
11369       * Extensive architectural improvements to rustc
11370       * Begun a transition away from buggy C++-based reflection (shape) code to
11371         Rust-based (visitor) code
11372       * All hash functions and tables converted to secure, randomized SipHash
11373
11374
11375 Version 0.3  (2012-07-12)
11376 ========================
11377
11378    * ~1900 changes, numerous bugfixes
11379
11380    * New coding conveniences
11381       * Integer-literal suffix inference
11382       * Per-item control over warnings, errors
11383       * #[cfg(windows)] and #[cfg(unix)] attributes
11384       * Documentation comments
11385       * More compact closure syntax
11386       * 'do' expressions for treating higher-order functions as
11387         control structures
11388       * *-patterns (wildcard extended to all constructor fields)
11389
11390    * Semantic cleanup
11391       * Name resolution pass and exhaustiveness checker rewritten
11392       * Region pointers and borrow checking supersede alias
11393         analysis
11394       * Init-ness checking is now provided by a region-based liveness
11395         pass instead of the typestate pass; same for last-use analysis
11396       * Extensive work on region pointers
11397
11398    * Experimental new language features
11399       * Slices and fixed-size, interior-allocated vectors
11400       * #!-comments for lang versioning, shell execution
11401       * Destructors and iface implementation for classes;
11402         type-parameterized classes and class methods
11403       * 'const' type kind for types that can be used to implement
11404         shared-memory concurrency patterns
11405
11406    * Type reflection
11407
11408    * Removal of various obsolete features
11409       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
11410                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
11411
11412       * Constructs: do-while loops ('do' repurposed), fn binding,
11413                     resources (replaced by destructors)
11414
11415    * Compiler reorganization
11416       * Syntax-layer of compiler split into separate crate
11417       * Clang (from LLVM project) integrated into build
11418       * Typechecker split into sub-modules
11419
11420    * New library code
11421       * New time functions
11422       * Extension methods for many built-in types
11423       * Arc: atomic-refcount read-only / exclusive-use shared cells
11424       * Par: parallel map and search routines
11425       * Extensive work on libuv interface
11426       * Much vector code moved to libraries
11427       * Syntax extensions: #line, #col, #file, #mod, #stringify,
11428         #include, #include_str, #include_bin
11429
11430    * Tool improvements
11431       * Cargo automatically resolves dependencies
11432
11433
11434 Version 0.2  (2012-03-29)
11435 =========================
11436
11437    * >1500 changes, numerous bugfixes
11438
11439    * New docs and doc tooling
11440
11441    * New port: FreeBSD x86_64
11442
11443    * Compilation model enhancements
11444       * Generics now specialized, multiply instantiated
11445       * Functions now inlined across separate crates
11446
11447    * Scheduling, stack and threading fixes
11448       * Noticeably improved message-passing performance
11449       * Explicit schedulers
11450       * Callbacks from C
11451       * Helgrind clean
11452
11453    * Experimental new language features
11454       * Operator overloading
11455       * Region pointers
11456       * Classes
11457
11458    * Various language extensions
11459       * C-callback function types: 'crust fn ...'
11460       * Infinite-loop construct: 'loop { ... }'
11461       * Shorten 'mutable' to 'mut'
11462       * Required mutable-local qualifier: 'let mut ...'
11463       * Basic glob-exporting: 'export foo::*;'
11464       * Alt now exhaustive, 'alt check' for runtime-checked
11465       * Block-function form of 'for' loop, with 'break' and 'ret'.
11466
11467    * New library code
11468       * AST quasi-quote syntax extension
11469       * Revived libuv interface
11470       * New modules: core::{future, iter}, std::arena
11471       * Merged per-platform std::{os*, fs*} to core::{libc, os}
11472       * Extensive cleanup, regularization in libstd, libcore
11473
11474
11475 Version 0.1  (2012-01-20)
11476 ===============================
11477
11478    * Most language features work, including:
11479       * Unique pointers, unique closures, move semantics
11480       * Interface-constrained generics
11481       * Static interface dispatch
11482       * Stack growth
11483       * Multithread task scheduling
11484       * Typestate predicates
11485       * Failure unwinding, destructors
11486       * Pattern matching and destructuring assignment
11487       * Lightweight block-lambda syntax
11488       * Preliminary macro-by-example
11489
11490    * Compiler works with the following configurations:
11491       * Linux: x86 and x86_64 hosts and targets
11492       * macOS: x86 and x86_64 hosts and targets
11493       * Windows: x86 hosts and targets
11494
11495    * Cross compilation / multi-target configuration supported.
11496
11497    * Preliminary API-documentation and package-management tools included.
11498
11499 Known issues:
11500
11501    * Documentation is incomplete.
11502
11503    * Performance is below intended target.
11504
11505    * Standard library APIs are subject to extensive change, reorganization.
11506
11507    * Language-level versioning is not yet operational - future code will
11508      break unexpectedly.