]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #89835 - jkugelman:must-use-expensive-computations, r=joshtriplett
[rust.git] / RELEASES.md
1 Version 1.56.0 (2021-10-21)
2 ========================
3
4 Language
5 --------
6
7 - [The 2021 Edition is now stable.][rust#88100]
8   See [the edition guide][rust-2021-edition-guide] for more details.
9 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
10 - [Union field access is permitted in `const fn`.][rust#85769]
11
12 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
13
14 Compiler
15 --------
16
17 - [Upgrade to LLVM 13.][rust#87570]
18 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
19 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
20 - [Warnings can be forced on with `--force-warn`.][rust#87472]
21   This feature is primarily intended for usage by `cargo fix`, rather than end users.
22 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
23 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
24 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
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 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
33   The Windows console still requires valid Unicode, but this change allows
34   splitting a UTF-8 character across multiple write calls. This allows, for
35   instance, programs that just read and write data buffers (e.g. copying a file
36   to stdout) without regard for Unicode or character boundaries.
37 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
38   For this use case, atomics scale much better under contention.
39 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
40 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
41 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
42 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
43 - [Treat invalid environment variable names as non-existent.][rust#86183]
44   Previously, the environment functions would panic if given a variable name
45   with an internal null character or equal sign (`=`). Now, these functions will
46   just treat such names as non-existent variables, since the OS cannot represent
47   the existence of a variable with such a name.
48
49 Stabilised APIs
50 ---------------
51
52 - [`std::os::unix::fs::chroot`]
53 - [`UnsafeCell::raw_get`]
54 - [`BufWriter::into_parts`]
55 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
56   These APIs were previously stable in `std`, but are now also available in `core`.
57 - [`Vec::shrink_to`]
58 - [`String::shrink_to`]
59 - [`OsString::shrink_to`]
60 - [`PathBuf::shrink_to`]
61 - [`BinaryHeap::shrink_to`]
62 - [`VecDeque::shrink_to`]
63 - [`HashMap::shrink_to`]
64 - [`HashSet::shrink_to`]
65
66 These APIs are now usable in const contexts:
67
68 - [`std::mem::transmute`]
69 - [`[T]::first`][`slice::first`]
70 - [`[T]::split_first`][`slice::split_first`]
71 - [`[T]::last`][`slice::last`]
72 - [`[T]::split_last`][`slice::split_last`]
73
74 Cargo
75 -----
76
77 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
78   This has no effect at present on dependency version selection.
79   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
80   that support Rust code to include a crate's specified minimum version in the test matrix for that
81   crate by default.
82
83 Compatibility notes
84 -------------------
85
86 - [Update to new argument parsing rules on Windows.][rust#87580]
87   This adjusts Rust's standard library to match the behavior of the standard
88   libraries for C/C++. The rules have changed slightly over time, and this PR
89   brings us to the latest set of rules (changed in 2008).
90 - [Disallow the aapcs calling convention on aarch64][rust#88399]
91   This was already not supported by LLVM; this change surfaces this lack of
92   support with a better error message.
93 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
94 - [Warn when an escaped newline skips multiple lines.][rust#87671]
95 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
96    may return different values on glibc <= 2.24.][rust#81825]
97    Rust now invokes the `clone3` system call directly, when available, to use new functionality
98    available via that system call. Older versions of glibc cache the result of `getpid`, and only
99    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
100    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
101
102 Internal changes
103 ----------------
104 These changes provide no direct user facing benefits, but represent significant
105 improvements to the internals and overall performance of rustc
106 and related tools.
107
108 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
109   This improves the performance of most Rust builds.
110 - [Unify representation of macros in internal data structures.][rust#88019]
111   This change fixes a host of bugs with the handling of macros by the compiler,
112   as well as rustdoc.
113
114 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
115 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
116 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
117 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
118 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
119 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
120 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
121 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
122 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
123 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
124 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
125 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
126 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
127 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
128 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
129 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
130 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
131 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
132 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
133 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
134 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
135 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
136 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
137 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
138 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
139 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
140 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
141 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
142 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
143 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
144 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
145 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
146 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
147 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
148 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
149 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
150 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
151 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
152 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
153 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
154 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
155 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
156 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
157 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
158 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
159 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
160 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
161 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
162 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
163 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
164 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
165 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
166 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
167 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
168 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
169 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
170 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
171 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
172 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
173 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
174 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
175 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
176 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
177 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
178 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
179 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
180 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
181 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
182
183 Version 1.55.0 (2021-09-09)
184 ============================
185
186 Language
187 --------
188 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
189   will end at the maximum value of the integer.][83918]
190 - [You can now explicitly import the prelude of different editions
191   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
192
193 Compiler
194 --------
195 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
196
197 \* Refer to Rust's [platform support page][platform-support-doc] for more
198    information on Rust's tiered platform support.
199
200 Libraries
201 ---------
202
203 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
204   These improvements should in general provide faster string parsing of floats,
205   no longer reject certain valid floating point values, and reduce
206   the produced code size for non-stripped artifacts.
207 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
208
209 Stabilised APIs
210 ---------------
211
212 - [`Bound::cloned`]
213 - [`Drain::as_str`]
214 - [`IntoInnerError::into_error`]
215 - [`IntoInnerError::into_parts`]
216 - [`MaybeUninit::assume_init_mut`]
217 - [`MaybeUninit::assume_init_ref`]
218 - [`MaybeUninit::write`]
219 - [`array::map`]
220 - [`ops::ControlFlow`]
221 - [`x86::_bittest`]
222 - [`x86::_bittestandcomplement`]
223 - [`x86::_bittestandreset`]
224 - [`x86::_bittestandset`]
225 - [`x86_64::_bittest64`]
226 - [`x86_64::_bittestandcomplement64`]
227 - [`x86_64::_bittestandreset64`]
228 - [`x86_64::_bittestandset64`]
229
230 The following previously stable functions are now `const`.
231
232 - [`str::from_utf8_unchecked`]
233
234
235 Cargo
236 -----
237 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
238   rustc in parallel such as when using `cargo test`.][cargo/9675]
239 - [The package definition in `cargo metadata` now includes the `"default_run"`
240   field from the manifest.][cargo/9550]
241 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
242 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
243   of packages.][cargo/9663]
244
245 Rustdoc
246 -------
247 - [Added "Go to item on exact match" search option.][85876]
248 - [The "Implementors" section on traits no longer shows redundant
249   method definitions.][85970]
250 - [Trait implementations are toggled open by default.][86260] This should make the
251   implementations more searchable by tools like `CTRL+F` in your browser.
252 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
253   through type aliases.][86334]
254 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
255   "Trait Implementations" section.][86513]
256
257
258 Compatibility Notes
259 -------------------
260 - [std functions that return an `io::Error` will no longer use the
261   `ErrorKind::Other` variant.][85746] This is to better reflect that these
262   kinds of errors could be categorised [into newer more specific `ErrorKind`
263   variants][79965], and that they do not represent a user error.
264 - [Using environment variable names with `process::Command` on Windows now
265   behaves as expected.][85270] Previously using envionment variables with
266   `Command` would cause them to be ASCII-uppercased.
267 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
268   with `rustdoc::`][86849]
269
270 [86849]: https://github.com/rust-lang/rust/pull/86849
271 [86513]: https://github.com/rust-lang/rust/pull/86513
272 [86334]: https://github.com/rust-lang/rust/pull/86334
273 [86260]: https://github.com/rust-lang/rust/pull/86260
274 [85970]: https://github.com/rust-lang/rust/pull/85970
275 [85876]: https://github.com/rust-lang/rust/pull/85876
276 [83572]: https://github.com/rust-lang/rust/pull/83572
277 [86294]: https://github.com/rust-lang/rust/pull/86294
278 [86858]: https://github.com/rust-lang/rust/pull/86858
279 [86761]: https://github.com/rust-lang/rust/pull/86761
280 [85769]: https://github.com/rust-lang/rust/pull/85769
281 [85746]: https://github.com/rust-lang/rust/pull/85746
282 [85305]: https://github.com/rust-lang/rust/pull/85305
283 [85270]: https://github.com/rust-lang/rust/pull/85270
284 [84111]: https://github.com/rust-lang/rust/pull/84111
285 [83918]: https://github.com/rust-lang/rust/pull/83918
286 [79965]: https://github.com/rust-lang/rust/pull/79965
287 [87370]: https://github.com/rust-lang/rust/pull/87370
288 [87298]: https://github.com/rust-lang/rust/pull/87298
289 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
290 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
291 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
292 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
293 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
294 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
295 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
296 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
297 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
298 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
299 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
300 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
301 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
302 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
303 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
304 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
305 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
306 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
307 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
308 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
309 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
310 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
311 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
312 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
313
314
315 Version 1.54.0 (2021-07-29)
316 ============================
317
318 Language
319 -----------------------
320
321 - [You can now use macros for values in some built-in attributes.][83366]
322   This primarily allows you to call macros within the `#[doc]` attribute. For
323   example, to include external documentation in your crate, you can now write
324   the following:
325   ```rust
326   #![doc = include_str!("README.md")]
327   ```
328
329 - [You can now cast between unsized slice types (and types which contain
330   unsized slices) in `const fn`.][85078]
331 - [You can now use multiple generic lifetimes with `impl Trait` where the
332    lifetimes don't explicitly outlive another.][84701] In code this means
333    that you can now have `impl Trait<'a, 'b>` where as before you could
334    only have `impl Trait<'a, 'b> where 'b: 'a`.
335
336 Compiler
337 -----------------------
338
339 - [Rustc will now search for custom JSON targets in
340   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
341   directory.][83800] You can find your sysroot directory by running
342   `rustc --print sysroot`.
343 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
344 - [You can now use `#[target_feature]` on safe functions when targeting
345   WebAssembly platforms.][84988]
346 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
347 - [Added tier 3\* support for `bpfel-unknown-none`
348    and `bpfeb-unknown-none`.][79608]
349 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
350
351 \* Refer to Rust's [platform support page][platform-support-doc] for more
352    information on Rust's tiered platform support.
353
354 Libraries
355 -----------------------
356
357 - [`panic::panic_any` will now `#[track_caller]`.][85745]
358 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
359 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
360 - [The implementations of vendor intrinsics in core::arch have been
361    significantly refactored.][83278] The main user-visible changes are
362    a 50% reduction in the size of libcore.rlib and stricter validation
363    of constant operands passed to intrinsics. The latter is technically
364    a breaking change, but allows Rust to more closely match the C vendor
365    intrinsics API.
366
367 Stabilized APIs
368 ---------------
369
370 - [`BTreeMap::into_keys`]
371 - [`BTreeMap::into_values`]
372 - [`HashMap::into_keys`]
373 - [`HashMap::into_values`]
374 - [`arch::wasm32`]
375 - [`VecDeque::binary_search`]
376 - [`VecDeque::binary_search_by`]
377 - [`VecDeque::binary_search_by_key`]
378 - [`VecDeque::partition_point`]
379
380 Cargo
381 -----
382
383 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
384   the dependency graph.][cargo/9520]
385 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
386   in the tree ][cargo/9499]
387 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
388   macro dependencies.][cargo/9488]
389 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
390   This variable points to a directory that integration tests and benches
391   can use as a "scratchpad" for testing filesystem operations.
392
393 Compatibility Notes
394 -------------------
395 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
396 - [Previously unsound code is no longer permitted where different constructors in branches
397   could require different lifetimes.][85574]
398 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
399   than before and may reject some previously accepted code.
400 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
401    when compiled with `codegen-units = 1`.][86063]
402
403 [85574]: https://github.com/rust-lang/rust/issues/85574
404 [86831]: https://github.com/rust-lang/rust/issues/86831
405 [86063]: https://github.com/rust-lang/rust/issues/86063
406 [86831]: https://github.com/rust-lang/rust/issues/86831
407 [79608]: https://github.com/rust-lang/rust/pull/79608
408 [84988]: https://github.com/rust-lang/rust/pull/84988
409 [84701]: https://github.com/rust-lang/rust/pull/84701
410 [84072]: https://github.com/rust-lang/rust/pull/84072
411 [85745]: https://github.com/rust-lang/rust/pull/85745
412 [84744]: https://github.com/rust-lang/rust/pull/84744
413 [85078]: https://github.com/rust-lang/rust/pull/85078
414 [84717]: https://github.com/rust-lang/rust/pull/84717
415 [83800]: https://github.com/rust-lang/rust/pull/83800
416 [83366]: https://github.com/rust-lang/rust/pull/83366
417 [83278]: https://github.com/rust-lang/rust/pull/83278
418 [85292]: https://github.com/rust-lang/rust/pull/85292
419 [82834]: https://github.com/rust-lang/rust/pull/82834
420 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
421 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
422 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
423 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
424 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
425 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
426 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
427 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
428 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
429 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
430 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
431
432 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
433
434 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
435
436 Version 1.53.0 (2021-06-17)
437 ============================
438
439 Language
440 -----------------------
441 - [You can now use unicode for identifiers.][83799] This allows multilingual
442   identifiers but still doesn't allow glyphs that are not considered characters
443   such as `◆` or `🦀`. More specifically you can now use any identifier that
444   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
445   is the same standard as languages like Python, however Rust uses NFC
446   normalization which may be different from other languages.
447 - [You can now specify "or patterns" inside pattern matches.][79278]
448   Previously you could only use `|` (OR) on complete patterns. E.g.
449   ```rust
450   let x = Some(2u8);
451   // Before
452   matches!(x, Some(1) | Some(2));
453   // Now
454   matches!(x, Some(1 | 2));
455   ```
456 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
457   has the same semantics as the `:pat` matcher. This is to allow `:pat`
458   to change semantics to being a pattern fragment in a future edition.
459
460 Compiler
461 -----------------------
462 - [Updated the minimum external LLVM version to LLVM 10.][83387]
463 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
464 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
465
466 \* Refer to Rust's [platform support page][platform-support-doc] for more
467 information on Rust's tiered platform support.
468
469 Libraries
470 -----------------------
471 - [Abort messages will now forward to `android_set_abort_message` on
472   Android platforms when available.][81469]
473 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
474 - [Arrays of any length now implement `IntoIterator`.][84147]
475   Currently calling `.into_iter()` as a method on an array will
476   return `impl Iterator<Item=&T>`, but this may change in a
477   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
478   directly on arrays will provide `impl Iterator<Item=T>` as expected.
479 - [`leading_zeros`, and `trailing_zeros` are now available on all
480   `NonZero` integer types.][84082]
481 - [`{f32, f64}::from_str` now parse and print special values
482   (`NaN`, `-0`) according to IEEE 754.][78618]
483 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
484 - [Add the `BITS` associated constant to all numeric types.][82565]
485
486 Stabilised APIs
487 ---------------
488 - [`AtomicBool::fetch_update`]
489 - [`AtomicPtr::fetch_update`]
490 - [`BTreeMap::retain`]
491 - [`BTreeSet::retain`]
492 - [`BufReader::seek_relative`]
493 - [`DebugStruct::non_exhaustive`]
494 - [`Duration::MAX`]
495 - [`Duration::ZERO`]
496 - [`Duration::is_zero`]
497 - [`Duration::saturating_add`]
498 - [`Duration::saturating_mul`]
499 - [`Duration::saturating_sub`]
500 - [`ErrorKind::Unsupported`]
501 - [`Option::insert`]
502 - [`Ordering::is_eq`]
503 - [`Ordering::is_ge`]
504 - [`Ordering::is_gt`]
505 - [`Ordering::is_le`]
506 - [`Ordering::is_lt`]
507 - [`Ordering::is_ne`]
508 - [`OsStr::is_ascii`]
509 - [`OsStr::make_ascii_lowercase`]
510 - [`OsStr::make_ascii_uppercase`]
511 - [`OsStr::to_ascii_lowercase`]
512 - [`OsStr::to_ascii_uppercase`]
513 - [`Peekable::peek_mut`]
514 - [`Rc::decrement_strong_count`]
515 - [`Rc::increment_strong_count`]
516 - [`Vec::extend_from_within`]
517 - [`array::from_mut`]
518 - [`array::from_ref`]
519 - [`cmp::max_by_key`]
520 - [`cmp::max_by`]
521 - [`cmp::min_by_key`]
522 - [`cmp::min_by`]
523 - [`f32::is_subnormal`]
524 - [`f64::is_subnormal`]
525
526 Cargo
527 -----------------------
528 - [Cargo now supports git repositories where the default `HEAD` branch is not
529   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
530   which can handle default branches correctly.
531 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
532 - [The `authors` field is no longer included in `Cargo.toml` for new
533   projects.][cargo/9282]
534
535 Rustdoc
536 -----------------------
537 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
538   without hyperlinks.][81764]
539
540 Compatibility Notes
541 -------------------
542 - [Implement token-based handling of attributes during expansion][82608]
543 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
544   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
545   to confusion and potential security vulnerabilities and [is no
546   longer recommended][ietf6943].
547 - [The added `BITS` constant may conflict with external definitions.][85667]
548   In particular, this was known to be a problem in the `lexical-core` crate,
549   but they have published fixes for semantic versions 0.4 through 0.7. To
550   update this dependency alone, use `cargo update -p lexical-core`.
551 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
552
553 Internal Only
554 -------------
555 These changes provide no direct user facing benefits, but represent significant
556 improvements to the internals and overall performance of rustc and
557 related tools.
558
559 - [Rework the `std::sys::windows::alloc` implementation.][83065]
560 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
561 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
562 - [Rework rustdoc const type][82873]
563
564 [85667]: https://github.com/rust-lang/rust/pull/85667
565 [83386]: https://github.com/rust-lang/rust/pull/83386
566 [82771]: https://github.com/rust-lang/rust/pull/82771
567 [84147]: https://github.com/rust-lang/rust/pull/84147
568 [84082]: https://github.com/rust-lang/rust/pull/84082
569 [83799]: https://github.com/rust-lang/rust/pull/83799
570 [83681]: https://github.com/rust-lang/rust/pull/83681
571 [83652]: https://github.com/rust-lang/rust/pull/83652
572 [83387]: https://github.com/rust-lang/rust/pull/83387
573 [82873]: https://github.com/rust-lang/rust/pull/82873
574 [82864]: https://github.com/rust-lang/rust/pull/82864
575 [82608]: https://github.com/rust-lang/rust/pull/82608
576 [82565]: https://github.com/rust-lang/rust/pull/82565
577 [80525]: https://github.com/rust-lang/rust/pull/80525
578 [79278]: https://github.com/rust-lang/rust/pull/79278
579 [78618]: https://github.com/rust-lang/rust/pull/78618
580 [77704]: https://github.com/rust-lang/rust/pull/77704
581 [83941]: https://github.com/rust-lang/rust/pull/83941
582 [83065]: https://github.com/rust-lang/rust/pull/83065
583 [81764]: https://github.com/rust-lang/rust/pull/81764
584 [81469]: https://github.com/rust-lang/rust/pull/81469
585 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
586 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
587 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
588 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
589 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
590 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
591 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
592 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
593 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
594 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
595 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
596 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
597 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
598 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
599 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
600 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
601 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
602 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
603 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
604 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
605 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
606 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
607 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
608 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
609 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
610 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
611 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
612 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
613 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
614 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
615 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
616 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
617 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
618 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
619 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
620 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
621 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
622 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
623 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
624 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
625 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
626 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
627
628
629 Version 1.52.1 (2021-05-10)
630 ============================
631
632 This release disables incremental compilation, unless the user has explicitly
633 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
634
635 This is due to the widespread, and frequently occuring, breakage encountered by
636 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
637 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
638 newly added incremental verification are still present in past stable versions,
639 and are not yet fixed on any channel. These bugs can lead to miscompilation of
640 Rust binaries.
641
642 These problems only affect incremental builds, so release builds with Cargo
643 should not be affected unless the user has explicitly opted into incremental.
644 Debug and check builds are affected.
645
646 See [84970] for more details.
647
648 [84970]: https://github.com/rust-lang/rust/issues/84970
649
650 Version 1.52.0 (2021-05-06)
651 ============================
652
653 Language
654 --------
655 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
656   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
657   is allowed by default, and may become a warning or hard error in a
658   future edition.
659 - [You can now cast mutable references to arrays to a pointer of the same type as
660   the element.][81479]
661
662 Compiler
663 --------
664 - [Upgraded the default LLVM to LLVM 12.][81451]
665
666 Added tier 3\* support for the following targets.
667
668 - [`s390x-unknown-linux-musl`][82166]
669 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
670 - [`powerpc-unknown-openbsd`][82733]
671
672 \* Refer to Rust's [platform support page][platform-support-doc] for more
673 information on Rust's tiered platform support.
674
675 Libraries
676 ---------
677 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
678 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
679 - [`Arc<impl Error>` now implements `error::Error`.][80553]
680 - [All integer division and remainder operations are now `const`.][80962]
681
682 Stabilised APIs
683 -------------
684 - [`Arguments::as_str`]
685 - [`char::MAX`]
686 - [`char::REPLACEMENT_CHARACTER`]
687 - [`char::UNICODE_VERSION`]
688 - [`char::decode_utf16`]
689 - [`char::from_digit`]
690 - [`char::from_u32_unchecked`]
691 - [`char::from_u32`]
692 - [`slice::partition_point`]
693 - [`str::rsplit_once`]
694 - [`str::split_once`]
695
696 The following previously stable APIs are now `const`.
697
698 - [`char::len_utf8`]
699 - [`char::len_utf16`]
700 - [`char::to_ascii_uppercase`]
701 - [`char::to_ascii_lowercase`]
702 - [`char::eq_ignore_ascii_case`]
703 - [`u8::to_ascii_uppercase`]
704 - [`u8::to_ascii_lowercase`]
705 - [`u8::eq_ignore_ascii_case`]
706
707 Rustdoc
708 -------
709 - [Rustdoc lints are now treated as a tool lint, meaning that
710   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
711   Using the old style is still allowed, and will become a warning in
712   a future release.
713 - [Rustdoc now supports argument files.][82261]
714 - [Rustdoc now generates smart punctuation for documentation.][79423]
715 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
716   ```markdown
717   - [x] Complete
718   - [ ] Todo
719   ```
720
721 Misc
722 ----
723 - [You can now pass multiple filters to tests.][81356] E.g.
724   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
725 - [Rustup now distributes PDB symbols for the `std` library on Windows,
726   allowing you to see `std` symbols when debugging.][82218]
727
728 Internal Only
729 -------------
730 These changes provide no direct user facing benefits, but represent significant
731 improvements to the internals and overall performance of rustc and
732 related tools.
733
734 - [Check the result cache before the DepGraph when ensuring queries][81855]
735 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
736 - [Only store a LocalDefId in some HIR nodes][81611]
737 - [Store HIR attributes in a side table][79519]
738
739 Compatibility Notes
740 -------------------
741 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
742 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
743 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
744 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
745   languages in code blocks.][78429]
746 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
747 - [Changes in how proc macros handle whitespace may lead to panics when used
748   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
749 - [Turn `#[derive]` into a regular macro attribute][79078]
750
751 [84136]: https://github.com/rust-lang/rust/issues/84136
752 [80763]: https://github.com/rust-lang/rust/pull/80763
753 [82166]: https://github.com/rust-lang/rust/pull/82166
754 [82121]: https://github.com/rust-lang/rust/pull/82121
755 [81879]: https://github.com/rust-lang/rust/pull/81879
756 [82261]: https://github.com/rust-lang/rust/pull/82261
757 [82218]: https://github.com/rust-lang/rust/pull/82218
758 [82216]: https://github.com/rust-lang/rust/pull/82216
759 [82202]: https://github.com/rust-lang/rust/pull/82202
760 [81855]: https://github.com/rust-lang/rust/pull/81855
761 [81766]: https://github.com/rust-lang/rust/pull/81766
762 [81744]: https://github.com/rust-lang/rust/pull/81744
763 [81611]: https://github.com/rust-lang/rust/pull/81611
764 [81479]: https://github.com/rust-lang/rust/pull/81479
765 [81451]: https://github.com/rust-lang/rust/pull/81451
766 [81356]: https://github.com/rust-lang/rust/pull/81356
767 [80962]: https://github.com/rust-lang/rust/pull/80962
768 [80553]: https://github.com/rust-lang/rust/pull/80553
769 [80527]: https://github.com/rust-lang/rust/pull/80527
770 [79519]: https://github.com/rust-lang/rust/pull/79519
771 [79423]: https://github.com/rust-lang/rust/pull/79423
772 [79208]: https://github.com/rust-lang/rust/pull/79208
773 [78429]: https://github.com/rust-lang/rust/pull/78429
774 [82733]: https://github.com/rust-lang/rust/pull/82733
775 [82594]: https://github.com/rust-lang/rust/pull/82594
776 [79078]: https://github.com/rust-lang/rust/pull/79078
777 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
778 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
779 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
780 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
781 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
782 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
783 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
784 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
785 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
786 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
787 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
788 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
789 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
790 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
791 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
792 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
793 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
794 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
795 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
796 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
797 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
798 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
799
800 Version 1.51.0 (2021-03-25)
801 ============================
802
803 Language
804 --------
805 - [You can now parameterize items such as functions, traits, and `struct`s by constant
806   values in addition to by types and lifetimes.][79135] Also known as "const generics"
807   E.g. you can now write the following. Note: Only values of primitive integers,
808   `bool`, or `char` types are currently permitted.
809   ```rust
810   struct GenericArray<T, const LENGTH: usize> {
811       inner: [T; LENGTH]
812   }
813
814   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
815       const fn last(&self) -> Option<&T> {
816           if LENGTH == 0 {
817               None
818           } else {
819               Some(&self.inner[LENGTH - 1])
820           }
821       }
822   }
823   ```
824
825
826 Compiler
827 --------
828
829 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
830   This option controls whether debug information is split across multiple files
831   or packed into a single file. **Note** This option is unstable on other platforms.
832 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
833   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
834 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
835 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
836
837 \* Refer to Rust's [platform support page][platform-support-doc] for more
838 information on Rust's tiered platform support.
839
840 Libraries
841 ---------
842
843 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
844 - [`str` now implements `AsMut<str>`.][80279]
845 - [`u64` and `u128` now implement `From<char>`.][79502]
846 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
847 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
848 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
849 - [`io::Empty` now implements `io::Seek`.][78044]
850 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
851   `T: ?Sized` types.][80764]
852 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
853
854
855 Stabilized APIs
856 ---------------
857
858 - [`Arc::decrement_strong_count`]
859 - [`Arc::increment_strong_count`]
860 - [`Once::call_once_force`]
861 - [`Peekable::next_if_eq`]
862 - [`Peekable::next_if`]
863 - [`Seek::stream_position`]
864 - [`array::IntoIter`]
865 - [`panic::panic_any`]
866 - [`ptr::addr_of!`]
867 - [`ptr::addr_of_mut!`]
868 - [`slice::fill_with`]
869 - [`slice::split_inclusive_mut`]
870 - [`slice::split_inclusive`]
871 - [`slice::strip_prefix`]
872 - [`slice::strip_suffix`]
873 - [`str::split_inclusive`]
874 - [`sync::OnceState`]
875 - [`task::Wake`]
876 - [`VecDeque::range`]
877 - [`VecDeque::range_mut`]
878
879 Cargo
880 -----
881 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
882   codegen option.][cargo/9112]
883 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
884   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
885   to avoid unifying features of dependencies where that unification could be unwanted.
886   Such as using the same dependency with a `std` feature in a build scripts and
887   proc-macros, while using the `no-std` feature in the final binary. See the
888   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
889
890 Rustdoc
891 -------
892
893 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
894 - [You can now provide a `--default-theme` flag which sets the default theme to use for
895   documentation.][79642]
896
897 Various improvements to intra-doc links:
898
899 - [You can link to non-path primitives such as `slice`.][80181]
900 - [You can link to associated items.][74489]
901 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
902
903 Misc
904 ----
905 - [You can now pass `--include-ignored` to tests (e.g. with
906   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
907
908 Compatibility Notes
909 -------------------
910
911 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
912 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
913   could fail.][80579]
914 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
915   for the distributed artifacts.][81521]
916     - `armv5te-unknown-linux-gnueabi`
917     - `sparc64-unknown-linux-gnu`
918     - `thumbv7neon-unknown-linux-gnueabihf`
919     - `armv7-unknown-linux-gnueabi`
920     - `x86_64-unknown-linux-gnux32`
921 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
922
923 Internal Only
924 -------------
925
926 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
927
928 [79135]: https://github.com/rust-lang/rust/pull/79135
929 [74489]: https://github.com/rust-lang/rust/pull/74489
930 [76934]: https://github.com/rust-lang/rust/pull/76934
931 [79570]: https://github.com/rust-lang/rust/pull/79570
932 [80181]: https://github.com/rust-lang/rust/pull/80181
933 [79642]: https://github.com/rust-lang/rust/pull/79642
934 [80945]: https://github.com/rust-lang/rust/pull/80945
935 [80279]: https://github.com/rust-lang/rust/pull/80279
936 [80053]: https://github.com/rust-lang/rust/pull/80053
937 [79502]: https://github.com/rust-lang/rust/pull/79502
938 [75180]: https://github.com/rust-lang/rust/pull/75180
939 [79135]: https://github.com/rust-lang/rust/pull/79135
940 [81521]: https://github.com/rust-lang/rust/pull/81521
941 [80968]: https://github.com/rust-lang/rust/pull/80968
942 [80959]: https://github.com/rust-lang/rust/pull/80959
943 [80718]: https://github.com/rust-lang/rust/pull/80718
944 [80653]: https://github.com/rust-lang/rust/pull/80653
945 [80579]: https://github.com/rust-lang/rust/pull/80579
946 [79998]: https://github.com/rust-lang/rust/pull/79998
947 [78044]: https://github.com/rust-lang/rust/pull/78044
948 [81455]: https://github.com/rust-lang/rust/pull/81455
949 [80764]: https://github.com/rust-lang/rust/pull/80764
950 [80749]: https://github.com/rust-lang/rust/pull/80749
951 [80662]: https://github.com/rust-lang/rust/pull/80662
952 [79134]: https://github.com/rust-lang/rust/pull/79134
953 [80966]: https://github.com/rust-lang/rust/pull/80966
954 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
955 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
956 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
957 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
958 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
959 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
960 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
961 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
962 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
963 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
964 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
965 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
966 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
967 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
968 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
969 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
970 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
971 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
972 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
973 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
974 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
975 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
976 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
977
978 Version 1.50.0 (2021-02-11)
979 ============================
980
981 Language
982 -----------------------
983 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
984   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
985 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
986
987 Compiler
988 -----------------------
989 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
990 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
991 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
992 - [Dropped support for all cloudabi targets.][78439]
993
994 \* Refer to Rust's [platform support page][platform-support-doc] for more
995 information on Rust's tiered platform support.
996
997 Libraries
998 -----------------------
999
1000 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1001 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1002 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1003   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1004   up the same amount of space as `File`.
1005
1006 Stabilized APIs
1007 ---------------
1008
1009 - [`bool::then`]
1010 - [`btree_map::Entry::or_insert_with_key`]
1011 - [`f32::clamp`]
1012 - [`f64::clamp`]
1013 - [`hash_map::Entry::or_insert_with_key`]
1014 - [`Ord::clamp`]
1015 - [`RefCell::take`]
1016 - [`slice::fill`]
1017 - [`UnsafeCell::get_mut`]
1018
1019 The following previously stable methods are now `const`.
1020
1021 - [`IpAddr::is_ipv4`]
1022 - [`IpAddr::is_ipv6`]
1023 - [`IpAddr::is_unspecified`]
1024 - [`IpAddr::is_loopback`]
1025 - [`IpAddr::is_multicast`]
1026 - [`Ipv4Addr::octets`]
1027 - [`Ipv4Addr::is_loopback`]
1028 - [`Ipv4Addr::is_private`]
1029 - [`Ipv4Addr::is_link_local`]
1030 - [`Ipv4Addr::is_multicast`]
1031 - [`Ipv4Addr::is_broadcast`]
1032 - [`Ipv4Addr::is_documentation`]
1033 - [`Ipv4Addr::to_ipv6_compatible`]
1034 - [`Ipv4Addr::to_ipv6_mapped`]
1035 - [`Ipv6Addr::segments`]
1036 - [`Ipv6Addr::is_unspecified`]
1037 - [`Ipv6Addr::is_loopback`]
1038 - [`Ipv6Addr::is_multicast`]
1039 - [`Ipv6Addr::to_ipv4`]
1040 - [`Layout::size`]
1041 - [`Layout::align`]
1042 - [`Layout::from_size_align`]
1043 - `pow` for all integer types.
1044 - `checked_pow` for all integer types.
1045 - `saturating_pow` for all integer types.
1046 - `wrapping_pow` for all integer types.
1047 - `next_power_of_two` for all unsigned integer types.
1048 - `checked_next_power_of_two` for all unsigned integer types.
1049
1050 Cargo
1051 -----------------------
1052
1053 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1054   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1055 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1056   contents of that directory for changes.][cargo/8973]
1057 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1058
1059 Misc
1060 ----
1061
1062 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1063 - [Running tests will now print the total time taken to execute.][75752]
1064
1065 Compatibility Notes
1066 -------------------
1067
1068 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1069   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1070 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1071   unhygenic `macro_rules!` macros.][79472]
1072 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1073   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1074 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1075 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1076   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1077 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1078
1079 [74989]: https://github.com/rust-lang/rust/pull/74989
1080 [79261]: https://github.com/rust-lang/rust/pull/79261
1081 [79896]: https://github.com/rust-lang/rust/pull/79896
1082 [79484]: https://github.com/rust-lang/rust/pull/79484
1083 [79472]: https://github.com/rust-lang/rust/pull/79472
1084 [79270]: https://github.com/rust-lang/rust/pull/79270
1085 [79003]: https://github.com/rust-lang/rust/pull/79003
1086 [78864]: https://github.com/rust-lang/rust/pull/78864
1087 [78636]: https://github.com/rust-lang/rust/pull/78636
1088 [78439]: https://github.com/rust-lang/rust/pull/78439
1089 [78343]: https://github.com/rust-lang/rust/pull/78343
1090 [78296]: https://github.com/rust-lang/rust/pull/78296
1091 [78068]: https://github.com/rust-lang/rust/pull/78068
1092 [75752]: https://github.com/rust-lang/rust/pull/75752
1093 [74699]: https://github.com/rust-lang/rust/pull/74699
1094 [78142]: https://github.com/rust-lang/rust/pull/78142
1095 [77484]: https://github.com/rust-lang/rust/pull/77484
1096 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1097 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1098 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1099 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1100 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1101 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1102 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1103 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1104 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1105 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1106 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1107 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1108 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1109 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1110 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1111 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1112 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1113 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1114 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1115 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1116 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1117 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1118 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1119 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1120 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1121 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1122 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1123 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1124 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1125 [`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
1126 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1127 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1128 [`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
1129 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1130
1131
1132 Version 1.49.0 (2020-12-31)
1133 ============================
1134
1135 Language
1136 -----------------------
1137
1138 - [Unions can now implement `Drop`, and you can now have a field in a union
1139   with `ManuallyDrop<T>`.][77547]
1140 - [You can now cast uninhabited enums to integers.][76199]
1141 - [You can now bind by reference and by move in patterns.][76119] This
1142   allows you to selectively borrow individual components of a type. E.g.
1143   ```rust
1144   #[derive(Debug)]
1145   struct Person {
1146       name: String,
1147       age: u8,
1148   }
1149
1150   let person = Person {
1151       name: String::from("Alice"),
1152       age: 20,
1153   };
1154
1155   // `name` is moved out of person, but `age` is referenced.
1156   let Person { name, ref age } = person;
1157   println!("{} {}", name, age);
1158   ```
1159
1160 Compiler
1161 -----------------------
1162
1163 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1164 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1165 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1166 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1167 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1168 - [Output from threads spawned in tests is now captured.][78227]
1169 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1170
1171 \* Refer to Rust's [platform support page][platform-support-doc] for more
1172 information on Rust's tiered platform support.
1173
1174 Libraries
1175 -----------------------
1176
1177 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1178 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1179
1180 Stabilized APIs
1181 ---------------
1182
1183 - [`slice::select_nth_unstable`]
1184 - [`slice::select_nth_unstable_by`]
1185 - [`slice::select_nth_unstable_by_key`]
1186
1187 The following previously stable methods are now `const`.
1188
1189 - [`Poll::is_ready`]
1190 - [`Poll::is_pending`]
1191
1192 Cargo
1193 -----------------------
1194 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1195 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1196 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1197   variable will be set if the crate being built is one the user selected to build, either
1198   with `-p` or through defaults.
1199 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1200
1201
1202 Compatibility Notes
1203 -------------------
1204
1205 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1206 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1207 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1208   Previously such invalid or unused attributes could be ignored.
1209 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1210   read [this post about the changes][rustdoc-ws-post] for more details.
1211 - [Trait bounds are no longer inferred for associated types.][79904]
1212
1213 Internal Only
1214 -------------
1215 These changes provide no direct user facing benefits, but represent significant
1216 improvements to the internals and overall performance of rustc and
1217 related tools.
1218
1219 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1220   Local Storage model.][78201]
1221 - [Calculate visibilities once in resolve.][78077]
1222 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1223 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1224
1225
1226 [75991]: https://github.com/rust-lang/rust/pull/75991
1227 [78951]: https://github.com/rust-lang/rust/pull/78951
1228 [78848]: https://github.com/rust-lang/rust/pull/78848
1229 [78746]: https://github.com/rust-lang/rust/pull/78746
1230 [78376]: https://github.com/rust-lang/rust/pull/78376
1231 [78228]: https://github.com/rust-lang/rust/pull/78228
1232 [78227]: https://github.com/rust-lang/rust/pull/78227
1233 [78201]: https://github.com/rust-lang/rust/pull/78201
1234 [78109]: https://github.com/rust-lang/rust/pull/78109
1235 [78077]: https://github.com/rust-lang/rust/pull/78077
1236 [77997]: https://github.com/rust-lang/rust/pull/77997
1237 [77703]: https://github.com/rust-lang/rust/pull/77703
1238 [77547]: https://github.com/rust-lang/rust/pull/77547
1239 [77015]: https://github.com/rust-lang/rust/pull/77015
1240 [76199]: https://github.com/rust-lang/rust/pull/76199
1241 [76119]: https://github.com/rust-lang/rust/pull/76119
1242 [75914]: https://github.com/rust-lang/rust/pull/75914
1243 [79004]: https://github.com/rust-lang/rust/pull/79004
1244 [78676]: https://github.com/rust-lang/rust/pull/78676
1245 [79904]: https://github.com/rust-lang/rust/issues/79904
1246 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1247 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1248 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1249 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1250 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1251 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1252 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1253 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1254 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1255 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1256 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1257
1258 Version 1.48.0 (2020-11-19)
1259 ==========================
1260
1261 Language
1262 --------
1263
1264 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1265   is still rejected *semantically*, but can now be parsed by procedural macros.
1266
1267 Compiler
1268 --------
1269 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1270   `rustc` whether to link its own C runtime and libraries or to rely on a external
1271   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1272 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1273   Note: If you're using cargo you must explicitly pass the `--target` flag.
1274 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1275
1276 \* Refer to Rust's [platform support page][platform-support-doc] for more
1277 information on Rust's tiered platform support.
1278
1279 Libraries
1280 ---------
1281 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1282   and `&Stderr`.][76275]
1283 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1284 - [The `matches!` macro now supports having a trailing comma.][74880]
1285 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1286 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1287
1288 Stabilized APIs
1289 ---------------
1290 - [`slice::as_ptr_range`]
1291 - [`slice::as_mut_ptr_range`]
1292 - [`VecDeque::make_contiguous`]
1293 - [`future::pending`]
1294 - [`future::ready`]
1295
1296 The following previously stable methods are now `const fn`'s:
1297
1298 - [`Option::is_some`]
1299 - [`Option::is_none`]
1300 - [`Option::as_ref`]
1301 - [`Result::is_ok`]
1302 - [`Result::is_err`]
1303 - [`Result::as_ref`]
1304 - [`Ordering::reverse`]
1305 - [`Ordering::then`]
1306
1307 Cargo
1308 -----
1309
1310 Rustdoc
1311 -------
1312 - [You can now link to items in `rustdoc` using the intra-doc link
1313   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1314   a link to `std::future`'s documentation. See ["Linking to items by
1315   name"][intradoc-links] for more information.
1316 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1317   when searching through `rustdoc`'s UI.][75740]
1318
1319 Compatibility Notes
1320 -------------------
1321 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1322   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1323   promoted to `'static` lifetime any more inside `const fn`s.
1324 - [Associated type bindings on trait objects are now verified to meet the bounds
1325   declared on the trait when checking that they implement the trait.][27675]
1326 - [When trait bounds on associated types or opaque types are ambiguous, the
1327   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1328 - [Fixed recursive nonterminals not being expanded in macros during
1329   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1330   correctly handling recursive nonterminal tokens.
1331 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1332 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1333   in places where they have no effect.][73461]
1334 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1335   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1336 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1337   disallow zero-initialization.][71274]
1338 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1339 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1340   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1341   see the [`catch_unwind`] documentation for further information.
1342
1343
1344
1345 Internal Only
1346 -------------
1347 These changes provide no direct user facing benefits, but represent significant
1348 improvements to the internals and overall performance of rustc and
1349 related tools.
1350
1351 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1352   You can continue building with `make` by setting `ninja=false` in
1353   your `config.toml`.
1354 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1355 - [Made `ensure_sufficient_stack()` non-generic][76680]
1356
1357 [78143]: https://github.com/rust-lang/rust/issues/78143
1358 [76680]: https://github.com/rust-lang/rust/pull/76680/
1359 [76030]: https://github.com/rust-lang/rust/pull/76030/
1360 [70212]: https://github.com/rust-lang/rust/pull/70212/
1361 [27675]: https://github.com/rust-lang/rust/issues/27675/
1362 [54121]: https://github.com/rust-lang/rust/issues/54121/
1363 [71274]: https://github.com/rust-lang/rust/pull/71274/
1364 [77386]: https://github.com/rust-lang/rust/pull/77386/
1365 [77153]: https://github.com/rust-lang/rust/pull/77153/
1366 [77055]: https://github.com/rust-lang/rust/pull/77055/
1367 [76275]: https://github.com/rust-lang/rust/pull/76275/
1368 [76310]: https://github.com/rust-lang/rust/pull/76310/
1369 [76420]: https://github.com/rust-lang/rust/pull/76420/
1370 [76158]: https://github.com/rust-lang/rust/pull/76158/
1371 [75857]: https://github.com/rust-lang/rust/pull/75857/
1372 [75585]: https://github.com/rust-lang/rust/pull/75585/
1373 [75740]: https://github.com/rust-lang/rust/pull/75740/
1374 [75502]: https://github.com/rust-lang/rust/pull/75502/
1375 [74880]: https://github.com/rust-lang/rust/pull/74880/
1376 [74922]: https://github.com/rust-lang/rust/pull/74922/
1377 [74430]: https://github.com/rust-lang/rust/pull/74430/
1378 [74194]: https://github.com/rust-lang/rust/pull/74194/
1379 [73461]: https://github.com/rust-lang/rust/pull/73461/
1380 [73166]: https://github.com/rust-lang/rust/pull/73166/
1381 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1382 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1383 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1384 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1385 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1386 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1387 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1388 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1389 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1390 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1391 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1392 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1393 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1394 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1395 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1396
1397
1398 Version 1.47.0 (2020-10-08)
1399 ==========================
1400
1401 Language
1402 --------
1403 - [Closures will now warn when not used.][74869]
1404
1405 Compiler
1406 --------
1407 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1408   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1409   platforms.
1410 - [Upgraded to LLVM 11.][73526]
1411 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1412 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1413 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1414
1415 \* Refer to Rust's [platform support page][platform-support-doc] for more
1416 information on Rust's tiered platform support.
1417
1418 Libraries
1419 ---------
1420 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1421 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1422   those of length less than 33.][74060]
1423 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1424 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1425   `PartialEq`, and `PartialOrd`.][73583]
1426
1427 Stabilized APIs
1428 ---------------
1429 - [`Ident::new_raw`]
1430 - [`Range::is_empty`]
1431 - [`RangeInclusive::is_empty`]
1432 - [`Result::as_deref`]
1433 - [`Result::as_deref_mut`]
1434 - [`Vec::leak`]
1435 - [`pointer::offset_from`]
1436 - [`f32::TAU`]
1437 - [`f64::TAU`]
1438
1439 The following previously stable APIs have now been made const.
1440
1441 - [The `new` method for all `NonZero` integers.][73858]
1442 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1443   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1444   methods for all integers.][73858]
1445 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1446   signed integers.][73858]
1447 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1448   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1449   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1450   `is_ascii_control` methods for `char` and `u8`.][73858]
1451
1452 Cargo
1453 -----
1454 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1455   You can override this by setting the following in your `Cargo.toml`.
1456   ```toml
1457   [profile.release.build-override]
1458   opt-level = 3
1459   ```
1460 - [`cargo-help` will now display man pages for commands rather just the
1461   `--help` text.][cargo/8456]
1462 - [`cargo-metadata` now emits a `test` field indicating if a target has
1463   tests enabled.][cargo/8478]
1464 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1465 - [`cargo-publish` will now use an alternative registry by default if it's the
1466   only registry specified in `package.publish`.][cargo/8571]
1467
1468 Misc
1469 ----
1470 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1471   type based search.][75366]
1472 - [Added the Ayu theme to rustdoc.][71237]
1473
1474 Compatibility Notes
1475 -------------------
1476 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1477 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1478 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1479   help to preserve more span information.][73084] These changes may cause
1480   compiliation errors if your macro was unhygenic or didn't correctly handle
1481   `Delimiter::None`.
1482 - [Moved support for the CloudABI target to tier 3.][75568]
1483 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1484 - [Added the `rustc-docs` component.][75560] This allows you to install
1485   and read the documentation for the compiler internal APIs. (Currently only
1486   available for `x86_64-unknown-linux-gnu`.)
1487
1488 Internal Only
1489 --------
1490
1491 - [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.
1492
1493 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1494 [75048]: https://github.com/rust-lang/rust/pull/75048/
1495 [74163]: https://github.com/rust-lang/rust/pull/74163/
1496 [71237]: https://github.com/rust-lang/rust/pull/71237/
1497 [74869]: https://github.com/rust-lang/rust/pull/74869/
1498 [73858]: https://github.com/rust-lang/rust/pull/73858/
1499 [75716]: https://github.com/rust-lang/rust/pull/75716/
1500 [75908]: https://github.com/rust-lang/rust/pull/75908/
1501 [75516]: https://github.com/rust-lang/rust/pull/75516/
1502 [75560]: https://github.com/rust-lang/rust/pull/75560/
1503 [75568]: https://github.com/rust-lang/rust/pull/75568/
1504 [75366]: https://github.com/rust-lang/rust/pull/75366/
1505 [75204]: https://github.com/rust-lang/rust/pull/75204/
1506 [74650]: https://github.com/rust-lang/rust/pull/74650/
1507 [74419]: https://github.com/rust-lang/rust/pull/74419/
1508 [73964]: https://github.com/rust-lang/rust/pull/73964/
1509 [74021]: https://github.com/rust-lang/rust/pull/74021/
1510 [74060]: https://github.com/rust-lang/rust/pull/74060/
1511 [73893]: https://github.com/rust-lang/rust/pull/73893/
1512 [73526]: https://github.com/rust-lang/rust/pull/73526/
1513 [73583]: https://github.com/rust-lang/rust/pull/73583/
1514 [73084]: https://github.com/rust-lang/rust/pull/73084/
1515 [73197]: https://github.com/rust-lang/rust/pull/73197/
1516 [72488]: https://github.com/rust-lang/rust/pull/72488/
1517 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1518 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1519 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1520 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1521 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1522 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1523 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1524 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1525 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1526 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1527 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1528 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1529 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1530 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1531 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1532
1533
1534 Version 1.46.0 (2020-08-27)
1535 ==========================
1536
1537 Language
1538 --------
1539 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1540 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1541   const functions.][73862]
1542 - [The `#[track_caller]` attribute can now be added to functions to use the
1543   function's caller's location information for panic messages.][72445]
1544 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1545   `x.0.0` over `(x.0).0`.
1546 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1547   You currently can't use `mem::transmute` in constant functions.
1548
1549 Compiler
1550 --------
1551 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1552 - [Enabled static "Position Independent Executables" by default
1553   for `x86_64-unknown-linux-musl`.][70740]
1554
1555 Libraries
1556 ---------
1557 - [`mem::forget` is now a `const fn`.][73887]
1558 - [`String` now implements `From<char>`.][73466]
1559 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1560   integer types.][73032]
1561 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1562 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1563   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1564 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1565 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1566 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1567
1568 Stabilized APIs
1569 ---------------
1570 - [`Option::zip`]
1571 - [`vec::Drain::as_slice`]
1572
1573 Cargo
1574 -----
1575 Added a number of new environment variables that are now available when
1576 compiling your crate.
1577
1578 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1579   the specific binary being compiled and the name of the crate.
1580 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1581 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1582
1583 Compatibility Notes
1584 -------------------
1585 - [The target configuration option `abi_blacklist` has been renamed
1586   to `unsupported_abis`.][74150] The old name will still continue to work.
1587 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1588   This was previously accepted but will become a hard error in a future release.
1589 - [Rustc will fail to compile if you have a struct with
1590   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1591   allowed on `enum`s.
1592 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1593   ensure that spans have the correct information, and may cause breakage if you
1594   were relying on receiving spans with dummy information.
1595 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1596   a legacy installer that was replaced by a MSI installer a few years ago but
1597   was still being built.
1598 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1599 - [Rustc will no longer accept overlapping trait implementations that only
1600   differ in how the lifetime was bound.][72493]
1601 - [Rustc now correctly relates the lifetime of an existential associated
1602   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1603   you to pass a shorter lifetime than expected.
1604 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1605   The library will need to be installed for `rustc` to work, even though we
1606   expect it to be already available on most systems.
1607 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1608   under QEMU.][74820]
1609 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1610   exact output returned by rustc's pretty printing is an unstable
1611   implementation detail: we recommend any macro relying on it to switch to a
1612   more robust parsing system.
1613
1614 [75453]: https://github.com/rust-lang/rust/issues/75453/
1615 [74820]: https://github.com/rust-lang/rust/issues/74820/
1616 [74420]: https://github.com/rust-lang/rust/issues/74420/
1617 [74109]: https://github.com/rust-lang/rust/pull/74109/
1618 [74150]: https://github.com/rust-lang/rust/pull/74150/
1619 [73862]: https://github.com/rust-lang/rust/pull/73862/
1620 [73887]: https://github.com/rust-lang/rust/pull/73887/
1621 [73466]: https://github.com/rust-lang/rust/pull/73466/
1622 [73516]: https://github.com/rust-lang/rust/pull/73516/
1623 [73293]: https://github.com/rust-lang/rust/pull/73293/
1624 [73007]: https://github.com/rust-lang/rust/pull/73007/
1625 [73032]: https://github.com/rust-lang/rust/pull/73032/
1626 [72920]: https://github.com/rust-lang/rust/pull/72920/
1627 [72569]: https://github.com/rust-lang/rust/pull/72569/
1628 [72583]: https://github.com/rust-lang/rust/pull/72583/
1629 [72584]: https://github.com/rust-lang/rust/pull/72584/
1630 [72717]: https://github.com/rust-lang/rust/pull/72717/
1631 [72437]: https://github.com/rust-lang/rust/pull/72437/
1632 [72445]: https://github.com/rust-lang/rust/pull/72445/
1633 [72486]: https://github.com/rust-lang/rust/pull/72486/
1634 [72493]: https://github.com/rust-lang/rust/pull/72493/
1635 [72331]: https://github.com/rust-lang/rust/pull/72331/
1636 [71896]: https://github.com/rust-lang/rust/pull/71896/
1637 [71660]: https://github.com/rust-lang/rust/pull/71660/
1638 [71322]: https://github.com/rust-lang/rust/pull/71322/
1639 [70740]: https://github.com/rust-lang/rust/pull/70740/
1640 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1641 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1642 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1643 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1644 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1645
1646
1647 Version 1.45.2 (2020-08-03)
1648 ==========================
1649
1650 * [Fix bindings in tuple struct patterns][74954]
1651 * [Fix track_caller integration with trait objects][74784]
1652
1653 [74954]: https://github.com/rust-lang/rust/issues/74954
1654 [74784]: https://github.com/rust-lang/rust/issues/74784
1655
1656
1657 Version 1.45.1 (2020-07-30)
1658 ==========================
1659
1660 * [Fix const propagation with references.][73613]
1661 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1662 * [Avoid spurious implicit region bound.][74509]
1663 * [Install clippy on x.py install][74457]
1664
1665 [73613]: https://github.com/rust-lang/rust/pull/73613
1666 [73078]: https://github.com/rust-lang/rust/issues/73078
1667 [74509]: https://github.com/rust-lang/rust/pull/74509
1668 [74457]: https://github.com/rust-lang/rust/pull/74457
1669
1670
1671 Version 1.45.0 (2020-07-16)
1672 ==========================
1673
1674 Language
1675 --------
1676 - [Out of range float to int conversions using `as` has been defined as a saturating
1677   conversion.][71269] This was previously undefined behaviour, but you can use the
1678    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1679    may be desirable in rare performance sensitive situations.
1680 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1681   using `u64`.][70705]
1682 - [Function like procedural macros can now be used in expression, pattern, and  statement
1683   positions.][68717] This means you can now use a function-like procedural macro
1684   anywhere you can use a declarative (`macro_rules!`) macro.
1685
1686 Compiler
1687 --------
1688 - [You can now override individual target features through the `target-feature`
1689   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1690   equivalent to `-C target-feature=+avx2,+fma`.
1691 - [Added the `force-unwind-tables` flag.][69984] This option allows
1692   rustc to always generate unwind tables regardless of panic strategy.
1693 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1694   to include LLVM bitcode into generated `rlib`s (this is on by default).
1695 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1696 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1697 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1698 - [Upgraded to LLVM 10.][67759]
1699
1700 \* Refer to Rust's [platform support page][platform-support-doc] for more
1701 information on Rust's tiered platform support.
1702
1703
1704 Libraries
1705 ---------
1706 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1707   and `Ord`.][72239]
1708 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1709 - [You can now use `char` with
1710   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1711   a range of codepoints.][72413] E.g.
1712   you can now write the following;
1713   ```rust
1714   for ch in 'a'..='z' {
1715       print!("{}", ch);
1716   }
1717   println!();
1718   // Prints "abcdefghijklmnopqrstuvwxyz"
1719   ```
1720 - [`OsString` now implements `FromStr`.][71662]
1721 - [The `saturating_neg` method has been added to all signed integer primitive
1722   types, and the `saturating_abs` method has been added for all integer
1723   primitive types.][71886]
1724 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1725   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1726   or `Path`.][71447]
1727 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1728 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1729   integer types.][69813]
1730 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1731   integer types.][72324]
1732 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1733
1734 Stabilized APIs
1735 ---------------
1736 - [`Arc::as_ptr`]
1737 - [`BTreeMap::remove_entry`]
1738 - [`Rc::as_ptr`]
1739 - [`rc::Weak::as_ptr`]
1740 - [`rc::Weak::from_raw`]
1741 - [`rc::Weak::into_raw`]
1742 - [`str::strip_prefix`]
1743 - [`str::strip_suffix`]
1744 - [`sync::Weak::as_ptr`]
1745 - [`sync::Weak::from_raw`]
1746 - [`sync::Weak::into_raw`]
1747 - [`char::UNICODE_VERSION`]
1748 - [`Span::resolved_at`]
1749 - [`Span::located_at`]
1750 - [`Span::mixed_site`]
1751 - [`unix::process::CommandExt::arg0`]
1752
1753 Cargo
1754 -----
1755
1756 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1757   time.][cargo/8066]
1758
1759 Misc
1760 ----
1761 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1762   `~~outdated information~~` becomes "~~outdated information~~".
1763 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1764
1765 Compatibility Notes
1766 -------------------
1767 - [Trying to self initialize a static value (that is creating a value using
1768   itself) is unsound and now causes a compile error.][71140]
1769 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1770   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1771 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1772   previously undocumented and not intended for public use. Rustdoc still provides
1773   a non-zero exit code on errors.
1774 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1775   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1776   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1777   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1778   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1779
1780 Internals Only
1781 --------------
1782 - [Make clippy a git subtree instead of a git submodule][70655]
1783 - [Unify the undo log of all snapshot types][69464]
1784
1785 [71848]: https://github.com/rust-lang/rust/issues/71848/
1786 [73420]: https://github.com/rust-lang/rust/issues/73420/
1787 [72324]: https://github.com/rust-lang/rust/pull/72324/
1788 [71843]: https://github.com/rust-lang/rust/pull/71843/
1789 [71886]: https://github.com/rust-lang/rust/pull/71886/
1790 [72234]: https://github.com/rust-lang/rust/pull/72234/
1791 [72239]: https://github.com/rust-lang/rust/pull/72239/
1792 [72397]: https://github.com/rust-lang/rust/pull/72397/
1793 [72413]: https://github.com/rust-lang/rust/pull/72413/
1794 [72014]: https://github.com/rust-lang/rust/pull/72014/
1795 [72062]: https://github.com/rust-lang/rust/pull/72062/
1796 [72094]: https://github.com/rust-lang/rust/pull/72094/
1797 [72133]: https://github.com/rust-lang/rust/pull/72133/
1798 [67759]: https://github.com/rust-lang/rust/pull/67759/
1799 [71900]: https://github.com/rust-lang/rust/pull/71900/
1800 [71928]: https://github.com/rust-lang/rust/pull/71928/
1801 [71662]: https://github.com/rust-lang/rust/pull/71662/
1802 [71716]: https://github.com/rust-lang/rust/pull/71716/
1803 [71447]: https://github.com/rust-lang/rust/pull/71447/
1804 [71269]: https://github.com/rust-lang/rust/pull/71269/
1805 [71095]: https://github.com/rust-lang/rust/pull/71095/
1806 [71140]: https://github.com/rust-lang/rust/pull/71140/
1807 [70655]: https://github.com/rust-lang/rust/pull/70655/
1808 [70705]: https://github.com/rust-lang/rust/pull/70705/
1809 [69984]: https://github.com/rust-lang/rust/pull/69984/
1810 [69813]: https://github.com/rust-lang/rust/pull/69813/
1811 [69464]: https://github.com/rust-lang/rust/pull/69464/
1812 [68717]: https://github.com/rust-lang/rust/pull/68717/
1813 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1814 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1815 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1816 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1817 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1818 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1819 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1820 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1821 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1822 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1823 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1824 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1825 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1826 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1827 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1828 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1829 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1830
1831
1832 Version 1.44.1 (2020-06-18)
1833 ===========================
1834
1835 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1836 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1837 * [Fix crashes when finding backtrace on macOS.][71397]
1838 * [Clippy applies lint levels into different files.][clippy/5356]
1839
1840 [71397]: https://github.com/rust-lang/rust/issues/71397
1841 [73078]: https://github.com/rust-lang/rust/issues/73078
1842 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1843 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1844
1845
1846 Version 1.44.0 (2020-06-04)
1847 ==========================
1848
1849 Language
1850 --------
1851 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1852 - [Added the `unused_braces` lint.][70081]
1853
1854 **Syntax-only changes**
1855
1856 - [Expansion-driven outline module parsing][69838]
1857 ```rust
1858 #[cfg(FALSE)]
1859 mod foo {
1860     mod bar {
1861         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1862     }
1863 }
1864 ```
1865
1866 These are still rejected semantically, so you will likely receive an error but
1867 these changes can be seen and parsed by macros and conditional compilation.
1868
1869 Compiler
1870 --------
1871 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1872   Additionally when in incremental mode rustc defaults to 256 codegen units.
1873 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1874   a panic is thrown.][67502]
1875 - [Added tier 3\* support for the `aarch64-unknown-none` and
1876   `aarch64-unknown-none-softfloat` targets.][68334]
1877 - [Added tier 3 support for `arm64-apple-tvos` and
1878   `x86_64-apple-tvos` targets.][68191]
1879
1880
1881 Libraries
1882 ---------
1883 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1884   `vec![]` to be able to be used in `const` contexts.
1885 - [`convert::Infallible` now implements `Hash`.][70281]
1886 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1887   a `&mut OsStr`.][70048]
1888 - [Unicode 13 is now supported.][69929]
1889 - [`String` now implements `From<&mut str>`.][69661]
1890 - [`IoSlice` now implements `Copy`.][69403]
1891 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1892 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1893 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1894   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1895   integer types.][69373]
1896
1897 Stabilized APIs
1898 ---------------
1899 - [`PathBuf::with_capacity`]
1900 - [`PathBuf::capacity`]
1901 - [`PathBuf::clear`]
1902 - [`PathBuf::reserve`]
1903 - [`PathBuf::reserve_exact`]
1904 - [`PathBuf::shrink_to_fit`]
1905 - [`f32::to_int_unchecked`]
1906 - [`f64::to_int_unchecked`]
1907 - [`Layout::align_to`]
1908 - [`Layout::pad_to_align`]
1909 - [`Layout::array`]
1910 - [`Layout::extend`]
1911
1912 Cargo
1913 -----
1914 - [Added the `cargo tree` command which will print a tree graph of
1915   your dependencies.][cargo/8062] E.g.
1916   ```
1917     mdbook v0.3.2 (/Users/src/rust/mdbook)
1918   ├── ammonia v3.0.0
1919   │   ├── html5ever v0.24.0
1920   │   │   ├── log v0.4.8
1921   │   │   │   └── cfg-if v0.1.9
1922   │   │   ├── mac v0.1.1
1923   │   │   └── markup5ever v0.9.0
1924   │   │       ├── log v0.4.8 (*)
1925   │   │       ├── phf v0.7.24
1926   │   │       │   └── phf_shared v0.7.24
1927   │   │       │       ├── siphasher v0.2.3
1928   │   │       │       └── unicase v1.4.2
1929   │   │       │           [build-dependencies]
1930   │   │       │           └── version_check v0.1.5
1931   ...
1932   ```
1933   You can also display dependencies on multiple versions of the same crate with
1934   `cargo tree -d` (short for `cargo tree --duplicates`).
1935
1936 Misc
1937 ----
1938 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1939   the version in the sidebar.][69494]
1940
1941 Compatibility Notes
1942 -------------------
1943 - [Rustc now correctly generates static libraries on Windows GNU targets with
1944   the `.a` extension, rather than the previous `.lib`.][70937]
1945 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1946 - [The `file_name` property in JSON output of macro errors now points the actual
1947   source file rather than the previous format of `<NAME macros>`.][70969]
1948   **Note:** this may not point to a file that actually exists on the user's system.
1949 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1950 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1951   not allow zero initialization such as `NonZeroU8`.][66059] This was
1952   previously a warning.
1953 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1954   operator has been defined as a saturating operation.][71269] This was previously
1955   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1956   continue using the current behaviour, which may be desirable in rare performance
1957   sensitive situations.
1958
1959 Internal Only
1960 -------------
1961 These changes provide no direct user facing benefits, but represent significant
1962 improvements to the internals and overall performance of rustc and
1963 related tools.
1964
1965 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1966 - [Replace big JS dict with JSON parsing.][71250]
1967
1968 [69373]: https://github.com/rust-lang/rust/pull/69373/
1969 [66059]: https://github.com/rust-lang/rust/pull/66059/
1970 [68191]: https://github.com/rust-lang/rust/pull/68191/
1971 [68899]: https://github.com/rust-lang/rust/pull/68899/
1972 [71147]: https://github.com/rust-lang/rust/pull/71147/
1973 [71250]: https://github.com/rust-lang/rust/pull/71250/
1974 [70937]: https://github.com/rust-lang/rust/pull/70937/
1975 [70969]: https://github.com/rust-lang/rust/pull/70969/
1976 [70632]: https://github.com/rust-lang/rust/pull/70632/
1977 [70281]: https://github.com/rust-lang/rust/pull/70281/
1978 [70345]: https://github.com/rust-lang/rust/pull/70345/
1979 [70048]: https://github.com/rust-lang/rust/pull/70048/
1980 [70081]: https://github.com/rust-lang/rust/pull/70081/
1981 [70156]: https://github.com/rust-lang/rust/pull/70156/
1982 [71269]: https://github.com/rust-lang/rust/pull/71269/
1983 [69838]: https://github.com/rust-lang/rust/pull/69838/
1984 [69929]: https://github.com/rust-lang/rust/pull/69929/
1985 [69661]: https://github.com/rust-lang/rust/pull/69661/
1986 [69778]: https://github.com/rust-lang/rust/pull/69778/
1987 [69494]: https://github.com/rust-lang/rust/pull/69494/
1988 [69403]: https://github.com/rust-lang/rust/pull/69403/
1989 [69033]: https://github.com/rust-lang/rust/pull/69033/
1990 [68692]: https://github.com/rust-lang/rust/pull/68692/
1991 [68334]: https://github.com/rust-lang/rust/pull/68334/
1992 [67502]: https://github.com/rust-lang/rust/pull/67502/
1993 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1994 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1995 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1996 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1997 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1998 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1999 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2000 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2001 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2002 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2003 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2004 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2005 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2006
2007
2008 Version 1.43.1 (2020-05-07)
2009 ===========================
2010
2011 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2012 * [Fixed the stabilization of AVX-512 features.][71473]
2013 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2014
2015 [71430]: https://github.com/rust-lang/rust/pull/71430
2016 [71473]: https://github.com/rust-lang/rust/issues/71473
2017 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2018
2019
2020 Version 1.43.0 (2020-04-23)
2021 ==========================
2022
2023 Language
2024 --------
2025 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2026   the type inferred correctly.][68129]
2027 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2028
2029 **Syntax only changes**
2030 - [Allow `type Foo: Ord` syntactically.][69361]
2031 - [Fuse associated and extern items up to defaultness.][69194]
2032 - [Syntactically allow `self` in all `fn` contexts.][68764]
2033 - [Merge `fn` syntax + cleanup item parsing.][68728]
2034 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2035   For example, you may now write:
2036   ```rust
2037   macro_rules! mac_trait {
2038       ($i:item) => {
2039           trait T { $i }
2040       }
2041   }
2042   mac_trait! {
2043       fn foo() {}
2044   }
2045   ```
2046
2047 These are still rejected *semantically*, so you will likely receive an error but
2048 these changes can be seen and parsed by macros and
2049 conditional compilation.
2050
2051
2052 Compiler
2053 --------
2054 - [You can now pass multiple lint flags to rustc to override the previous
2055   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2056   everything in the `unused` lint group except `unused-variables` which
2057   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2058   everything in the `unused` lint group **including** `unused-variables` since
2059   the allow flag is specified before the deny flag (and therefore overridden).
2060 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2061   if they are available on `windows-gnu`.][67429]
2062 - [rustc now buffers errors/warnings printed in JSON.][69227]
2063
2064 Libraries
2065 ---------
2066 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2067   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2068   respectively.][69538] **Note** These conversions are only available when `N`
2069   is `0..=32`.
2070 - [You can now use associated constants on floats and integers directly, rather
2071   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2072   `f32::NAN` with no imports.
2073 - [`u8::is_ascii` is now `const`.][68984]
2074 - [`String` now implements `AsMut<str>`.][68742]
2075 - [Added the `primitive` module to `std` and `core`.][67637] This module
2076   reexports Rust's primitive types. This is mainly useful in macros
2077   where you want avoid these types being shadowed.
2078 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2079 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2080
2081 Stabilized APIs
2082 ---------------
2083 - [`Once::is_completed`]
2084 - [`f32::LOG10_2`]
2085 - [`f32::LOG2_10`]
2086 - [`f64::LOG10_2`]
2087 - [`f64::LOG2_10`]
2088 - [`iter::once_with`]
2089
2090 Cargo
2091 -----
2092 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2093   your environment.][cargo/7823]
2094 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2095   executable path when running integration tests or benchmarks.][cargo/7697]
2096   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2097   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2098
2099 Misc
2100 ----
2101 - [Certain checks in the `const_err` lint were deemed unrelated to const
2102   evaluation][69185], and have been moved to the `unconditional_panic` and
2103   `arithmetic_overflow` lints.
2104
2105 Compatibility Notes
2106 -------------------
2107
2108 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2109   has been a warning since 1.36.0.
2110 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2111   led to some instances being accepted, and now correctly emits a hard error.
2112
2113 [69340]: https://github.com/rust-lang/rust/pull/69340
2114
2115 Internal Only
2116 -------------
2117 These changes provide no direct user facing benefits, but represent significant
2118 improvements to the internals and overall performance of `rustc` and
2119 related tools.
2120
2121 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2122 - [Improved how rustc generates drop code.][67332]
2123 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2124 - [traits: preallocate 2 Vecs of known initial size][69022]
2125 - [Avoid exponential behaviour when relating types][68772]
2126 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2127 - [Improve performance of coherence checks][68966]
2128 - [Deduplicate types in the generator witness][68672]
2129 - [Invert control in struct_lint_level.][68725]
2130
2131 [67332]: https://github.com/rust-lang/rust/pull/67332/
2132 [67429]: https://github.com/rust-lang/rust/pull/67429/
2133 [67637]: https://github.com/rust-lang/rust/pull/67637/
2134 [67642]: https://github.com/rust-lang/rust/pull/67642/
2135 [67878]: https://github.com/rust-lang/rust/pull/67878/
2136 [67885]: https://github.com/rust-lang/rust/pull/67885/
2137 [68129]: https://github.com/rust-lang/rust/pull/68129/
2138 [68672]: https://github.com/rust-lang/rust/pull/68672/
2139 [68725]: https://github.com/rust-lang/rust/pull/68725/
2140 [68728]: https://github.com/rust-lang/rust/pull/68728/
2141 [68738]: https://github.com/rust-lang/rust/pull/68738/
2142 [68742]: https://github.com/rust-lang/rust/pull/68742/
2143 [68764]: https://github.com/rust-lang/rust/pull/68764/
2144 [68772]: https://github.com/rust-lang/rust/pull/68772/
2145 [68943]: https://github.com/rust-lang/rust/pull/68943/
2146 [68952]: https://github.com/rust-lang/rust/pull/68952/
2147 [68966]: https://github.com/rust-lang/rust/pull/68966/
2148 [68984]: https://github.com/rust-lang/rust/pull/68984/
2149 [69022]: https://github.com/rust-lang/rust/pull/69022/
2150 [69185]: https://github.com/rust-lang/rust/pull/69185/
2151 [69194]: https://github.com/rust-lang/rust/pull/69194/
2152 [69201]: https://github.com/rust-lang/rust/pull/69201/
2153 [69227]: https://github.com/rust-lang/rust/pull/69227/
2154 [69548]: https://github.com/rust-lang/rust/pull/69548/
2155 [69256]: https://github.com/rust-lang/rust/pull/69256/
2156 [69361]: https://github.com/rust-lang/rust/pull/69361/
2157 [69366]: https://github.com/rust-lang/rust/pull/69366/
2158 [69538]: https://github.com/rust-lang/rust/pull/69538/
2159 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2160 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2161 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2162 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2163 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2164 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2165 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2166 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2167
2168
2169 Version 1.42.0 (2020-03-12)
2170 ==========================
2171
2172 Language
2173 --------
2174 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2175   ```rust
2176   fn foo(words: &[&str]) {
2177       match words {
2178           ["Hello", "World", "!", ..] => println!("Hello World!"),
2179           ["Foo", "Bar", ..] => println!("Baz"),
2180           rest => println!("{:?}", rest),
2181       }
2182   }
2183   ```
2184 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2185   that you can create an enum that has the exact layout and ABI of the type
2186   it contains.
2187 - [You can now use outer attribute procedural macros on inline modules.][64273]
2188 - [There are some *syntax-only* changes:][67131]
2189    - `default` is syntactically allowed before items in `trait` definitions.
2190    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2191      leave out their bodies in favor of `;`.
2192    - Bounds on associated types in `impl`s are now syntactically allowed
2193      (e.g. `type Foo: Ord;`).
2194    - `...` (the C-variadic type) may occur syntactically directly as the type of
2195       any function parameter.
2196
2197   These are still rejected *semantically*, so you will likely receive an error
2198   but these changes can be seen and parsed by procedural macros and
2199   conditional compilation.
2200
2201 Compiler
2202 --------
2203 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2204 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2205 - [`Option::{expect,unwrap}` and
2206    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2207    pointing to the location where they were called, rather than
2208    `core`'s internals. ][67887]
2209
2210 \* Refer to Rust's [platform support page][platform-support-doc] for more
2211 information on Rust's tiered platform support.
2212
2213 Libraries
2214 ---------
2215 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2216 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2217    to implement `Sized`.][67935]
2218 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2219 - [`Layout::new` is now `const`.][66254]
2220 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2221
2222
2223 Stabilized APIs
2224 ---------------
2225 - [`CondVar::wait_while`]
2226 - [`CondVar::wait_timeout_while`]
2227 - [`DebugMap::key`]
2228 - [`DebugMap::value`]
2229 - [`ManuallyDrop::take`]
2230 - [`matches!`]
2231 - [`ptr::slice_from_raw_parts_mut`]
2232 - [`ptr::slice_from_raw_parts`]
2233
2234 Cargo
2235 -----
2236 - [You no longer need to include `extern crate proc_macro;` to be able to
2237   `use proc_macro;` in the `2018` edition.][cargo/7700]
2238
2239 Compatibility Notes
2240 -------------------
2241 - [`Error::description` has been deprecated, and its use will now produce a
2242   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2243
2244 [68253]: https://github.com/rust-lang/rust/pull/68253/
2245 [68348]: https://github.com/rust-lang/rust/pull/68348/
2246 [67935]: https://github.com/rust-lang/rust/pull/67935/
2247 [68339]: https://github.com/rust-lang/rust/pull/68339/
2248 [68122]: https://github.com/rust-lang/rust/pull/68122/
2249 [64273]: https://github.com/rust-lang/rust/pull/64273/
2250 [67712]: https://github.com/rust-lang/rust/pull/67712/
2251 [67887]: https://github.com/rust-lang/rust/pull/67887/
2252 [67131]: https://github.com/rust-lang/rust/pull/67131/
2253 [67233]: https://github.com/rust-lang/rust/pull/67233/
2254 [66899]: https://github.com/rust-lang/rust/pull/66899/
2255 [66919]: https://github.com/rust-lang/rust/pull/66919/
2256 [66254]: https://github.com/rust-lang/rust/pull/66254/
2257 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2258 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2259 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2260 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2261 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2262 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2263 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2264 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2265 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2266
2267
2268 Version 1.41.1 (2020-02-27)
2269 ===========================
2270
2271 * [Always check types of static items][69145]
2272 * [Always check lifetime bounds of `Copy` impls][69145]
2273 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2274
2275 [69225]: https://github.com/rust-lang/rust/issues/69225
2276 [69145]: https://github.com/rust-lang/rust/pull/69145
2277
2278
2279 Version 1.41.0 (2020-01-30)
2280 ===========================
2281
2282 Language
2283 --------
2284
2285 - [You can now pass type parameters to foreign items when implementing
2286   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2287 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2288   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2289   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2290 - [You can now use any valid identifier in a `format_args` macro.][66847]
2291   Previously identifiers starting with an underscore were not allowed.
2292 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2293   enum variants.][66183] These are still rejected semantically, but
2294   can be seen and parsed by procedural macros and conditional compilation.
2295
2296 Compiler
2297 --------
2298
2299 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2300 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2301 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2302 - [You can now pass an arguments file passing the `@path` syntax
2303   to rustc.][66172] Note that the format differs somewhat from what is
2304   found in other tooling; please see [the documentation][argfile-docs] for
2305   more information.
2306 - [You can now provide `--extern` flag without a path, indicating that it is
2307   available from the search path or specified with an `-L` flag.][64882]
2308
2309 \* Refer to Rust's [platform support page][platform-support-doc] for more
2310 information on Rust's tiered platform support.
2311
2312 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2313
2314 Libraries
2315 ---------
2316
2317 - [The `core::panic` module is now stable.][66771] It was already stable
2318   through `std`.
2319 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2320   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2321 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2322
2323 Stabilized APIs
2324 ---------------
2325
2326 - [`Result::map_or`]
2327 - [`Result::map_or_else`]
2328 - [`std::rc::Weak::weak_count`]
2329 - [`std::rc::Weak::strong_count`]
2330 - [`std::sync::Weak::weak_count`]
2331 - [`std::sync::Weak::strong_count`]
2332
2333 Cargo
2334 -----
2335
2336 - [Cargo will now document all the private items for binary crates
2337   by default.][cargo/7593]
2338 - [`cargo-install` will now reinstall the package if it detects that it is out
2339   of date.][cargo/7560]
2340 - [Cargo.lock now uses a more git friendly format that should help to reduce
2341   merge conflicts.][cargo/7579]
2342 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2343   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2344   optimisation level to `2` for debug builds. You can also use
2345   `[profile.<profile>.build-override]` to override build scripts and
2346   their dependencies.
2347
2348 Misc
2349 ----
2350
2351 - [You can now specify `edition` in documentation code blocks to compile the block
2352   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2353   should be compiled the 2018 edition of Rust.
2354 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2355   current theme with `--check-theme`.][54733]
2356 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2357
2358 Compatibility Notes
2359 -------------------
2360
2361 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2362   Apple targets.][apple-32bit-drop] This means that the source code is still
2363   available to build, but the targets are no longer being tested and release
2364   binaries for those platforms will no longer be distributed by the Rust project.
2365   Please refer to the linked blog post for more information.
2366
2367 [54733]: https://github.com/rust-lang/rust/pull/54733/
2368 [61351]: https://github.com/rust-lang/rust/pull/61351/
2369 [67255]: https://github.com/rust-lang/rust/pull/67255/
2370 [66661]: https://github.com/rust-lang/rust/pull/66661/
2371 [66771]: https://github.com/rust-lang/rust/pull/66771/
2372 [66847]: https://github.com/rust-lang/rust/pull/66847/
2373 [66238]: https://github.com/rust-lang/rust/pull/66238/
2374 [66277]: https://github.com/rust-lang/rust/pull/66277/
2375 [66325]: https://github.com/rust-lang/rust/pull/66325/
2376 [66172]: https://github.com/rust-lang/rust/pull/66172/
2377 [66183]: https://github.com/rust-lang/rust/pull/66183/
2378 [65879]: https://github.com/rust-lang/rust/pull/65879/
2379 [65013]: https://github.com/rust-lang/rust/pull/65013/
2380 [64882]: https://github.com/rust-lang/rust/pull/64882/
2381 [64325]: https://github.com/rust-lang/rust/pull/64325/
2382 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2383 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2384 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2385 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2386 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2387 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2388 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2389 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2390 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2391 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2392 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2393
2394 Version 1.40.0 (2019-12-19)
2395 ===========================
2396
2397 Language
2398 --------
2399 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2400   `const` contexts.][65188] e.g.
2401
2402   ```rust
2403   pub struct Point(i32, i32);
2404
2405   const ORIGIN: Point = {
2406       let constructor = Point;
2407
2408       constructor(0, 0)
2409   };
2410   ```
2411
2412 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2413   indicate that there may be variants or fields added in the future.][64639]
2414   For example this requires adding a wild-card branch (`_ => {}`) to any match
2415   statements on a non-exhaustive `enum`. [(RFC 2008)]
2416 - [You can now use function-like procedural macros in `extern` blocks and in
2417   type positions.][63931] e.g. `type Generated = macro!();`
2418 - [Function-like and attribute procedural macros can now emit
2419   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2420 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2421   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2422   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2423
2424 Compiler
2425 --------
2426 - [Added tier 3 support\* for the
2427   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2428 - [Added tier 3 support for the
2429   `aarch64-unknown-none-softfloat` target.][64589]
2430 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2431   `mips64el-unknown-linux-muslabi64` targets.][65843]
2432
2433 \* Refer to Rust's [platform support page][platform-support-doc] for more
2434   information on Rust's tiered platform support.
2435
2436 Libraries
2437 ---------
2438 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2439
2440 Stabilized APIs
2441 ---------------
2442 - [`BTreeMap::get_key_value`]
2443 - [`HashMap::get_key_value`]
2444 - [`Option::as_deref_mut`]
2445 - [`Option::as_deref`]
2446 - [`Option::flatten`]
2447 - [`UdpSocket::peer_addr`]
2448 - [`f32::to_be_bytes`]
2449 - [`f32::to_le_bytes`]
2450 - [`f32::to_ne_bytes`]
2451 - [`f64::to_be_bytes`]
2452 - [`f64::to_le_bytes`]
2453 - [`f64::to_ne_bytes`]
2454 - [`f32::from_be_bytes`]
2455 - [`f32::from_le_bytes`]
2456 - [`f32::from_ne_bytes`]
2457 - [`f64::from_be_bytes`]
2458 - [`f64::from_le_bytes`]
2459 - [`f64::from_ne_bytes`]
2460 - [`mem::take`]
2461 - [`slice::repeat`]
2462 - [`todo!`]
2463
2464 Cargo
2465 -----
2466 - [Cargo will now always display warnings, rather than only on
2467   fresh builds.][cargo/7450]
2468 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2469   now produce an error.][cargo/7507] Previously these flags were ignored.
2470 - [You can now publish `dev-dependencies` without including
2471   a `version`.][cargo/7333]
2472
2473 Misc
2474 ----
2475 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2476   when running documentation tests with `rustdoc`.][63803]
2477
2478 Compatibility Notes
2479 -------------------
2480 - [As previously announced, any previous NLL warnings in the 2015 edition are
2481   now hard errors.][64221]
2482 - [The `include!` macro will now warn if it failed to include the
2483   entire file.][64284] The `include!` macro unintentionally only includes the
2484   first _expression_ in a file, and this can be unintuitive. This will become
2485   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2486 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2487   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2488   or `extern` blocks now correctly emits a hard error.
2489
2490 [65294]: https://github.com/rust-lang/rust/pull/65294/
2491 [66103]: https://github.com/rust-lang/rust/pull/66103/
2492 [65843]: https://github.com/rust-lang/rust/pull/65843/
2493 [65188]: https://github.com/rust-lang/rust/pull/65188/
2494 [65092]: https://github.com/rust-lang/rust/pull/65092/
2495 [64589]: https://github.com/rust-lang/rust/pull/64589/
2496 [64639]: https://github.com/rust-lang/rust/pull/64639/
2497 [64221]: https://github.com/rust-lang/rust/pull/64221/
2498 [64284]: https://github.com/rust-lang/rust/pull/64284/
2499 [63931]: https://github.com/rust-lang/rust/pull/63931/
2500 [64035]: https://github.com/rust-lang/rust/pull/64035/
2501 [63674]: https://github.com/rust-lang/rust/pull/63674/
2502 [63803]: https://github.com/rust-lang/rust/pull/63803/
2503 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2504 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2505 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2506 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2507 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2508 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2509 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2510 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2511 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2512 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2513 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2514 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2515 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2516 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2517 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2518 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2519 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2520 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2521 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2522 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2523 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2524 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2525 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2526 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2527 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2528 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2529
2530
2531 Version 1.39.0 (2019-11-07)
2532 ===========================
2533
2534 Language
2535 --------
2536 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2537   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2538 - [You can now use certain attributes on function, closure, and function pointer
2539   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2540   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2541   attributes applied to items. e.g.
2542   ```rust
2543   fn len(
2544       #[cfg(windows)] slice: &[u16],
2545       #[cfg(not(windows))] slice: &[u8],
2546   ) -> usize {
2547       slice.len()
2548   }
2549   ```
2550 - [You can now take shared references to bind-by-move patterns in the `if` guards
2551   of `match` arms.][63118] e.g.
2552   ```rust
2553   fn main() {
2554       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2555
2556       match array {
2557           nums
2558   //      ---- `nums` is bound by move.
2559               if nums.iter().sum::<u8>() == 10
2560   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2561           => {
2562               drop(nums);
2563   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2564           }
2565           _ => unreachable!(),
2566       }
2567   }
2568   ```
2569
2570
2571
2572 Compiler
2573 --------
2574 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2575 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2576 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2577   **Note** Cargo currently doesn't use this feature. Refer to
2578   [cargo#7315][cargo/7315] to track this feature's progress.
2579 - [You can now pass `--show-output` argument to test binaries to print the
2580   output of successful tests.][62600]
2581
2582
2583 \* Refer to Rust's [platform support page][platform-support-doc] for more
2584 information on Rust's tiered platform support.
2585
2586 Libraries
2587 ---------
2588 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2589 - [`LinkedList::new` is now a `const` function.][63684]
2590 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2591 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2592   now `const`.][63786]
2593
2594 Stabilized APIs
2595 ---------------
2596 - [`Pin::into_inner`]
2597 - [`Instant::checked_duration_since`]
2598 - [`Instant::saturating_duration_since`]
2599
2600 Cargo
2601 -----
2602 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2603 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2604   `--all` is now deprecated.
2605
2606 Misc
2607 ----
2608 - [You can now pass `-Clinker` to rustdoc to control the linker used
2609   for compiling doctests.][63834]
2610
2611 Compatibility Notes
2612 -------------------
2613 - [Code that was previously accepted by the old borrow checker, but rejected by
2614   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2615   previously a warning, and will also become a hard error in the Rust 2015
2616   edition in the 1.40.0 release.
2617 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2618   run tests.][63827] This should improve performance when running a large
2619   amount of doctests.
2620 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2621   recommended to use the `?` operator instead.
2622 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2623   returned `0.0`.
2624
2625 [62600]: https://github.com/rust-lang/rust/pull/62600/
2626 [62672]: https://github.com/rust-lang/rust/pull/62672/
2627 [63118]: https://github.com/rust-lang/rust/pull/63118/
2628 [63209]: https://github.com/rust-lang/rust/pull/63209/
2629 [63402]: https://github.com/rust-lang/rust/pull/63402/
2630 [63565]: https://github.com/rust-lang/rust/pull/63565/
2631 [63595]: https://github.com/rust-lang/rust/pull/63595/
2632 [63684]: https://github.com/rust-lang/rust/pull/63684/
2633 [63698]: https://github.com/rust-lang/rust/pull/63698/
2634 [63770]: https://github.com/rust-lang/rust/pull/63770/
2635 [63786]: https://github.com/rust-lang/rust/pull/63786/
2636 [63827]: https://github.com/rust-lang/rust/pull/63827/
2637 [63834]: https://github.com/rust-lang/rust/pull/63834/
2638 [63927]: https://github.com/rust-lang/rust/pull/63927/
2639 [63933]: https://github.com/rust-lang/rust/pull/63933/
2640 [63934]: https://github.com/rust-lang/rust/pull/63934/
2641 [63938]: https://github.com/rust-lang/rust/pull/63938/
2642 [63940]: https://github.com/rust-lang/rust/pull/63940/
2643 [63941]: https://github.com/rust-lang/rust/pull/63941/
2644 [63945]: https://github.com/rust-lang/rust/pull/63945/
2645 [64010]: https://github.com/rust-lang/rust/pull/64010/
2646 [64028]: https://github.com/rust-lang/rust/pull/64028/
2647 [64334]: https://github.com/rust-lang/rust/pull/64334/
2648 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2649 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2650 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2651 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2652 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2653 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2654
2655 Version 1.38.0 (2019-09-26)
2656 ==========================
2657
2658 Language
2659 --------
2660 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2661 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2662
2663 Compiler
2664 --------
2665 - [Added pipelined compilation support to `rustc`.][62766] This will
2666   improve compilation times in some cases. For further information please refer
2667   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2668 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2669   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2670   `x86_64-uwp-windows-msvc` targets.][60260]
2671 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2672   `armv7-unknown-linux-musleabi` targets.][63107]
2673 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2674 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2675 - [Upgraded to LLVM 9.][62592]
2676
2677 \* Refer to Rust's [platform support page][platform-support-doc] for more
2678 information on Rust's tiered platform support.
2679
2680 Libraries
2681 ---------
2682 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2683 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2684   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2685   is available at `std::clone::Clone`). This also makes all built-in macros
2686   available in `std`/`core` root. e.g. `std::include_bytes!`.
2687 - [`str::Chars` now implements `Debug`.][63000]
2688 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2689 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2690 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2691 - [Added euclidean remainder and division operations (`div_euclid`,
2692   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2693   `overflowing`, and `wrapping` versions are available for all
2694   integer primitives.
2695 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2696   `PartialEq`.][61491]
2697 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2698
2699 Stabilized APIs
2700 ---------------
2701 - [`<*const T>::cast`]
2702 - [`<*mut T>::cast`]
2703 - [`Duration::as_secs_f32`]
2704 - [`Duration::as_secs_f64`]
2705 - [`Duration::div_f32`]
2706 - [`Duration::div_f64`]
2707 - [`Duration::from_secs_f32`]
2708 - [`Duration::from_secs_f64`]
2709 - [`Duration::mul_f32`]
2710 - [`Duration::mul_f64`]
2711 - [`any::type_name`]
2712
2713 Cargo
2714 -----
2715 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2716 - [You can now pass the `--features` option multiple times to enable
2717   multiple features.][cargo/7084]
2718
2719 Rustdoc
2720 -------
2721
2722 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2723
2724 Misc
2725 ----
2726 - [`rustc` will now warn about some incorrect uses of
2727   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2728
2729 Compatibility Notes
2730 -------------------
2731 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2732   1.38.0.
2733 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2734   issues][62896] with certain crates such as libc.
2735
2736 [60260]: https://github.com/rust-lang/rust/pull/60260/
2737 [61457]: https://github.com/rust-lang/rust/pull/61457/
2738 [61491]: https://github.com/rust-lang/rust/pull/61491/
2739 [61884]: https://github.com/rust-lang/rust/pull/61884/
2740 [61953]: https://github.com/rust-lang/rust/pull/61953/
2741 [62042]: https://github.com/rust-lang/rust/pull/62042/
2742 [62528]: https://github.com/rust-lang/rust/pull/62528/
2743 [62583]: https://github.com/rust-lang/rust/pull/62583/
2744 [62735]: https://github.com/rust-lang/rust/pull/62735/
2745 [62766]: https://github.com/rust-lang/rust/pull/62766/
2746 [62784]: https://github.com/rust-lang/rust/pull/62784/
2747 [62592]: https://github.com/rust-lang/rust/pull/62592/
2748 [62785]: https://github.com/rust-lang/rust/issues/62785/
2749 [62814]: https://github.com/rust-lang/rust/pull/62814/
2750 [62896]: https://github.com/rust-lang/rust/issues/62896/
2751 [63000]: https://github.com/rust-lang/rust/pull/63000/
2752 [63056]: https://github.com/rust-lang/rust/pull/63056/
2753 [63107]: https://github.com/rust-lang/rust/pull/63107/
2754 [63346]: https://github.com/rust-lang/rust/pull/63346/
2755 [63421]: https://github.com/rust-lang/rust/pull/63421/
2756 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2757 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2758 [63048]: https://github.com/rust-lang/rust/pull/63048
2759 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2760 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2761 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2762 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2763 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2764 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2765 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2766 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2767 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2768 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2769 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2770 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2771 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2772
2773 Version 1.37.0 (2019-08-15)
2774 ==========================
2775
2776 Language
2777 --------
2778 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2779   [`Box`][62228], or an [array][62235] and unused.
2780 - [You can now use the `cfg` and `cfg_attr` attributes on
2781   generic parameters.][61547]
2782 - [You can now use enum variants through type alias.][61682] e.g. You can
2783   write the following:
2784   ```rust
2785   type MyOption = Option<u8>;
2786
2787   fn increment_or_zero(x: MyOption) -> u8 {
2788       match x {
2789           MyOption::Some(y) => y + 1,
2790           MyOption::None => 0,
2791       }
2792   }
2793   ```
2794 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2795   `const _: u32 = 5;`.
2796 - [You can now use `#[repr(align(X)]` on enums.][61229]
2797 - [The  `?` Kleene macro operator is now available in the
2798   2015 edition.][60932]
2799
2800 Compiler
2801 --------
2802 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2803   and `-C profile-use` flags.][61268] For more information on how to use profile
2804   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2805 - [The `rust-lldb` wrapper script should now work again.][61827]
2806
2807 Libraries
2808 ---------
2809 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2810
2811 Stabilized APIs
2812 ---------------
2813 - [`BufReader::buffer`]
2814 - [`BufWriter::buffer`]
2815 - [`Cell::from_mut`]
2816 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2817 - [`DoubleEndedIterator::nth_back`]
2818 - [`Option::xor`]
2819 - [`Wrapping::reverse_bits`]
2820 - [`i128::reverse_bits`]
2821 - [`i16::reverse_bits`]
2822 - [`i32::reverse_bits`]
2823 - [`i64::reverse_bits`]
2824 - [`i8::reverse_bits`]
2825 - [`isize::reverse_bits`]
2826 - [`slice::copy_within`]
2827 - [`u128::reverse_bits`]
2828 - [`u16::reverse_bits`]
2829 - [`u32::reverse_bits`]
2830 - [`u64::reverse_bits`]
2831 - [`u8::reverse_bits`]
2832 - [`usize::reverse_bits`]
2833
2834 Cargo
2835 -----
2836 - [`Cargo.lock` files are now included by default when publishing executable crates
2837   with executables.][cargo/7026]
2838 - [You can now specify `default-run="foo"` in `[package]` to specify the
2839   default executable to use for `cargo run`.][cargo/7056]
2840
2841 Misc
2842 ----
2843
2844 Compatibility Notes
2845 -------------------
2846 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2847   Please transition your code to using the `..=` syntax for inclusive
2848   ranges instead.
2849 - [Using a trait object without the `dyn` will now warn by default.][61203]
2850   Please transition your code to use `dyn Trait` for trait objects instead.
2851
2852 [62228]: https://github.com/rust-lang/rust/pull/62228/
2853 [62235]: https://github.com/rust-lang/rust/pull/62235/
2854 [61802]: https://github.com/rust-lang/rust/pull/61802/
2855 [61827]: https://github.com/rust-lang/rust/pull/61827/
2856 [61547]: https://github.com/rust-lang/rust/pull/61547/
2857 [61682]: https://github.com/rust-lang/rust/pull/61682/
2858 [61268]: https://github.com/rust-lang/rust/pull/61268/
2859 [61342]: https://github.com/rust-lang/rust/pull/61342/
2860 [61347]: https://github.com/rust-lang/rust/pull/61347/
2861 [61100]: https://github.com/rust-lang/rust/pull/61100/
2862 [61203]: https://github.com/rust-lang/rust/pull/61203/
2863 [61229]: https://github.com/rust-lang/rust/pull/61229/
2864 [60932]: https://github.com/rust-lang/rust/pull/60932/
2865 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2866 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2867 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2868 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2869 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2870 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2871 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2872 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2873 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2874 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2875 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2876 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2877 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2878 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2879 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2880 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2881 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2882 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2883 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2884 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2885 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2886 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2887 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2888 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2889
2890
2891 Version 1.36.0 (2019-07-04)
2892 ==========================
2893
2894 Language
2895 --------
2896 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2897 - [The order of traits in trait objects no longer affects the semantics of that
2898   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2899   `dyn fmt::Debug + Send`, where this was previously not the case.
2900
2901 Libraries
2902 ---------
2903 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2904 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2905 - [`mem::needs_drop` is now available as a const fn.][60364]
2906 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2907 - [`String` now implements `BorrowMut<str>`.][60404]
2908 - [`io::Cursor` now implements `Default`.][60234]
2909 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2910 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2911   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2912   environment has access to heap memory allocation.
2913 - [`String` now implements `From<&String>`.][59825]
2914 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2915   return a tuple of each argument when there is multiple arguments.
2916 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2917   not used.][59648]
2918
2919 Stabilized APIs
2920 ---------------
2921 - [`VecDeque::rotate_left`]
2922 - [`VecDeque::rotate_right`]
2923 - [`Iterator::copied`]
2924 - [`io::IoSlice`]
2925 - [`io::IoSliceMut`]
2926 - [`Read::read_vectored`]
2927 - [`Write::write_vectored`]
2928 - [`str::as_mut_ptr`]
2929 - [`mem::MaybeUninit`]
2930 - [`pointer::align_offset`]
2931 - [`future::Future`]
2932 - [`task::Context`]
2933 - [`task::RawWaker`]
2934 - [`task::RawWakerVTable`]
2935 - [`task::Waker`]
2936 - [`task::Poll`]
2937
2938 Cargo
2939 -----
2940 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2941 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2942
2943 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2944
2945 Clippy
2946 ------
2947 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2948
2949 Misc
2950 ----
2951
2952 Compatibility Notes
2953 -------------------
2954 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2955   longer recommended, and will be deprecated in 1.39.0.
2956
2957 [60318]: https://github.com/rust-lang/rust/pull/60318/
2958 [60364]: https://github.com/rust-lang/rust/pull/60364/
2959 [60370]: https://github.com/rust-lang/rust/pull/60370/
2960 [60404]: https://github.com/rust-lang/rust/pull/60404/
2961 [60234]: https://github.com/rust-lang/rust/pull/60234/
2962 [60244]: https://github.com/rust-lang/rust/pull/60244/
2963 [58623]: https://github.com/rust-lang/rust/pull/58623/
2964 [59648]: https://github.com/rust-lang/rust/pull/59648/
2965 [59675]: https://github.com/rust-lang/rust/pull/59675/
2966 [59825]: https://github.com/rust-lang/rust/pull/59825/
2967 [59826]: https://github.com/rust-lang/rust/pull/59826/
2968 [59445]: https://github.com/rust-lang/rust/pull/59445/
2969 [59114]: https://github.com/rust-lang/rust/pull/59114/
2970 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2971 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2972 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2973 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2974 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2975 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2976 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2977 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2978 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2979 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2980 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2981 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2982 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2983 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2984 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2985 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2986 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2987 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2988 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2989 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2990
2991
2992 Version 1.35.0 (2019-05-23)
2993 ==========================
2994
2995 Language
2996 --------
2997 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2998   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2999 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3000   ```rust
3001   unsafe fn call_unsafe(func: unsafe fn()) {
3002       func()
3003   }
3004
3005   pub fn main() {
3006       unsafe { call_unsafe(|| {}); }
3007   }
3008   ```
3009
3010
3011 Compiler
3012 --------
3013 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3014   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3015 - [Added the `wasm32-unknown-wasi` target.][59464]
3016
3017
3018 Libraries
3019 ---------
3020 - [`Thread` will now show its ID in `Debug` output.][59460]
3021 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3022 - [`alloc::System` now implements `Default`.][59451]
3023 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3024   last field.][59076]
3025 - [`char::{ToLowercase, ToUppercase}` now
3026   implement `ExactSizeIterator`.][58778]
3027 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3028 - [Removed the `Read` trait bounds
3029   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3030 - [You can now call the `dbg!` macro without any parameters to print the file
3031   and line where it is called.][57847]
3032 - [In place ASCII case conversions are now up to 4× faster.][59283]
3033   e.g. `str::make_ascii_lowercase`
3034 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3035   and `Send`.][58369]
3036
3037 Stabilized APIs
3038 ---------------
3039 - [`f32::copysign`]
3040 - [`f64::copysign`]
3041 - [`RefCell::replace_with`]
3042 - [`RefCell::map_split`]
3043 - [`ptr::hash`]
3044 - [`Range::contains`]
3045 - [`RangeFrom::contains`]
3046 - [`RangeTo::contains`]
3047 - [`RangeInclusive::contains`]
3048 - [`RangeToInclusive::contains`]
3049 - [`Option::copied`]
3050
3051 Cargo
3052 -----
3053 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3054   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3055   platform specific.
3056
3057 Misc
3058 ----
3059 - [The Rust toolchain is now available natively for musl based distros.][58575]
3060
3061 [59460]: https://github.com/rust-lang/rust/pull/59460/
3062 [59464]: https://github.com/rust-lang/rust/pull/59464/
3063 [59500]: https://github.com/rust-lang/rust/pull/59500/
3064 [59512]: https://github.com/rust-lang/rust/pull/59512/
3065 [59580]: https://github.com/rust-lang/rust/pull/59580/
3066 [59283]: https://github.com/rust-lang/rust/pull/59283/
3067 [59451]: https://github.com/rust-lang/rust/pull/59451/
3068 [59076]: https://github.com/rust-lang/rust/pull/59076/
3069 [58778]: https://github.com/rust-lang/rust/pull/58778/
3070 [58717]: https://github.com/rust-lang/rust/pull/58717/
3071 [58369]: https://github.com/rust-lang/rust/pull/58369/
3072 [58423]: https://github.com/rust-lang/rust/pull/58423/
3073 [58080]: https://github.com/rust-lang/rust/pull/58080/
3074 [57847]: https://github.com/rust-lang/rust/pull/57847/
3075 [58575]: https://github.com/rust-lang/rust/pull/58575
3076 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3077 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3078 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3079 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3080 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3081 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3082 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3083 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3084 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3085 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3086 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3087 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3088
3089 Version 1.34.2 (2019-05-14)
3090 ===========================
3091
3092 * [Destabilize the `Error::type_id` function due to a security
3093    vulnerability][60785] ([CVE-2019-12083])
3094
3095 [60785]: https://github.com/rust-lang/rust/pull/60785
3096 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3097
3098 Version 1.34.1 (2019-04-25)
3099 ===========================
3100
3101 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3102 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3103 * [Fix Clippy panic when checking some macros][clippy/3805]
3104
3105 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3106 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3107 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3108
3109 Version 1.34.0 (2019-04-11)
3110 ==========================
3111
3112 Language
3113 --------
3114 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3115   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3116   but had no effect.
3117 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3118   `#[attr{}]` procedural macros.][57367]
3119 - [You can now write `extern crate self as foo;`][57407] to import your
3120   crate's root into the extern prelude.
3121
3122
3123 Compiler
3124 --------
3125 - [You can now target `riscv64imac-unknown-none-elf` and
3126   `riscv64gc-unknown-none-elf`.][58406]
3127 - [You can now enable linker plugin LTO optimisations with
3128   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3129   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3130   boundaries.
3131 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3132
3133
3134 Libraries
3135 ---------
3136 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3137   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3138   the `Hash` trait to create an iterator.
3139 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3140   methods.][58421] Most notably you no longer require the `Ord` trait to create
3141   an iterator.
3142 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3143   for all numeric types.][58044]
3144 - [Indexing a `str` is now generic over all types that
3145   implement `SliceIndex<str>`.][57604]
3146 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3147   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3148   produce a warning if their returning type is unused.
3149 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3150   `overflowing_pow` are now available for all numeric types.][57873] These are
3151   equivalent to methods such as `wrapping_add` for the `pow` operation.
3152
3153
3154 Stabilized APIs
3155 ---------------
3156
3157 #### std & core
3158 * [`Any::type_id`]
3159 * [`Error::type_id`]
3160 * [`atomic::AtomicI16`]
3161 * [`atomic::AtomicI32`]
3162 * [`atomic::AtomicI64`]
3163 * [`atomic::AtomicI8`]
3164 * [`atomic::AtomicU16`]
3165 * [`atomic::AtomicU32`]
3166 * [`atomic::AtomicU64`]
3167 * [`atomic::AtomicU8`]
3168 * [`convert::Infallible`]
3169 * [`convert::TryFrom`]
3170 * [`convert::TryInto`]
3171 * [`iter::from_fn`]
3172 * [`iter::successors`]
3173 * [`num::NonZeroI128`]
3174 * [`num::NonZeroI16`]
3175 * [`num::NonZeroI32`]
3176 * [`num::NonZeroI64`]
3177 * [`num::NonZeroI8`]
3178 * [`num::NonZeroIsize`]
3179 * [`slice::sort_by_cached_key`]
3180 * [`str::escape_debug`]
3181 * [`str::escape_default`]
3182 * [`str::escape_unicode`]
3183 * [`str::split_ascii_whitespace`]
3184
3185 #### std
3186 * [`Instant::checked_add`]
3187 * [`Instant::checked_sub`]
3188 * [`SystemTime::checked_add`]
3189 * [`SystemTime::checked_sub`]
3190
3191 Cargo
3192 -----
3193 - [You can now use alternative registries to crates.io.][cargo/6654]
3194
3195 Misc
3196 ----
3197 - [You can now use the `?` operator in your documentation tests without manually
3198   adding `fn main() -> Result<(), _> {}`.][56470]
3199
3200 Compatibility Notes
3201 -------------------
3202 - [`Command::before_exec` is being replaced by the unsafe method
3203   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3204 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3205   can now use `const` functions in `static` variables.
3206
3207 [58370]: https://github.com/rust-lang/rust/pull/58370/
3208 [58406]: https://github.com/rust-lang/rust/pull/58406/
3209 [58421]: https://github.com/rust-lang/rust/pull/58421/
3210 [58166]: https://github.com/rust-lang/rust/pull/58166/
3211 [58044]: https://github.com/rust-lang/rust/pull/58044/
3212 [58057]: https://github.com/rust-lang/rust/pull/58057/
3213 [58059]: https://github.com/rust-lang/rust/pull/58059/
3214 [57809]: https://github.com/rust-lang/rust/pull/57809/
3215 [57873]: https://github.com/rust-lang/rust/pull/57873/
3216 [57604]: https://github.com/rust-lang/rust/pull/57604/
3217 [57367]: https://github.com/rust-lang/rust/pull/57367/
3218 [57407]: https://github.com/rust-lang/rust/pull/57407/
3219 [57425]: https://github.com/rust-lang/rust/pull/57425/
3220 [57106]: https://github.com/rust-lang/rust/pull/57106/
3221 [56470]: https://github.com/rust-lang/rust/pull/56470/
3222 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3223 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3224 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3225 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3226 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3227 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3228 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3229 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3230 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3231 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3232 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3233 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3234 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3235 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3236 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3237 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3238 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3239 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3240 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3241 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3242 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3243 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3244 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3245 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3246 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3247 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3248 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3249 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3250 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3251 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3252 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3253
3254
3255 Version 1.33.0 (2019-02-28)
3256 ==========================
3257
3258 Language
3259 --------
3260 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3261   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3262 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3263   E.g. You can have match statement on a `u8` that covers `0..=255` and
3264   you would no longer be required to have a `_ => unreachable!()` case.
3265 - [You can now have multiple patterns in `if let` and `while let`
3266   expressions.][57532] You can do this with the same syntax as a `match`
3267   expression. E.g.
3268   ```rust
3269   enum Creature {
3270       Crab(String),
3271       Lobster(String),
3272       Person(String),
3273   }
3274
3275   fn main() {
3276       let state = Creature::Crab("Ferris");
3277
3278       if let Creature::Crab(name) | Creature::Person(name) = state {
3279           println!("This creature's name is: {}", name);
3280       }
3281   }
3282   ```
3283 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3284   this feature will by default produce a warning as this behaviour can be
3285   unintuitive. E.g. `if let _ = 5 {}`
3286 - [You can now use `let` bindings, assignments, expression statements,
3287   and irrefutable pattern destructuring in const functions.][57175]
3288 - [You can now call unsafe const functions.][57067] E.g.
3289   ```rust
3290   const unsafe fn foo() -> i32 { 5 }
3291   const fn bar() -> i32 {
3292       unsafe { foo() }
3293   }
3294   ```
3295 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3296   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3297 - [You can now specify a specific alignment with the `#[repr(packed)]`
3298   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3299   with an alignment of 2 bytes and a size of 6 bytes.
3300 - [You can now import an item from a module as an `_`.][56303] This allows you to
3301   import a trait's impls, and not have the name in the namespace. E.g.
3302   ```rust
3303   use std::io::Read as _;
3304
3305   // Allowed as there is only one `Read` in the module.
3306   pub trait Read {}
3307   ```
3308 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3309
3310 Compiler
3311 --------
3312 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3313   command line argument.][56351]
3314 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3315 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3316 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3317   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3318   information on Rust's platform support.
3319 - [Added support for the `thumbv7neon-linux-androideabi` and
3320   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3321 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3322
3323 Libraries
3324 ---------
3325 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3326   functions for all numeric types.][57566]
3327 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3328   are now `const` functions for all numeric types.][57105]
3329 - [The methods `is_positive` and `is_negative` are now `const` functions for
3330   all signed numeric types.][57105]
3331 - [The `get` method for all `NonZero` types is now `const`.][57167]
3332 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3333   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3334   numeric types.][57234]
3335 - [`Ipv4Addr::new` is now a `const` function][57234]
3336
3337 Stabilized APIs
3338 ---------------
3339 - [`unix::FileExt::read_exact_at`]
3340 - [`unix::FileExt::write_all_at`]
3341 - [`Option::transpose`]
3342 - [`Result::transpose`]
3343 - [`convert::identity`]
3344 - [`pin::Pin`]
3345 - [`marker::Unpin`]
3346 - [`marker::PhantomPinned`]
3347 - [`Vec::resize_with`]
3348 - [`VecDeque::resize_with`]
3349 - [`Duration::as_millis`]
3350 - [`Duration::as_micros`]
3351 - [`Duration::as_nanos`]
3352
3353
3354 Cargo
3355 -----
3356 - [You can now publish crates that require a feature flag to compile with
3357   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3358 - [Cargo should now rebuild a crate if a file was modified during the initial
3359   build.][cargo/6484]
3360
3361 Compatibility Notes
3362 -------------------
3363 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3364   are now deprecated in the standard library, and their usage will now produce a warning.
3365   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3366   methods instead.
3367 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3368   downcasting.
3369 - [Libtest no longer creates a new thread for each test when
3370   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3371
3372 [55982]: https://github.com/rust-lang/rust/pull/55982/
3373 [56243]: https://github.com/rust-lang/rust/pull/56243
3374 [56303]: https://github.com/rust-lang/rust/pull/56303/
3375 [56351]: https://github.com/rust-lang/rust/pull/56351/
3376 [56362]: https://github.com/rust-lang/rust/pull/56362
3377 [56642]: https://github.com/rust-lang/rust/pull/56642/
3378 [56769]: https://github.com/rust-lang/rust/pull/56769/
3379 [56805]: https://github.com/rust-lang/rust/pull/56805
3380 [56947]: https://github.com/rust-lang/rust/pull/56947/
3381 [57049]: https://github.com/rust-lang/rust/pull/57049/
3382 [57067]: https://github.com/rust-lang/rust/pull/57067/
3383 [57105]: https://github.com/rust-lang/rust/pull/57105
3384 [57130]: https://github.com/rust-lang/rust/pull/57130/
3385 [57167]: https://github.com/rust-lang/rust/pull/57167/
3386 [57175]: https://github.com/rust-lang/rust/pull/57175/
3387 [57234]: https://github.com/rust-lang/rust/pull/57234/
3388 [57332]: https://github.com/rust-lang/rust/pull/57332/
3389 [57465]: https://github.com/rust-lang/rust/pull/57465/
3390 [57532]: https://github.com/rust-lang/rust/pull/57532/
3391 [57535]: https://github.com/rust-lang/rust/pull/57535/
3392 [57566]: https://github.com/rust-lang/rust/pull/57566/
3393 [57615]: https://github.com/rust-lang/rust/pull/57615/
3394 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3395 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3396 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3397 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3398 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3399 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3400 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3401 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3402 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3403 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3404 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3405 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3406 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3407 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3408 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3409 [platform-support]: https://forge.rust-lang.org/platform-support.html
3410
3411 Version 1.32.0 (2019-01-17)
3412 ==========================
3413
3414 Language
3415 --------
3416 #### 2018 edition
3417 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3418   operator allows you to specify zero or one repetitions similar to the `*` and
3419   `+` operators.
3420 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3421   now always resolve to the item (`enum`, `struct`, etc.) available in the
3422   module if present, before resolving to a external crate or an item the prelude.][56759]
3423   E.g.
3424   ```rust
3425   enum Color { Red, Green, Blue }
3426
3427   use Color::*;
3428   ```
3429
3430 #### All editions
3431 - [You can now match against `PhantomData<T>` types.][55837]
3432 - [You can now match against literals in macros with the `literal`
3433   specifier.][56072] This will match against a literal of any type.
3434   E.g. `1`, `'A'`, `"Hello World"`
3435 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3436   ```rust
3437   struct Point(i32, i32);
3438
3439   impl Point {
3440       pub fn new(x: i32, y: i32) -> Self {
3441           Self(x, y)
3442       }
3443
3444       pub fn is_origin(&self) -> bool {
3445           match self {
3446               Self(0, 0) => true,
3447               _ => false,
3448           }
3449       }
3450   }
3451   ```
3452 - [Self can also now be used in type definitions.][56366] E.g.
3453   ```rust
3454   enum List<T>
3455   where
3456       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3457   {
3458       Nil,
3459       Cons(T, Box<Self>) // likewise here
3460   }
3461   ```
3462 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3463   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3464
3465 Compiler
3466 --------
3467 - [The default allocator has changed from jemalloc to the default allocator on
3468   your system.][55238] The compiler itself on Linux & macOS will still use
3469   jemalloc, but programs compiled with it will use the system allocator.
3470 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3471
3472 Libraries
3473 ---------
3474 - [`PathBuf` now implements `FromStr`.][55148]
3475 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3476 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3477   easily debug expressions in your rust program. E.g.
3478   ```rust
3479   let a = 2;
3480   let b = dbg!(a * 2) + 1;
3481   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3482   assert_eq!(b, 5);
3483   ```
3484
3485 The following APIs are now `const` functions and can be used in a
3486 `const` context.
3487
3488 - [`Cell::as_ptr`]
3489 - [`UnsafeCell::get`]
3490 - [`char::is_ascii`]
3491 - [`iter::empty`]
3492 - [`ManuallyDrop::new`]
3493 - [`ManuallyDrop::into_inner`]
3494 - [`RangeInclusive::start`]
3495 - [`RangeInclusive::end`]
3496 - [`NonNull::as_ptr`]
3497 - [`slice::as_ptr`]
3498 - [`str::as_ptr`]
3499 - [`Duration::as_secs`]
3500 - [`Duration::subsec_millis`]
3501 - [`Duration::subsec_micros`]
3502 - [`Duration::subsec_nanos`]
3503 - [`CStr::as_ptr`]
3504 - [`Ipv4Addr::is_unspecified`]
3505 - [`Ipv6Addr::new`]
3506 - [`Ipv6Addr::octets`]
3507
3508 Stabilized APIs
3509 ---------------
3510 - [`i8::to_be_bytes`]
3511 - [`i8::to_le_bytes`]
3512 - [`i8::to_ne_bytes`]
3513 - [`i8::from_be_bytes`]
3514 - [`i8::from_le_bytes`]
3515 - [`i8::from_ne_bytes`]
3516 - [`i16::to_be_bytes`]
3517 - [`i16::to_le_bytes`]
3518 - [`i16::to_ne_bytes`]
3519 - [`i16::from_be_bytes`]
3520 - [`i16::from_le_bytes`]
3521 - [`i16::from_ne_bytes`]
3522 - [`i32::to_be_bytes`]
3523 - [`i32::to_le_bytes`]
3524 - [`i32::to_ne_bytes`]
3525 - [`i32::from_be_bytes`]
3526 - [`i32::from_le_bytes`]
3527 - [`i32::from_ne_bytes`]
3528 - [`i64::to_be_bytes`]
3529 - [`i64::to_le_bytes`]
3530 - [`i64::to_ne_bytes`]
3531 - [`i64::from_be_bytes`]
3532 - [`i64::from_le_bytes`]
3533 - [`i64::from_ne_bytes`]
3534 - [`i128::to_be_bytes`]
3535 - [`i128::to_le_bytes`]
3536 - [`i128::to_ne_bytes`]
3537 - [`i128::from_be_bytes`]
3538 - [`i128::from_le_bytes`]
3539 - [`i128::from_ne_bytes`]
3540 - [`isize::to_be_bytes`]
3541 - [`isize::to_le_bytes`]
3542 - [`isize::to_ne_bytes`]
3543 - [`isize::from_be_bytes`]
3544 - [`isize::from_le_bytes`]
3545 - [`isize::from_ne_bytes`]
3546 - [`u8::to_be_bytes`]
3547 - [`u8::to_le_bytes`]
3548 - [`u8::to_ne_bytes`]
3549 - [`u8::from_be_bytes`]
3550 - [`u8::from_le_bytes`]
3551 - [`u8::from_ne_bytes`]
3552 - [`u16::to_be_bytes`]
3553 - [`u16::to_le_bytes`]
3554 - [`u16::to_ne_bytes`]
3555 - [`u16::from_be_bytes`]
3556 - [`u16::from_le_bytes`]
3557 - [`u16::from_ne_bytes`]
3558 - [`u32::to_be_bytes`]
3559 - [`u32::to_le_bytes`]
3560 - [`u32::to_ne_bytes`]
3561 - [`u32::from_be_bytes`]
3562 - [`u32::from_le_bytes`]
3563 - [`u32::from_ne_bytes`]
3564 - [`u64::to_be_bytes`]
3565 - [`u64::to_le_bytes`]
3566 - [`u64::to_ne_bytes`]
3567 - [`u64::from_be_bytes`]
3568 - [`u64::from_le_bytes`]
3569 - [`u64::from_ne_bytes`]
3570 - [`u128::to_be_bytes`]
3571 - [`u128::to_le_bytes`]
3572 - [`u128::to_ne_bytes`]
3573 - [`u128::from_be_bytes`]
3574 - [`u128::from_le_bytes`]
3575 - [`u128::from_ne_bytes`]
3576 - [`usize::to_be_bytes`]
3577 - [`usize::to_le_bytes`]
3578 - [`usize::to_ne_bytes`]
3579 - [`usize::from_be_bytes`]
3580 - [`usize::from_le_bytes`]
3581 - [`usize::from_ne_bytes`]
3582
3583 Cargo
3584 -----
3585 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3586 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3587
3588 Misc
3589 ----
3590 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3591
3592 Compatibility Notes
3593 -------------------
3594 - [The argument types for AVX's
3595   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3596   been changed from `*const` to `*mut` as the previous implementation
3597   was unsound.
3598
3599
3600 [55148]: https://github.com/rust-lang/rust/pull/55148/
3601 [55238]: https://github.com/rust-lang/rust/pull/55238/
3602 [55280]: https://github.com/rust-lang/rust/pull/55280/
3603 [55610]: https://github.com/rust-lang/rust/pull/55610/
3604 [55663]: https://github.com/rust-lang/rust/pull/55663/
3605 [55702]: https://github.com/rust-lang/rust/pull/55702/
3606 [55837]: https://github.com/rust-lang/rust/pull/55837/
3607 [55843]: https://github.com/rust-lang/rust/pull/55843/
3608 [56072]: https://github.com/rust-lang/rust/pull/56072/
3609 [56245]: https://github.com/rust-lang/rust/pull/56245/
3610 [56365]: https://github.com/rust-lang/rust/pull/56365/
3611 [56366]: https://github.com/rust-lang/rust/pull/56366/
3612 [56395]: https://github.com/rust-lang/rust/pull/56395/
3613 [56759]: https://github.com/rust-lang/rust/pull/56759/
3614 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3615 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3616 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3617 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3618 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3619 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3620 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3621 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3622 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3623 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3624 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3625 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3626 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3627 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3628 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3629 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3630 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3631 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3632 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3633 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3634 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3635 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3636 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3637 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3638 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3639 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3640 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3641 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3642 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3643 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3644 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3645 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3646 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3647 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3648 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3649 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3650 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3651 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3652 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3653 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3654 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3655 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3656 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3657 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3658 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3659 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3660 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3661 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3662 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3663 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3664 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3665 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3666 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3667 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3668 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3669 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3670 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3671 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3672 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3673 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3674 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3675 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3676 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3677 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3678 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3679 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3680 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3681 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3682 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3683 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3684 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3685 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3686 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3687 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3688 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3689 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3690 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3691 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3692 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3693 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3694 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3695 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3696 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3697 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3698 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3699 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3700 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3701 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3702 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3703 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3704 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3705 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3706 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3707
3708
3709 Version 1.31.1 (2018-12-20)
3710 ===========================
3711
3712 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3713 - [Fix broken go-to-definition in RLS][rls/1171]
3714 - [Fix infinite loop on hover in RLS][rls/1170]
3715
3716 [56562]: https://github.com/rust-lang/rust/pull/56562
3717 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3718 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3719
3720 Version 1.31.0 (2018-12-06)
3721 ==========================
3722
3723 Language
3724 --------
3725 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3726 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3727   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3728   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3729   in structs.
3730 - [You can now define and use `const` functions.][54835] These are currently
3731   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3732   [language reference][const-reference] for what exactly is available.
3733 - [You can now use tool lints, which allow you to scope lints from external
3734   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3735 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3736   a crate, not just in exported functions.][54451]
3737 - [You can now use parentheses in pattern matches.][54497]
3738
3739 Compiler
3740 --------
3741 - [Updated musl to 1.1.20][54430]
3742
3743 Libraries
3744 ---------
3745 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3746   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3747 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3748   into `Option<&mut T>` using the `From` trait.][53218]
3749 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3750
3751
3752 Stabilized APIs
3753 ---------------
3754 - [`slice::align_to`]
3755 - [`slice::align_to_mut`]
3756 - [`slice::chunks_exact`]
3757 - [`slice::chunks_exact_mut`]
3758 - [`slice::rchunks`]
3759 - [`slice::rchunks_mut`]
3760 - [`slice::rchunks_exact`]
3761 - [`slice::rchunks_exact_mut`]
3762 - [`Option::replace`]
3763
3764 Cargo
3765 -----
3766 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3767 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3768   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3769
3770 [52813]: https://github.com/rust-lang/rust/pull/52813/
3771 [53218]: https://github.com/rust-lang/rust/pull/53218/
3772 [53555]: https://github.com/rust-lang/rust/issues/53555/
3773 [54057]: https://github.com/rust-lang/rust/pull/54057/
3774 [54240]: https://github.com/rust-lang/rust/pull/54240/
3775 [54430]: https://github.com/rust-lang/rust/pull/54430/
3776 [54451]: https://github.com/rust-lang/rust/pull/54451/
3777 [54497]: https://github.com/rust-lang/rust/pull/54497/
3778 [54778]: https://github.com/rust-lang/rust/pull/54778/
3779 [54835]: https://github.com/rust-lang/rust/pull/54835/
3780 [54870]: https://github.com/rust-lang/rust/pull/54870/
3781 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3782 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3783 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3784 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3785 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3786 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3787 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3788 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3789 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3790 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3791 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3792 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3793 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3794 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3795
3796 Version 1.30.1 (2018-11-08)
3797 ===========================
3798
3799 - [Fixed overflow ICE in rustdoc][54199]
3800 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3801
3802 [54199]: https://github.com/rust-lang/rust/pull/54199
3803 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3804
3805 Version 1.30.0 (2018-10-25)
3806 ==========================
3807
3808 Language
3809 --------
3810 - [Procedural macros are now available.][52081] These kinds of macros allow for
3811   more powerful code generation. There is a [new chapter available][proc-macros]
3812   in the Rust Programming Language book that goes further in depth.
3813 - [You can now use keywords as identifiers using the raw identifiers
3814   syntax (`r#`),][53236] e.g. `let r#for = true;`
3815 - [Using anonymous parameters in traits is now deprecated with a warning and
3816   will be a hard error in the 2018 edition.][53272]
3817 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3818   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3819 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3820   Previously, using a external crate in a module without a use statement
3821   required `let json = ::serde_json::from_str(foo);` but can now be written
3822   as `let json = serde_json::from_str(foo);`.
3823 - [You can now apply the `#[used]` attribute to static items to prevent the
3824   compiler from optimising them away, even if they appear to be unused,][51363]
3825   e.g. `#[used] static FOO: u32 = 1;`
3826 - [You can now import and reexport macros from other crates with the `use`
3827   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3828   the root module of the crate. If your macro relies on calling other local
3829   macros, it is recommended to export with the
3830   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3831   those macros.
3832 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3833   using the `vis` specifier.][53370]
3834 - [Non-macro attributes now allow all forms of literals, not just
3835   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3836   write `#[attr(true)]`.
3837 - [You can now specify a function to handle a panic in the Rust runtime with the
3838   `#[panic_handler]` attribute.][51366]
3839
3840 Compiler
3841 --------
3842 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3843 - [Added the `aarch64-unknown-netbsd` target][53165]
3844 - [Upgraded to LLVM 8.][53611]
3845
3846 Libraries
3847 ---------
3848 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3849
3850 Stabilized APIs
3851 ---------------
3852 - [`Ipv4Addr::BROADCAST`]
3853 - [`Ipv4Addr::LOCALHOST`]
3854 - [`Ipv4Addr::UNSPECIFIED`]
3855 - [`Ipv6Addr::LOCALHOST`]
3856 - [`Ipv6Addr::UNSPECIFIED`]
3857 - [`Iterator::find_map`]
3858
3859   The following methods are replacement methods for `trim_left`, `trim_right`,
3860   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3861   in 1.33.0:
3862 - [`str::trim_end_matches`]
3863 - [`str::trim_end`]
3864 - [`str::trim_start_matches`]
3865 - [`str::trim_start`]
3866
3867 Cargo
3868 ----
3869 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3870 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3871   equivalent to calling `rustdoc --error-format=json`.
3872 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3873
3874 Misc
3875 ----
3876 - [`rustdoc` allows you to specify what edition to treat your code as with the
3877   `--edition` option.][54057]
3878 - [`rustdoc` now has the `--color` (specify whether to output color) and
3879   `--error-format` (specify error format, e.g. `json`) options.][53003]
3880 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3881   debug symbols.][53774]
3882 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3883   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3884
3885 [50911]: https://github.com/rust-lang/rust/pull/50911/
3886 [51363]: https://github.com/rust-lang/rust/pull/51363/
3887 [51366]: https://github.com/rust-lang/rust/pull/51366/
3888 [52081]: https://github.com/rust-lang/rust/pull/52081/
3889 [53003]: https://github.com/rust-lang/rust/pull/53003/
3890 [53033]: https://github.com/rust-lang/rust/pull/53033/
3891 [53044]: https://github.com/rust-lang/rust/pull/53044/
3892 [53165]: https://github.com/rust-lang/rust/pull/53165/
3893 [53611]: https://github.com/rust-lang/rust/pull/53611/
3894 [53213]: https://github.com/rust-lang/rust/pull/53213/
3895 [53236]: https://github.com/rust-lang/rust/pull/53236/
3896 [53272]: https://github.com/rust-lang/rust/pull/53272/
3897 [53370]: https://github.com/rust-lang/rust/pull/53370/
3898 [53459]: https://github.com/rust-lang/rust/pull/53459/
3899 [53774]: https://github.com/rust-lang/rust/pull/53774/
3900 [53822]: https://github.com/rust-lang/rust/pull/53822/
3901 [54057]: https://github.com/rust-lang/rust/pull/54057/
3902 [54146]: https://github.com/rust-lang/rust/pull/54146/
3903 [54404]: https://github.com/rust-lang/rust/pull/54404/
3904 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3905 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3906 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3907 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3908
3909 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3910 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3911 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3912 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3913 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3914 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3915 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3916 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3917 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3918 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3919
3920
3921 Version 1.29.2 (2018-10-11)
3922 ===========================
3923
3924 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3925 - The `rls-preview` component on the windows-gnu targets has been restored.
3926
3927 [54639]: https://github.com/rust-lang/rust/pull/54639
3928
3929
3930 Version 1.29.1 (2018-09-25)
3931 ===========================
3932
3933 Security Notes
3934 --------------
3935
3936 - The standard library's `str::repeat` function contained an out of bounds write
3937   caused by an integer overflow. This has been fixed by deterministically
3938   panicking when an overflow happens.
3939
3940   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3941   us.
3942
3943
3944 Version 1.29.0 (2018-09-13)
3945 ==========================
3946
3947 Compiler
3948 --------
3949 - [Bumped minimum LLVM version to 5.0.][51899]
3950 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3951 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3952 - [Upgraded to LLVM 7.][51966]
3953
3954 Libraries
3955 ---------
3956 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3957 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3958 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3959 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3960   for `&str`.][51178]
3961 - [`Cell<T>` now allows `T` to be unsized.][50494]
3962 - [`SocketAddr` is now stable on Redox.][52656]
3963
3964 Stabilized APIs
3965 ---------------
3966 - [`Arc::downcast`]
3967 - [`Iterator::flatten`]
3968 - [`Rc::downcast`]
3969
3970 Cargo
3971 -----
3972 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3973   `--locked` to disable this behavior.
3974 - [`cargo-install` will now allow you to cross compile an install
3975   using `--target`.][cargo/5614]
3976 - [Added the `cargo-fix` subcommand to automatically move project code from
3977   2015 edition to 2018.][cargo/5723]
3978 - [`cargo doc` can now optionally document private types using the
3979   `--document-private-items` flag.][cargo/5543]
3980
3981 Misc
3982 ----
3983 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3984   the specified level to that level.][52354] For example `--cap-lints warn`
3985   will demote `deny` and `forbid` lints to `warn`.
3986 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3987   fails and `101` if there is a panic.][52197]
3988 - [A preview of clippy has been made available through rustup.][51122]
3989   You can install the preview with `rustup component add clippy-preview`.
3990
3991 Compatibility Notes
3992 -------------------
3993 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3994   Use `str::get_unchecked(begin..end)` instead.
3995 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3996   Consider using the `home_dir` function from
3997   https://crates.io/crates/dirs instead.
3998 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3999 - [`cfg` attributes and `--cfg` command line flags are now more
4000   strictly validated.][53893]
4001
4002 [53893]: https://github.com/rust-lang/rust/pull/53893/
4003 [52861]: https://github.com/rust-lang/rust/pull/52861/
4004 [51966]: https://github.com/rust-lang/rust/pull/51966/
4005 [52656]: https://github.com/rust-lang/rust/pull/52656/
4006 [52239]: https://github.com/rust-lang/rust/pull/52239/
4007 [52330]: https://github.com/rust-lang/rust/pull/52330/
4008 [52354]: https://github.com/rust-lang/rust/pull/52354/
4009 [52402]: https://github.com/rust-lang/rust/pull/52402/
4010 [52103]: https://github.com/rust-lang/rust/pull/52103/
4011 [52197]: https://github.com/rust-lang/rust/pull/52197/
4012 [51807]: https://github.com/rust-lang/rust/pull/51807/
4013 [51899]: https://github.com/rust-lang/rust/pull/51899/
4014 [51912]: https://github.com/rust-lang/rust/pull/51912/
4015 [51511]: https://github.com/rust-lang/rust/pull/51511/
4016 [51619]: https://github.com/rust-lang/rust/pull/51619/
4017 [51656]: https://github.com/rust-lang/rust/pull/51656/
4018 [51178]: https://github.com/rust-lang/rust/pull/51178/
4019 [51122]: https://github.com/rust-lang/rust/pull/51122
4020 [50494]: https://github.com/rust-lang/rust/pull/50494/
4021 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4022 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4023 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4024 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4025 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4026 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4027 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4028
4029
4030 Version 1.28.0 (2018-08-02)
4031 ===========================
4032
4033 Language
4034 --------
4035 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4036   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4037   the inner type across Foreign Function Interface (FFI) boundaries.
4038 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4039   and can now be used as identifiers.][51196]
4040 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4041   stable.][51241] This will allow users to specify a global allocator for
4042   their program.
4043 - [Unit test functions marked with the `#[test]` attribute can now return
4044   `Result<(), E: Debug>` in addition to `()`.][51298]
4045 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4046   allows macros to easily target lifetimes.
4047
4048 Compiler
4049 --------
4050 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4051   prioritise making smaller binary sizes. `z` is the same as `s` with the
4052   exception that it does not vectorise loops, which typically results in an even
4053   smaller binary.
4054 - [The short error format is now stable.][49546] Specified with
4055   `--error-format=short` this option will provide a more compressed output of
4056   rust error messages.
4057 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4058 - [Reduced the number of allocations in the macro parser.][50855] This can
4059   improve compile times of macro heavy crates on average by 5%.
4060
4061 Libraries
4062 ---------
4063 - [Implemented `Default` for `&mut str`.][51306]
4064 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4065 - [Implemented `Extend` for `()`.][50234]
4066 - [The `Debug` implementation of `time::Duration` should now be more easily
4067   human readable.][50364] Previously a `Duration` of one second would printed as
4068   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4069 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4070   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4071   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4072   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4073   for `PathBuf`.][50170]
4074 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4075   and `Wrapping<i128>`.][50465]
4076 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4077   possible.][51050] This can provide up to a 40% speed increase.
4078 - [Improved error messages when using `format!`.][50610]
4079
4080 Stabilized APIs
4081 ---------------
4082 - [`Iterator::step_by`]
4083 - [`Path::ancestors`]
4084 - [`SystemTime::UNIX_EPOCH`]
4085 - [`alloc::GlobalAlloc`]
4086 - [`alloc::Layout`]
4087 - [`alloc::LayoutErr`]
4088 - [`alloc::System`]
4089 - [`alloc::alloc`]
4090 - [`alloc::alloc_zeroed`]
4091 - [`alloc::dealloc`]
4092 - [`alloc::realloc`]
4093 - [`alloc::handle_alloc_error`]
4094 - [`btree_map::Entry::or_default`]
4095 - [`fmt::Alignment`]
4096 - [`hash_map::Entry::or_default`]
4097 - [`iter::repeat_with`]
4098 - [`num::NonZeroUsize`]
4099 - [`num::NonZeroU128`]
4100 - [`num::NonZeroU16`]
4101 - [`num::NonZeroU32`]
4102 - [`num::NonZeroU64`]
4103 - [`num::NonZeroU8`]
4104 - [`ops::RangeBounds`]
4105 - [`slice::SliceIndex`]
4106 - [`slice::from_mut`]
4107 - [`slice::from_ref`]
4108 - [`{Any + Send + Sync}::downcast_mut`]
4109 - [`{Any + Send + Sync}::downcast_ref`]
4110 - [`{Any + Send + Sync}::is`]
4111
4112 Cargo
4113 -----
4114 - [Cargo will now no longer allow you to publish crates with build scripts that
4115   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4116   considered to be immutable.
4117
4118 Misc
4119 ----
4120 - [The `suggestion_applicability` field in `rustc`'s json output is now
4121   stable.][50486] This will allow dev tools to check whether a code suggestion
4122   would apply to them.
4123
4124 Compatibility Notes
4125 -------------------
4126 - [Rust will consider trait objects with duplicated constraints to be the same
4127   type as without the duplicated constraint.][51276] For example the below code will
4128   now fail to compile.
4129   ```rust
4130   trait Trait {}
4131
4132   impl Trait + Send {
4133       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4134   }
4135
4136   impl Trait + Send + Send {
4137       fn test(&self) { println!("two"); }
4138   }
4139   ```
4140
4141 [49546]: https://github.com/rust-lang/rust/pull/49546/
4142 [50143]: https://github.com/rust-lang/rust/pull/50143/
4143 [50170]: https://github.com/rust-lang/rust/pull/50170/
4144 [50234]: https://github.com/rust-lang/rust/pull/50234/
4145 [50265]: https://github.com/rust-lang/rust/pull/50265/
4146 [50364]: https://github.com/rust-lang/rust/pull/50364/
4147 [50385]: https://github.com/rust-lang/rust/pull/50385/
4148 [50465]: https://github.com/rust-lang/rust/pull/50465/
4149 [50486]: https://github.com/rust-lang/rust/pull/50486/
4150 [50554]: https://github.com/rust-lang/rust/pull/50554/
4151 [50610]: https://github.com/rust-lang/rust/pull/50610/
4152 [50855]: https://github.com/rust-lang/rust/pull/50855/
4153 [51050]: https://github.com/rust-lang/rust/pull/51050/
4154 [51196]: https://github.com/rust-lang/rust/pull/51196/
4155 [51200]: https://github.com/rust-lang/rust/pull/51200/
4156 [51241]: https://github.com/rust-lang/rust/pull/51241/
4157 [51276]: https://github.com/rust-lang/rust/pull/51276/
4158 [51298]: https://github.com/rust-lang/rust/pull/51298/
4159 [51306]: https://github.com/rust-lang/rust/pull/51306/
4160 [51562]: https://github.com/rust-lang/rust/pull/51562/
4161 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4162 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4163 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4164 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4165 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4166 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4167 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4168 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4169 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4170 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4171 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4172 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4173 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4174 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4175 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4176 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4177 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4178 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4179 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4180 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4181 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4182 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4183 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4184 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4185 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4186 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4187 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4188 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4189 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4190 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4191
4192 Version 1.27.2 (2018-07-20)
4193 ===========================
4194
4195 Compatibility Notes
4196 -------------------
4197
4198 - The borrow checker was fixed to avoid potential unsoundness when using
4199   match ergonomics: [#52213][52213].
4200
4201 [52213]: https://github.com/rust-lang/rust/issues/52213
4202
4203 Version 1.27.1 (2018-07-10)
4204 ===========================
4205
4206 Security Notes
4207 --------------
4208
4209 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4210   when running, which enabled executing code as some other user on a
4211   given machine. This release fixes that vulnerability; you can read
4212   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4213
4214   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4215
4216 Compatibility Notes
4217 -------------------
4218
4219 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4220   match ergonomics: [#51415][51415], [#49534][49534].
4221
4222 [51415]: https://github.com/rust-lang/rust/issues/51415
4223 [49534]: https://github.com/rust-lang/rust/issues/49534
4224 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4225 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4226
4227 Version 1.27.0 (2018-06-21)
4228 ==========================
4229
4230 Language
4231 --------
4232 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4233   be used as an identifier.
4234 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4235   bare `Trait` syntax, and should make it clearer when being used in tandem with
4236   `impl Trait` because it is equivalent to the following syntax:
4237   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4238   `Box<Trait> == Box<dyn Trait>`.
4239 - [Attributes on generic parameters such as types and lifetimes are
4240   now stable.][48851] e.g.
4241   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4242 - [The `#[must_use]` attribute can now also be used on functions as well as
4243   types.][48925] It provides a lint that by default warns users when the
4244   value returned by a function has not been used.
4245
4246 Compiler
4247 --------
4248 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4249
4250 Libraries
4251 ---------
4252 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4253   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4254   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4255   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4256   the `cfg` attribute.
4257 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4258   std are now available in core.][49896]
4259 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4260   to `Self`.][49630]
4261 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4262   that the operation isn't done in place.
4263 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4264   the `#[must_use]` attribute][49533] to warn about unused potentially
4265   expensive allocations.
4266
4267 Stabilized APIs
4268 ---------------
4269 - [`DoubleEndedIterator::rfind`]
4270 - [`DoubleEndedIterator::rfold`]
4271 - [`DoubleEndedIterator::try_rfold`]
4272 - [`Duration::from_micros`]
4273 - [`Duration::from_nanos`]
4274 - [`Duration::subsec_micros`]
4275 - [`Duration::subsec_millis`]
4276 - [`HashMap::remove_entry`]
4277 - [`Iterator::try_fold`]
4278 - [`Iterator::try_for_each`]
4279 - [`NonNull::cast`]
4280 - [`Option::filter`]
4281 - [`String::replace_range`]
4282 - [`Take::set_limit`]
4283 - [`hint::unreachable_unchecked`]
4284 - [`os::unix::process::parent_id`]
4285 - [`ptr::swap_nonoverlapping`]
4286 - [`slice::rsplit_mut`]
4287 - [`slice::rsplit`]
4288 - [`slice::swap_with_slice`]
4289
4290 Cargo
4291 -----
4292 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4293   `readme`, and `repository` fields.][cargo/5386]
4294 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4295 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4296   a different directory than `target` for placing compilation artifacts.
4297 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4298   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4299   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4300   where cargo would infer a binary, Cargo will produce a warning. You can
4301   disable this feature ahead of time by setting any of the following to false:
4302   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4303 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4304   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4305
4306 Misc
4307 ----
4308 - [Added “The Rustc book” into the official documentation.][49707]
4309   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4310 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4311
4312 Compatibility Notes
4313 -------------------
4314 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4315   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4316   compile, `"".is_empty()` will still compile.
4317 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4318   will only print the inner type.][48553] E.g.
4319   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4320   not `AtomicBool(true)`.
4321 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4322   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4323   alignment should cover all use cases.
4324 - The `.description()` method on the `std::error::Error` trait
4325   [has been soft-deprecated][50163]. It is no longer required to implement it.
4326
4327 [48553]: https://github.com/rust-lang/rust/pull/48553/
4328 [48851]: https://github.com/rust-lang/rust/pull/48851/
4329 [48925]: https://github.com/rust-lang/rust/pull/48925/
4330 [49533]: https://github.com/rust-lang/rust/pull/49533/
4331 [49623]: https://github.com/rust-lang/rust/pull/49623/
4332 [49630]: https://github.com/rust-lang/rust/pull/49630/
4333 [49664]: https://github.com/rust-lang/rust/pull/49664/
4334 [49699]: https://github.com/rust-lang/rust/pull/49699/
4335 [49707]: https://github.com/rust-lang/rust/pull/49707/
4336 [49719]: https://github.com/rust-lang/rust/pull/49719/
4337 [49896]: https://github.com/rust-lang/rust/pull/49896/
4338 [49968]: https://github.com/rust-lang/rust/pull/49968/
4339 [50163]: https://github.com/rust-lang/rust/pull/50163
4340 [50177]: https://github.com/rust-lang/rust/pull/50177/
4341 [50378]: https://github.com/rust-lang/rust/pull/50378/
4342 [50398]: https://github.com/rust-lang/rust/pull/50398/
4343 [50423]: https://github.com/rust-lang/rust/pull/50423/
4344 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4345 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4346 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4347 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4348 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4349 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4350 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4351 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4352 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4353 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4354 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4355 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4356 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4357 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4358 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4359 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4360 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4361 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4362 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4363 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4364 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4365 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4366 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4367 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4368 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4369 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4370 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4371 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4372 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4373 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4374
4375
4376 Version 1.26.2 (2018-06-05)
4377 ==========================
4378
4379 Compatibility Notes
4380 -------------------
4381
4382 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4383
4384 [51117]: https://github.com/rust-lang/rust/issues/51117
4385
4386
4387 Version 1.26.1 (2018-05-29)
4388 ==========================
4389
4390 Tools
4391 -----
4392
4393 - [RLS now works on Windows.][50646]
4394 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4395
4396
4397 Compatibility Notes
4398 --------
4399
4400 - [`fn main() -> impl Trait` no longer works for non-Termination
4401   trait.][50656]
4402   This reverts an accidental stabilization.
4403 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4404 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4405
4406 [50646]: https://github.com/rust-lang/rust/issues/50646
4407 [50656]: https://github.com/rust-lang/rust/pull/50656
4408 [50812]: https://github.com/rust-lang/rust/pull/50812
4409 [50950]: https://github.com/rust-lang/rust/issues/50950
4410 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4411
4412 Version 1.26.0 (2018-05-10)
4413 ==========================
4414
4415 Language
4416 --------
4417 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4418   implement either or both traits.][49299]
4419 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4420 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4421   lifetime can be elided.][49458]
4422 - [`impl Trait` is now stable allowing you to have abstract types in returns
4423    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4424   `fn open(path: impl AsRef<Path>)`.
4425 - [Pattern matching will now automatically apply dereferences.][49394]
4426 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4427 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4428 - [A lot of operations are now available in a const context.][46882] E.g. You
4429   can now index into constant arrays, reference and dereference into constants,
4430   and use tuple struct constructors.
4431 - [Fixed entry slice patterns are now stable.][48516] E.g.
4432   ```rust
4433   let points = [1, 2, 3, 4];
4434   match points {
4435       [1, 2, 3, 4] => println!("All points were sequential."),
4436       _ => println!("Not all points were sequential."),
4437   }
4438   ```
4439
4440
4441 Compiler
4442 --------
4443 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4444 - [Fixed exponential projection complexity on nested types.][48296]
4445   This can provide up to a ~12% reduction in compile times for certain crates.
4446 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4447   to remap path prefixes outputted by the compiler.
4448 - [Added `powerpc-unknown-netbsd` target.][48281]
4449
4450 Libraries
4451 ---------
4452 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4453 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4454   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4455 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4456 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4457 - [`ascii::escape_default` is now available in libcore.][48735]
4458 - [Trailing commas are now supported in std and core macros.][48056]
4459 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4460 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4461
4462 Stabilized APIs
4463 ---------------
4464 - [`*const T::add`]
4465 - [`*const T::copy_to_nonoverlapping`]
4466 - [`*const T::copy_to`]
4467 - [`*const T::read_unaligned`]
4468 - [`*const T::read_volatile`]
4469 - [`*const T::read`]
4470 - [`*const T::sub`]
4471 - [`*const T::wrapping_add`]
4472 - [`*const T::wrapping_sub`]
4473 - [`*mut T::add`]
4474 - [`*mut T::copy_to_nonoverlapping`]
4475 - [`*mut T::copy_to`]
4476 - [`*mut T::read_unaligned`]
4477 - [`*mut T::read_volatile`]
4478 - [`*mut T::read`]
4479 - [`*mut T::replace`]
4480 - [`*mut T::sub`]
4481 - [`*mut T::swap`]
4482 - [`*mut T::wrapping_add`]
4483 - [`*mut T::wrapping_sub`]
4484 - [`*mut T::write_bytes`]
4485 - [`*mut T::write_unaligned`]
4486 - [`*mut T::write_volatile`]
4487 - [`*mut T::write`]
4488 - [`Box::leak`]
4489 - [`FromUtf8Error::as_bytes`]
4490 - [`LocalKey::try_with`]
4491 - [`Option::cloned`]
4492 - [`btree_map::Entry::and_modify`]
4493 - [`fs::read_to_string`]
4494 - [`fs::read`]
4495 - [`fs::write`]
4496 - [`hash_map::Entry::and_modify`]
4497 - [`iter::FusedIterator`]
4498 - [`ops::RangeInclusive`]
4499 - [`ops::RangeToInclusive`]
4500 - [`process::id`]
4501 - [`slice::rotate_left`]
4502 - [`slice::rotate_right`]
4503 - [`String::retain`]
4504
4505
4506 Cargo
4507 -----
4508 - [Cargo will now output path to custom commands when `-v` is
4509   passed with `--list`][cargo/5041]
4510 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4511
4512 Misc
4513 ----
4514 - [The second edition of "The Rust Programming Language" book is now recommended
4515   over the first.][48404]
4516
4517 Compatibility Notes
4518 -------------------
4519
4520 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4521   syntax is now invalid.
4522   ```
4523   use std::ops::Fn as dyn;
4524   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4525   ```
4526 - [The result of dereferences are no longer promoted to `'static`.][47408]
4527   e.g.
4528   ```rust
4529   fn main() {
4530       const PAIR: &(i32, i32) = &(0, 1);
4531       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4532   }
4533   ```
4534 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4535 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4536   an error.][48235]
4537 - [Removed hoedown from rustdoc.][48274]
4538 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4539
4540 [46882]: https://github.com/rust-lang/rust/pull/46882
4541 [47379]: https://github.com/rust-lang/rust/pull/47379
4542 [47408]: https://github.com/rust-lang/rust/pull/47408
4543 [47813]: https://github.com/rust-lang/rust/pull/47813
4544 [48056]: https://github.com/rust-lang/rust/pull/48056
4545 [48125]: https://github.com/rust-lang/rust/pull/48125
4546 [48166]: https://github.com/rust-lang/rust/pull/48166
4547 [48235]: https://github.com/rust-lang/rust/pull/48235
4548 [48274]: https://github.com/rust-lang/rust/pull/48274
4549 [48281]: https://github.com/rust-lang/rust/pull/48281
4550 [48296]: https://github.com/rust-lang/rust/pull/48296
4551 [48326]: https://github.com/rust-lang/rust/pull/48326
4552 [48359]: https://github.com/rust-lang/rust/pull/48359
4553 [48404]: https://github.com/rust-lang/rust/pull/48404
4554 [48481]: https://github.com/rust-lang/rust/pull/48481
4555 [48516]: https://github.com/rust-lang/rust/pull/48516
4556 [48628]: https://github.com/rust-lang/rust/pull/48628
4557 [48629]: https://github.com/rust-lang/rust/pull/48629
4558 [48657]: https://github.com/rust-lang/rust/pull/48657
4559 [48735]: https://github.com/rust-lang/rust/pull/48735
4560 [48978]: https://github.com/rust-lang/rust/pull/48978
4561 [49101]: https://github.com/rust-lang/rust/pull/49101
4562 [49109]: https://github.com/rust-lang/rust/pull/49109
4563 [49121]: https://github.com/rust-lang/rust/pull/49121
4564 [49162]: https://github.com/rust-lang/rust/pull/49162
4565 [49184]: https://github.com/rust-lang/rust/pull/49184
4566 [49234]: https://github.com/rust-lang/rust/pull/49234
4567 [49255]: https://github.com/rust-lang/rust/pull/49255
4568 [49299]: https://github.com/rust-lang/rust/pull/49299
4569 [49305]: https://github.com/rust-lang/rust/pull/49305
4570 [49394]: https://github.com/rust-lang/rust/pull/49394
4571 [49458]: https://github.com/rust-lang/rust/pull/49458
4572 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4573 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4574 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4575 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4576 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4577 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4578 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4579 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4580 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4581 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4582 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4583 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4584 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4585 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4586 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4587 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4588 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4589 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4590 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4591 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4592 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4593 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4594 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4595 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4596 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4597 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4598 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4599 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4600 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4601 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4602 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4603 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4604 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4605 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4606 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4607 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4608 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4609 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4610 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4611 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4612 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4613 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4614
4615
4616 Version 1.25.0 (2018-03-29)
4617 ==========================
4618
4619 Language
4620 --------
4621 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4622 - [You can now use nested groups of imports.][47948]
4623   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4624 - [You can now have `|` at the start of a match arm.][47947] e.g.
4625 ```rust
4626 enum Foo { A, B, C }
4627
4628 fn main() {
4629     let x = Foo::A;
4630     match x {
4631         | Foo::A
4632         | Foo::B => println!("AB"),
4633         | Foo::C => println!("C"),
4634     }
4635 }
4636 ```
4637
4638 Compiler
4639 --------
4640 - [Upgraded to LLVM 6.][47828]
4641 - [Added `-C lto=val` option.][47521]
4642 - [Added `i586-unknown-linux-musl` target][47282]
4643
4644 Libraries
4645 ---------
4646 - [Impl Send for `process::Command` on Unix.][47760]
4647 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4648 - [`UnsafeCell::into_inner` is now safe.][47204]
4649 - [Implement libstd for CloudABI.][47268]
4650 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4651 - [Implement `AsRef<Path>` for Component][46985]
4652 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4653 - [Moved `Duration` to libcore.][46666]
4654
4655 Stabilized APIs
4656 ---------------
4657 - [`Location::column`]
4658 - [`ptr::NonNull`]
4659
4660 The following functions can now be used in a constant expression.
4661 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4662 - [`Duration::new`][47300]
4663 - [`Duration::from_secs`][47300]
4664 - [`Duration::from_millis`][47300]
4665
4666 Cargo
4667 -----
4668 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4669 - [`cargo new` now defaults to creating a binary crate, instead of a
4670   library crate.][cargo/5029]
4671
4672 Misc
4673 ----
4674 - [Rust by example is now shipped with new releases][46196]
4675
4676 Compatibility Notes
4677 -------------------
4678 - [Deprecated `net::lookup_host`.][47510]
4679 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4680 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4681   around indexing operations (see [#47349][47349]). This has been fixed (which also
4682   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4683 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4684
4685 [33903]: https://github.com/rust-lang/rust/pull/33903
4686 [47947]: https://github.com/rust-lang/rust/pull/47947
4687 [47948]: https://github.com/rust-lang/rust/pull/47948
4688 [47760]: https://github.com/rust-lang/rust/pull/47760
4689 [47790]: https://github.com/rust-lang/rust/pull/47790
4690 [47828]: https://github.com/rust-lang/rust/pull/47828
4691 [47398]: https://github.com/rust-lang/rust/pull/47398
4692 [47510]: https://github.com/rust-lang/rust/pull/47510
4693 [47521]: https://github.com/rust-lang/rust/pull/47521
4694 [47204]: https://github.com/rust-lang/rust/pull/47204
4695 [47251]: https://github.com/rust-lang/rust/pull/47251
4696 [47268]: https://github.com/rust-lang/rust/pull/47268
4697 [47282]: https://github.com/rust-lang/rust/pull/47282
4698 [47300]: https://github.com/rust-lang/rust/pull/47300
4699 [47349]: https://github.com/rust-lang/rust/pull/47349
4700 [46931]: https://github.com/rust-lang/rust/pull/46931
4701 [46985]: https://github.com/rust-lang/rust/pull/46985
4702 [47006]: https://github.com/rust-lang/rust/pull/47006
4703 [46830]: https://github.com/rust-lang/rust/pull/46830
4704 [46095]: https://github.com/rust-lang/rust/pull/46095
4705 [46666]: https://github.com/rust-lang/rust/pull/46666
4706 [46196]: https://github.com/rust-lang/rust/pull/46196
4707 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4708 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4709 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4710 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4711 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4712
4713
4714 Version 1.24.1 (2018-03-01)
4715 ==========================
4716
4717  - [Do not abort when unwinding through FFI][48251]
4718  - [Emit UTF-16 files for linker arguments on Windows][48318]
4719  - [Make the error index generator work again][48308]
4720  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4721
4722 [48251]: https://github.com/rust-lang/rust/issues/48251
4723 [48308]: https://github.com/rust-lang/rust/issues/48308
4724 [48318]: https://github.com/rust-lang/rust/issues/48318
4725 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4726
4727
4728 Version 1.24.0 (2018-02-15)
4729 ==========================
4730
4731 Language
4732 --------
4733 - [External `sysv64` ffi is now available.][46528]
4734   eg. `extern "sysv64" fn foo () {}`
4735
4736 Compiler
4737 --------
4738 - [rustc now uses 16 codegen units by default for release builds.][46910]
4739   For the fastest builds, utilize `codegen-units=1`.
4740 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4741 - [Add `aarch64-unknown-openbsd` support][46760]
4742
4743 Libraries
4744 ---------
4745 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4746   improvement in performance in the majority of cases.
4747 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4748   with Windows.][46798]
4749 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4750 - [impl `From<bool>` for `AtomicBool`][46293]
4751 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4752 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4753 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4754 - [float::from_bits now just uses transmute.][46012] This provides
4755   some optimisations from LLVM.
4756 - [Copied `AsciiExt` methods onto `char`][46077]
4757 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4758 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4759 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4760 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4761
4762 Stabilized APIs
4763 ---------------
4764 - [`RefCell::replace`]
4765 - [`RefCell::swap`]
4766 - [`atomic::spin_loop_hint`]
4767
4768 The following functions can now be used in a constant expression.
4769 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4770
4771 - [`AtomicBool::new`][46287]
4772 - [`AtomicUsize::new`][46287]
4773 - [`AtomicIsize::new`][46287]
4774 - [`AtomicPtr::new`][46287]
4775 - [`Cell::new`][46287]
4776 - [`{integer}::min_value`][46287]
4777 - [`{integer}::max_value`][46287]
4778 - [`mem::size_of`][46287]
4779 - [`mem::align_of`][46287]
4780 - [`ptr::null`][46287]
4781 - [`ptr::null_mut`][46287]
4782 - [`RefCell::new`][46287]
4783 - [`UnsafeCell::new`][46287]
4784
4785 Cargo
4786 -----
4787 - [Added a `workspace.default-members` config that
4788   overrides implied `--all` in virtual workspaces.][cargo/4743]
4789 - [Enable incremental by default on development builds.][cargo/4817] Also added
4790   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4791   per-project or global basis respectively.
4792
4793 Misc
4794 ----
4795
4796 Compatibility Notes
4797 -------------------
4798 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4799 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4800   in accordance with IETF RFC 4291 §2.2.
4801 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4802 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4803   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4804 - [Leading zeros in tuple struct members is now an error][47084]
4805 - [`column!()` macro is one-based instead of zero-based][46977]
4806 - [`fmt::Arguments` can no longer be shared across threads][45198]
4807 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4808 - [Cargo sets a different working directory for the compiler][cargo/4788]
4809
4810 [44884]: https://github.com/rust-lang/rust/pull/44884
4811 [45198]: https://github.com/rust-lang/rust/pull/45198
4812 [45506]: https://github.com/rust-lang/rust/pull/45506
4813 [45904]: https://github.com/rust-lang/rust/pull/45904
4814 [45990]: https://github.com/rust-lang/rust/pull/45990
4815 [46012]: https://github.com/rust-lang/rust/pull/46012
4816 [46077]: https://github.com/rust-lang/rust/pull/46077
4817 [46094]: https://github.com/rust-lang/rust/pull/46094
4818 [46284]: https://github.com/rust-lang/rust/pull/46284
4819 [46287]: https://github.com/rust-lang/rust/pull/46287
4820 [46293]: https://github.com/rust-lang/rust/pull/46293
4821 [46528]: https://github.com/rust-lang/rust/pull/46528
4822 [46671]: https://github.com/rust-lang/rust/pull/46671
4823 [46713]: https://github.com/rust-lang/rust/pull/46713
4824 [46735]: https://github.com/rust-lang/rust/pull/46735
4825 [46749]: https://github.com/rust-lang/rust/pull/46749
4826 [46760]: https://github.com/rust-lang/rust/pull/46760
4827 [46798]: https://github.com/rust-lang/rust/pull/46798
4828 [46828]: https://github.com/rust-lang/rust/pull/46828
4829 [46831]: https://github.com/rust-lang/rust/pull/46831
4830 [46833]: https://github.com/rust-lang/rust/pull/46833
4831 [46910]: https://github.com/rust-lang/rust/pull/46910
4832 [46977]: https://github.com/rust-lang/rust/pull/46977
4833 [47018]: https://github.com/rust-lang/rust/pull/47018
4834 [47080]: https://github.com/rust-lang/rust/pull/47080
4835 [47084]: https://github.com/rust-lang/rust/pull/47084
4836 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4837 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4838 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4839 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4840 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4841 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4842
4843
4844 Version 1.23.0 (2018-01-04)
4845 ==========================
4846
4847 Language
4848 --------
4849 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4850 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4851   Which should fix some confusing errors in some operations.
4852
4853 Compiler
4854 --------
4855 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4856   undefined behavior.][45920]
4857 - [rustc now suggests renaming import if names clash.][45660]
4858 - [Display errors/warnings correctly when there are zero-width or
4859   wide characters.][45711]
4860 - [rustc now avoids unnecessary copies of arguments that are
4861   simple bindings][45380] This should improve memory usage on average by 5-10%.
4862 - [Updated musl used to build musl rustc to 1.1.17][45393]
4863
4864 Libraries
4865 ---------
4866 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4867 - [Implement Hash for raw pointers to unsized types][45483]
4868 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4869 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4870 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4871 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4872   and `<*mut T>::as_mut`][44932]
4873 - [Optimized `Thread::{park, unpark}` implementation][45524]
4874 - [Improved `SliceExt::binary_search` performance.][45333]
4875 - [impl `FromIterator<()>` for `()`][45379]
4876 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4877   is now deprecated.
4878
4879 Stabilized APIs
4880 ---------------
4881
4882 Cargo
4883 -----
4884 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4885   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4886 - [Added unit test checking to `cargo check`][cargo/4592]
4887 - [Cargo now lets you install a specific version
4888   using `cargo install --version`][cargo/4637]
4889
4890 Misc
4891 ----
4892 - [Releases now ship with the Cargo book documentation.][45692]
4893 - [rustdoc now prints rendering warnings on every run.][45324]
4894
4895 Compatibility Notes
4896 -------------------
4897 - [Changes have been made to type equality to make it more correct,
4898   in rare cases this could break some code.][45853] [Tracking issue for
4899   further information][45852]
4900 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4901 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4902   Android 9, the minimum supported version is Android 14.
4903 - [Bumped the minimum LLVM to 3.9][45326]
4904
4905 [44042]: https://github.com/rust-lang/rust/pull/44042
4906 [44932]: https://github.com/rust-lang/rust/pull/44932
4907 [45267]: https://github.com/rust-lang/rust/pull/45267
4908 [45324]: https://github.com/rust-lang/rust/pull/45324
4909 [45326]: https://github.com/rust-lang/rust/pull/45326
4910 [45333]: https://github.com/rust-lang/rust/pull/45333
4911 [45379]: https://github.com/rust-lang/rust/pull/45379
4912 [45380]: https://github.com/rust-lang/rust/pull/45380
4913 [45393]: https://github.com/rust-lang/rust/pull/45393
4914 [45435]: https://github.com/rust-lang/rust/pull/45435
4915 [45483]: https://github.com/rust-lang/rust/pull/45483
4916 [45524]: https://github.com/rust-lang/rust/pull/45524
4917 [45571]: https://github.com/rust-lang/rust/pull/45571
4918 [45580]: https://github.com/rust-lang/rust/pull/45580
4919 [45610]: https://github.com/rust-lang/rust/pull/45610
4920 [45660]: https://github.com/rust-lang/rust/pull/45660
4921 [45692]: https://github.com/rust-lang/rust/pull/45692
4922 [45711]: https://github.com/rust-lang/rust/pull/45711
4923 [45772]: https://github.com/rust-lang/rust/pull/45772
4924 [45852]: https://github.com/rust-lang/rust/issues/45852
4925 [45853]: https://github.com/rust-lang/rust/pull/45853
4926 [45887]: https://github.com/rust-lang/rust/pull/45887
4927 [45920]: https://github.com/rust-lang/rust/pull/45920
4928 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4929 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4930 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4931
4932
4933 Version 1.22.1 (2017-11-22)
4934 ==========================
4935
4936 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4937
4938 [46183]: https://github.com/rust-lang/rust/pull/46183
4939
4940 Version 1.22.0 (2017-11-22)
4941 ==========================
4942
4943 Language
4944 --------
4945 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4946 - [Now accepts underscores in unicode escapes][43716]
4947 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4948 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4949
4950 Compiler
4951 --------
4952 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4953 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4954   This should decrease compile times for debug builds.
4955 - [strict memory alignment now enabled on ARMv6][45094]
4956 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4957
4958 Libraries
4959 ---------
4960 - [Allow atomic operations up to 32 bits
4961   on `armv5te_unknown_linux_gnueabi`][44978]
4962 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4963 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4964 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4965 - [Properly detect overflow in `Instant += Duration`.][44220]
4966 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4967 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4968 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4969
4970 Stabilized APIs
4971 ---------------
4972
4973 Cargo
4974 -----
4975 - [Cargo will now build multi file examples in subdirectories of the `examples`
4976   folder that have a `main.rs` file.][cargo/4496]
4977 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4978   the old format will continue to work and can be updated with `cargo update`.
4979 - [Now supports vendoring git repositories][cargo/3992]
4980
4981 Misc
4982 ----
4983 - [`libbacktrace` is now available on Apple platforms.][44251]
4984 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4985   This now lets you specify that a given code example will fail to compile.
4986
4987 Compatibility Notes
4988 -------------------
4989 - [The minimum Android version that rustc can build for has been bumped
4990   to `4.0` from `2.3`][45656]
4991 - [Allowing `T op= &T` for numeric types has broken some type
4992   inference cases][45480]
4993
4994
4995 [42526]: https://github.com/rust-lang/rust/pull/42526
4996 [43017]: https://github.com/rust-lang/rust/pull/43017
4997 [43716]: https://github.com/rust-lang/rust/pull/43716
4998 [43949]: https://github.com/rust-lang/rust/pull/43949
4999 [44015]: https://github.com/rust-lang/rust/pull/44015
5000 [44220]: https://github.com/rust-lang/rust/pull/44220
5001 [44251]: https://github.com/rust-lang/rust/pull/44251
5002 [44287]: https://github.com/rust-lang/rust/pull/44287
5003 [44303]: https://github.com/rust-lang/rust/pull/44303
5004 [44456]: https://github.com/rust-lang/rust/pull/44456
5005 [44466]: https://github.com/rust-lang/rust/pull/44466
5006 [44895]: https://github.com/rust-lang/rust/pull/44895
5007 [44966]: https://github.com/rust-lang/rust/pull/44966
5008 [44978]: https://github.com/rust-lang/rust/pull/44978
5009 [45041]: https://github.com/rust-lang/rust/pull/45041
5010 [45064]: https://github.com/rust-lang/rust/pull/45064
5011 [45075]: https://github.com/rust-lang/rust/pull/45075
5012 [45094]: https://github.com/rust-lang/rust/pull/45094
5013 [45095]: https://github.com/rust-lang/rust/pull/45095
5014 [45480]: https://github.com/rust-lang/rust/issues/45480
5015 [45656]: https://github.com/rust-lang/rust/pull/45656
5016 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5017 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5018 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5019
5020
5021
5022
5023
5024
5025 Version 1.21.0 (2017-10-12)
5026 ==========================
5027
5028 Language
5029 --------
5030 - [You can now use static references for literals.][43838]
5031   Example:
5032   ```rust
5033   fn main() {
5034       let x: &'static u32 = &0;
5035   }
5036   ```
5037 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5038   Example:
5039   ```rust
5040   my_macro!(Vec<i32>::new); // Always worked
5041   my_macro!(Vec::<i32>::new); // Now works
5042   ```
5043
5044 Compiler
5045 --------
5046 - [Upgraded jemalloc to 4.5.0][43911]
5047 - [Enabled unwinding panics on Redox][43917]
5048 - [Now runs LLVM in parallel during translation phase.][43506]
5049   This should reduce peak memory usage.
5050
5051 Libraries
5052 ---------
5053 - [Generate builtin impls for `Clone` for all arrays and tuples that
5054   are `T: Clone`][43690]
5055 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5056 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5057   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5058
5059 Stabilized APIs
5060 ---------------
5061
5062 [`std::mem::discriminant`]
5063
5064 Cargo
5065 -----
5066 - [You can now call `cargo install` with multiple package names][cargo/4216]
5067 - [Cargo commands inside a virtual workspace will now implicitly
5068   pass `--all`][cargo/4335]
5069 - [Added a `[patch]` section to `Cargo.toml` to handle
5070   prepublication dependencies][cargo/4123] [RFC 1969]
5071 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5072   like patterns][cargo/4270]
5073 - [Added the `--all-targets` option][cargo/4400]
5074 - [Using required dependencies as a feature is now deprecated and emits
5075   a warning][cargo/4364]
5076
5077
5078 Misc
5079 ----
5080 - [Cargo docs are moving][43916]
5081   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5082 - [The rustdoc book is now available][43863]
5083   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5084 - [Added a preview of RLS has been made available through rustup][44204]
5085   Install with `rustup component add rls-preview`
5086 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5087   Previously only showed `std::os::unix`.
5088
5089 Compatibility Notes
5090 -------------------
5091 - [Changes in method matching against higher-ranked types][43880] This may cause
5092   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5093 - [rustc's JSON error output's byte position start at top of file.][42973]
5094   Was previously relative to the rustc's internal `CodeMap` struct which
5095   required the unstable library `libsyntax` to correctly use.
5096 - [`unused_results` lint no longer ignores booleans][43728]
5097
5098 [42565]: https://github.com/rust-lang/rust/pull/42565
5099 [42973]: https://github.com/rust-lang/rust/pull/42973
5100 [43348]: https://github.com/rust-lang/rust/pull/43348
5101 [43459]: https://github.com/rust-lang/rust/pull/43459
5102 [43506]: https://github.com/rust-lang/rust/pull/43506
5103 [43540]: https://github.com/rust-lang/rust/pull/43540
5104 [43690]: https://github.com/rust-lang/rust/pull/43690
5105 [43728]: https://github.com/rust-lang/rust/pull/43728
5106 [43838]: https://github.com/rust-lang/rust/pull/43838
5107 [43863]: https://github.com/rust-lang/rust/pull/43863
5108 [43880]: https://github.com/rust-lang/rust/pull/43880
5109 [43911]: https://github.com/rust-lang/rust/pull/43911
5110 [43916]: https://github.com/rust-lang/rust/pull/43916
5111 [43917]: https://github.com/rust-lang/rust/pull/43917
5112 [44204]: https://github.com/rust-lang/rust/pull/44204
5113 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5114 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5115 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5116 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5117 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5118 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5119 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5120 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5121 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5122
5123 Version 1.20.0 (2017-08-31)
5124 ===========================
5125
5126 Language
5127 --------
5128 - [Associated constants are now stabilised.][42809]
5129 - [A lot of macro bugs are now fixed.][42913]
5130
5131 Compiler
5132 --------
5133
5134 - [Struct fields are now properly coerced to the expected field type.][42807]
5135 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5136   `wasm32-experimental-emscripten` target.
5137 - [Changed some of the error messages to be more helpful.][42033]
5138 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5139   it.][43170]
5140 - [rustc now reports the total number of errors on compilation failure][43015]
5141   previously this was only the number of errors in the pass that failed.
5142 - [Expansion in rustc has been sped up 29x.][42533]
5143 - [added `msp430-none-elf` target.][43099]
5144 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5145   applicable][43178]
5146 - [Fixes backtraces on Redox][43228]
5147 - [rustc now identifies different versions of same crate when absolute paths of
5148   different types match in an error message.][42826]
5149
5150 Libraries
5151 ---------
5152
5153
5154 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5155 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5156   tuples.][43011]
5157 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5158   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5159 - [Impl `Clone` for `DefaultHasher`.][42799]
5160 - [Impl `Sync` for `SyncSender`.][42397]
5161 - [Impl `FromStr` for `char`][42271]
5162 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5163   NaN.][42431]
5164 - [allow messages in the `unimplemented!()` macro.][42155]
5165   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5166 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5167 - [Upgrade to Unicode 10.0.0][42999]
5168 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5169 - [Skip the main thread's manual stack guard on Linux][43072]
5170 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5171 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5172   previously 2^15.
5173 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5174
5175 Stabilized APIs
5176 ---------------
5177
5178 - [`CStr::into_c_string`]
5179 - [`CString::as_c_str`]
5180 - [`CString::into_boxed_c_str`]
5181 - [`Chain::get_mut`]
5182 - [`Chain::get_ref`]
5183 - [`Chain::into_inner`]
5184 - [`Option::get_or_insert_with`]
5185 - [`Option::get_or_insert`]
5186 - [`OsStr::into_os_string`]
5187 - [`OsString::into_boxed_os_str`]
5188 - [`Take::get_mut`]
5189 - [`Take::get_ref`]
5190 - [`Utf8Error::error_len`]
5191 - [`char::EscapeDebug`]
5192 - [`char::escape_debug`]
5193 - [`compile_error!`]
5194 - [`f32::from_bits`]
5195 - [`f32::to_bits`]
5196 - [`f64::from_bits`]
5197 - [`f64::to_bits`]
5198 - [`mem::ManuallyDrop`]
5199 - [`slice::sort_unstable_by_key`]
5200 - [`slice::sort_unstable_by`]
5201 - [`slice::sort_unstable`]
5202 - [`str::from_boxed_utf8_unchecked`]
5203 - [`str::as_bytes_mut`]
5204 - [`str::as_bytes_mut`]
5205 - [`str::from_utf8_mut`]
5206 - [`str::from_utf8_unchecked_mut`]
5207 - [`str::get_mut`]
5208 - [`str::get_unchecked_mut`]
5209 - [`str::get_unchecked`]
5210 - [`str::get`]
5211 - [`str::into_boxed_bytes`]
5212
5213
5214 Cargo
5215 -----
5216 - [Cargo API token location moved from `~/.cargo/config` to
5217   `~/.cargo/credentials`.][cargo/3978]
5218 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5219   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5220   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5221 - [You can now specify version of a binary when installed through
5222   `cargo install` using `--vers`.][cargo/4229]
5223 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5224   failure.][cargo/4248]
5225 - [Changed the convention around which file is the crate root.][cargo/4259]
5226 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5227   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5228
5229 Compatibility Notes
5230 -------------------
5231
5232 - [Functions with `'static` in their return types will now not be as usable as
5233   if they were using lifetime parameters instead.][42417]
5234 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5235   takes the sign of NaN into account where previously didn't.][42430]
5236
5237 [42033]: https://github.com/rust-lang/rust/pull/42033
5238 [42155]: https://github.com/rust-lang/rust/pull/42155
5239 [42271]: https://github.com/rust-lang/rust/pull/42271
5240 [42397]: https://github.com/rust-lang/rust/pull/42397
5241 [42417]: https://github.com/rust-lang/rust/pull/42417
5242 [42430]: https://github.com/rust-lang/rust/pull/42430
5243 [42431]: https://github.com/rust-lang/rust/pull/42431
5244 [42533]: https://github.com/rust-lang/rust/pull/42533
5245 [42571]: https://github.com/rust-lang/rust/pull/42571
5246 [42613]: https://github.com/rust-lang/rust/pull/42613
5247 [42799]: https://github.com/rust-lang/rust/pull/42799
5248 [42807]: https://github.com/rust-lang/rust/pull/42807
5249 [42809]: https://github.com/rust-lang/rust/pull/42809
5250 [42822]: https://github.com/rust-lang/rust/pull/42822
5251 [42826]: https://github.com/rust-lang/rust/pull/42826
5252 [42854]: https://github.com/rust-lang/rust/pull/42854
5253 [42913]: https://github.com/rust-lang/rust/pull/42913
5254 [42999]: https://github.com/rust-lang/rust/pull/42999
5255 [43011]: https://github.com/rust-lang/rust/pull/43011
5256 [43015]: https://github.com/rust-lang/rust/pull/43015
5257 [43072]: https://github.com/rust-lang/rust/pull/43072
5258 [43077]: https://github.com/rust-lang/rust/pull/43077
5259 [43097]: https://github.com/rust-lang/rust/pull/43097
5260 [43099]: https://github.com/rust-lang/rust/pull/43099
5261 [43170]: https://github.com/rust-lang/rust/pull/43170
5262 [43178]: https://github.com/rust-lang/rust/pull/43178
5263 [43185]: https://github.com/rust-lang/rust/pull/43185
5264 [43228]: https://github.com/rust-lang/rust/pull/43228
5265 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5266 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5267 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5268 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5269 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5270 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5271 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5272 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5273 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5274 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5275 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5276 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5277 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5278 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5279 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5280 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5281 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5282 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5283 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5284 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5285 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5286 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5287 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5288 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5289 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5290 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5291 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5292 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5293 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5294 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5295 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5296 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5297 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5298 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5299 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5300 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5301 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5302 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5303 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5304
5305
5306 Version 1.19.0 (2017-07-20)
5307 ===========================
5308
5309 Language
5310 --------
5311
5312 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5313   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5314 - [Macro recursion limit increased to 1024 from 64.][41676]
5315 - [Added lint for detecting unused macros.][41907]
5316 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5317   For example: `let x = loop { break 7; };`
5318 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5319   contain `Copy` types and cannot have a `Drop` implementation.
5320   Example: `union Foo { bar: u8, baz: usize }`
5321 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5322   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5323
5324 Compiler
5325 --------
5326
5327 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5328 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5329   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5330   you should use `--target armv7-linux-androideabi`.
5331 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5332 - [Minor optimisation of string operations.][42037]
5333 - [Compiler error message is now `aborting due to previous error(s)` instead of
5334   `aborting due to N previous errors`][42150] This was previously inaccurate and
5335   would only count certain kinds of errors.
5336 - [The compiler now supports Visual Studio 2017][42225]
5337 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5338 - [Added a lot][42264] of [new error codes][42302]
5339 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5340   libraries with C Run-time Libraries(CRT) to be statically linked.
5341 - [Fixed various ARM codegen bugs][42740]
5342
5343 Libraries
5344 ---------
5345
5346 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5347   `Extend<Cow<'a, str>>`][41449]
5348 - [`Vec` now implements `From<&mut [T]>`][41530]
5349 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5350 - [`SplitWhitespace` now implements `Clone`][41659]
5351 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5352   1.5x faster][41764]
5353 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5354   macros, but for printing to stderr.
5355
5356 Stabilized APIs
5357 ---------------
5358
5359 - [`OsString::shrink_to_fit`]
5360 - [`cmp::Reverse`]
5361 - [`Command::envs`]
5362 - [`thread::ThreadId`]
5363
5364 Cargo
5365 -----
5366
5367 - [Build scripts can now add environment variables to the environment
5368   the crate is being compiled in.
5369   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5370 - [Subcommands now replace the current process rather than spawning a new
5371   child process][cargo/3970]
5372 - [Workspace members can now accept glob file patterns][cargo/3979]
5373 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5374   the members in a given workspace.][cargo/3988]
5375 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5376 - [Target directory path is now in the cargo metadata][cargo/4022]
5377 - [Cargo no longer checks out a local working directory for the
5378   crates.io index][cargo/4026] This should provide smaller file size for the
5379   registry, and improve cloning times, especially on Windows machines.
5380 - [Added an `--exclude` option for excluding certain packages when using the
5381   `--all` option][cargo/4031]
5382 - [Cargo will now automatically retry when receiving a 5xx error
5383   from crates.io][cargo/4032]
5384 - [The `--features` option now accepts multiple comma or space
5385   delimited values.][cargo/4084]
5386 - [Added support for custom target specific runners][cargo/3954]
5387
5388 Misc
5389 ----
5390
5391 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5392   Windows Debugger.
5393 - [Rust will now release XZ compressed packages][rust-installer/57]
5394 - [rustup will now prefer to download rust packages with
5395   XZ compression][rustup/1100] over GZip packages.
5396 - [Added the ability to escape `#` in rust documentation][41785] By adding
5397   additional `#`'s ie. `##` is now `#`
5398
5399 Compatibility Notes
5400 -------------------
5401
5402 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5403 - [`-Z` flags are now no longer allowed to be used on the stable
5404   compiler.][41751] This has been a warning for a year previous to this.
5405 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5406   longer works][42844]. Users should migrate to the built-in `check`
5407   command, which has been available since 1.16.
5408 - [Ending a float literal with `._` is now a hard error.
5409   Example: `42._` .][41946]
5410 - [Any use of a private `extern crate` outside of its module is now a
5411   hard error.][36886] This was previously a warning.
5412 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5413   relative while the `::` prefix makes a path absolute, but was ignored and the
5414   path was relative regardless.
5415 - [Floating point constants in match patterns is now a hard error][36890]
5416   This was previously a warning.
5417 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5418   match patterns is now a hard error][36891] This was previously a warning.
5419 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5420   a warning.
5421 - [From the pound escape, lines consisting of multiple `#`s are
5422   now visible][41785]
5423 - [It is an error to re-export private enum variants][42460]. This is
5424   known to break a number of crates that depend on an older version of
5425   mustache.
5426 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5427   to use it to find the linker, and the build will fail where it did
5428   not previously][42607]
5429
5430 [36886]: https://github.com/rust-lang/rust/issues/36886
5431 [36888]: https://github.com/rust-lang/rust/issues/36888
5432 [36890]: https://github.com/rust-lang/rust/issues/36890
5433 [36891]: https://github.com/rust-lang/rust/issues/36891
5434 [36892]: https://github.com/rust-lang/rust/issues/36892
5435 [37406]: https://github.com/rust-lang/rust/issues/37406
5436 [39983]: https://github.com/rust-lang/rust/pull/39983
5437 [41145]: https://github.com/rust-lang/rust/pull/41145
5438 [41192]: https://github.com/rust-lang/rust/pull/41192
5439 [41258]: https://github.com/rust-lang/rust/pull/41258
5440 [41370]: https://github.com/rust-lang/rust/pull/41370
5441 [41449]: https://github.com/rust-lang/rust/pull/41449
5442 [41530]: https://github.com/rust-lang/rust/pull/41530
5443 [41624]: https://github.com/rust-lang/rust/pull/41624
5444 [41656]: https://github.com/rust-lang/rust/pull/41656
5445 [41659]: https://github.com/rust-lang/rust/pull/41659
5446 [41676]: https://github.com/rust-lang/rust/pull/41676
5447 [41751]: https://github.com/rust-lang/rust/pull/41751
5448 [41764]: https://github.com/rust-lang/rust/pull/41764
5449 [41785]: https://github.com/rust-lang/rust/pull/41785
5450 [41873]: https://github.com/rust-lang/rust/pull/41873
5451 [41907]: https://github.com/rust-lang/rust/pull/41907
5452 [41946]: https://github.com/rust-lang/rust/pull/41946
5453 [42016]: https://github.com/rust-lang/rust/pull/42016
5454 [42037]: https://github.com/rust-lang/rust/pull/42037
5455 [42068]: https://github.com/rust-lang/rust/pull/42068
5456 [42150]: https://github.com/rust-lang/rust/pull/42150
5457 [42162]: https://github.com/rust-lang/rust/pull/42162
5458 [42225]: https://github.com/rust-lang/rust/pull/42225
5459 [42264]: https://github.com/rust-lang/rust/pull/42264
5460 [42302]: https://github.com/rust-lang/rust/pull/42302
5461 [42460]: https://github.com/rust-lang/rust/issues/42460
5462 [42607]: https://github.com/rust-lang/rust/issues/42607
5463 [42740]: https://github.com/rust-lang/rust/pull/42740
5464 [42844]: https://github.com/rust-lang/rust/issues/42844
5465 [42948]: https://github.com/rust-lang/rust/pull/42948
5466 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5467 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5468 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5469 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5470 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5471 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5472 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5473 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5474 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5475 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5476 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5477 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5478 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5479 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5480 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5481 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5482 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5483 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5484 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5485 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5486 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5487 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5488
5489
5490 Version 1.18.0 (2017-06-08)
5491 ===========================
5492
5493 Language
5494 --------
5495
5496 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5497   make the item visible to just that module tree. Also accepts the keyword
5498   `crate` to make something public to the whole crate but not users of the
5499   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5500 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5501   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5502 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5503   types like `Write + Send`, trailing `+` are now supported in trait objects,
5504   and better error reporting for trait objects starting with `?Sized`.
5505 - [0e+10 is now a valid floating point literal][40589]
5506 - [Now warns if you bind a lifetime parameter to 'static][40734]
5507 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5508   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5509   representation in some cases.][40377]
5510
5511 Compiler
5512 --------
5513
5514 - [rustc can now emit mir with `--emit mir`][39891]
5515 - [Improved LLVM IR for trivial functions][40367]
5516 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5517 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5518   opportunities found through profiling
5519 - [Improved backtrace formatting when panicking][38165]
5520
5521 Libraries
5522 ---------
5523
5524 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5525   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5526   iteration or reallocation.
5527 - [Simplified HashMap Bucket interface][40561] provides performance
5528   improvements for iterating and cloning.
5529 - [Specialize Vec::from_elem to use calloc][40409]
5530 - [Fixed Race condition in fs::create_dir_all][39799]
5531 - [No longer caching stdio on Windows][40516]
5532 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5533   2.50%~ faster and in one case now 12.50% faster.
5534 - [Optimized `AtomicBool::fetch_nand`][41143]
5535
5536 Stabilized APIs
5537 ---------------
5538
5539 - [`Child::try_wait`]
5540 - [`HashMap::retain`]
5541 - [`HashSet::retain`]
5542 - [`PeekMut::pop`]
5543 - [`TcpStream::peek`]
5544 - [`UdpSocket::peek`]
5545 - [`UdpSocket::peek_from`]
5546
5547 Cargo
5548 -----
5549
5550 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5551   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5552 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5553 - [Added Android build support][cargo/3885]
5554 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5555   of a certain type, for example `cargo build --bins` will build all
5556   binaries.
5557 - [Added support for haiku][cargo/3952]
5558
5559 Misc
5560 ----
5561
5562 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5563 - [Added rust-windbg script for better debugging on Windows][39983]
5564 - [Rust now uses the official cross compiler for NetBSD][40612]
5565 - [rustdoc now accepts `#` at the start of files][40828]
5566 - [Fixed jemalloc support for musl][41168]
5567
5568 Compatibility Notes
5569 -------------------
5570
5571 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5572   always placed after the sign if it exists and before the digits. With the `#`
5573   flag the zeroes are placed after the prefix and before the digits.
5574 - [Due to the struct field optimisation][40377], using `transmute` on structs
5575   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5576   always been undefined behavior, but is now more likely to break in practice.
5577 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5578   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5579   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5580 - [Overlapping inherent `impl`s are now a hard error][40728]
5581 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5582 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5583   `out.asm` and `out.ll` instead of only one of the filetypes.
5584 - [ calling a function that returns `Self` will no longer work][41805] when
5585   the size of `Self` cannot be statically determined.
5586 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5587   this has caused a few regressions namely:
5588
5589   - Changed the link order of local static/dynamic libraries (respecting the
5590     order on given rather than having the compiler reorder).
5591   - Changed how MinGW is linked, native code linked to dynamic libraries
5592     may require manually linking to the gcc support library (for the native
5593     code itself)
5594
5595 [38165]: https://github.com/rust-lang/rust/pull/38165
5596 [39799]: https://github.com/rust-lang/rust/pull/39799
5597 [39891]: https://github.com/rust-lang/rust/pull/39891
5598 [39983]: https://github.com/rust-lang/rust/pull/39983
5599 [40043]: https://github.com/rust-lang/rust/pull/40043
5600 [40241]: https://github.com/rust-lang/rust/pull/40241
5601 [40338]: https://github.com/rust-lang/rust/pull/40338
5602 [40367]: https://github.com/rust-lang/rust/pull/40367
5603 [40377]: https://github.com/rust-lang/rust/pull/40377
5604 [40409]: https://github.com/rust-lang/rust/pull/40409
5605 [40516]: https://github.com/rust-lang/rust/pull/40516
5606 [40556]: https://github.com/rust-lang/rust/pull/40556
5607 [40561]: https://github.com/rust-lang/rust/pull/40561
5608 [40589]: https://github.com/rust-lang/rust/pull/40589
5609 [40612]: https://github.com/rust-lang/rust/pull/40612
5610 [40723]: https://github.com/rust-lang/rust/pull/40723
5611 [40728]: https://github.com/rust-lang/rust/pull/40728
5612 [40731]: https://github.com/rust-lang/rust/pull/40731
5613 [40734]: https://github.com/rust-lang/rust/pull/40734
5614 [40805]: https://github.com/rust-lang/rust/pull/40805
5615 [40807]: https://github.com/rust-lang/rust/pull/40807
5616 [40828]: https://github.com/rust-lang/rust/pull/40828
5617 [40870]: https://github.com/rust-lang/rust/pull/40870
5618 [41085]: https://github.com/rust-lang/rust/pull/41085
5619 [41143]: https://github.com/rust-lang/rust/pull/41143
5620 [41168]: https://github.com/rust-lang/rust/pull/41168
5621 [41270]: https://github.com/rust-lang/rust/issues/41270
5622 [41469]: https://github.com/rust-lang/rust/pull/41469
5623 [41805]: https://github.com/rust-lang/rust/issues/41805
5624 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5625 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5626 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5627 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5628 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5629 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5630 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5631 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5632 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5633 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5634 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5635 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5636 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5637 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5638
5639
5640 Version 1.17.0 (2017-04-27)
5641 ===========================
5642
5643 Language
5644 --------
5645
5646 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5647 * [Fields of structs may be initialized without duplicating the field/variable
5648   names][39761]. [RFC 1682]
5649 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5650 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5651   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5652   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5653   `'b`. Soundness fix.
5654 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5655 * [Static variables may contain references to other statics][40027]
5656
5657 Compiler
5658 --------
5659
5660 * [Exit quickly on only `--emit dep-info`][40336]
5661 * [Make `-C relocation-model` more correctly determine whether the linker
5662   creates a position-independent executable][40245]
5663 * [Add `-C overflow-checks` to directly control whether integer overflow
5664   panics][40037]
5665 * [The rustc type checker now checks items on demand instead of in a single
5666   in-order pass][40008]. This is mostly an internal refactoring in support of
5667   future work, including incremental type checking, but also resolves [RFC
5668   1647], allowing `Self` to appear in `impl` `where` clauses.
5669 * [Optimize vtable loads][39995]
5670 * [Turn off vectorization for Emscripten targets][39990]
5671 * [Provide suggestions for unknown macros imported with `use`][39953]
5672 * [Fix ICEs in path resolution][39939]
5673 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5674 * [Add clearer error message using `&str + &str`][39116]
5675
5676 Stabilized APIs
5677 ---------------
5678
5679 * [`Arc::into_raw`]
5680 * [`Arc::from_raw`]
5681 * [`Arc::ptr_eq`]
5682 * [`Rc::into_raw`]
5683 * [`Rc::from_raw`]
5684 * [`Rc::ptr_eq`]
5685 * [`Ordering::then`]
5686 * [`Ordering::then_with`]
5687 * [`BTreeMap::range`]
5688 * [`BTreeMap::range_mut`]
5689 * [`collections::Bound`]
5690 * [`process::abort`]
5691 * [`ptr::read_unaligned`]
5692 * [`ptr::write_unaligned`]
5693 * [`Result::expect_err`]
5694 * [`Cell::swap`]
5695 * [`Cell::replace`]
5696 * [`Cell::into_inner`]
5697 * [`Cell::take`]
5698
5699 Libraries
5700 ---------
5701
5702 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5703 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5704 * [`String` implements `FromIterator<&char>`][40028]
5705 * `Box` [implements][40009] a number of new conversions:
5706   `From<Box<str>> for String`,
5707   `From<Box<[T]>> for Vec<T>`,
5708   `From<Box<CStr>> for CString`,
5709   `From<Box<OsStr>> for OsString`,
5710   `From<Box<Path>> for PathBuf`,
5711   `Into<Box<str>> for String`,
5712   `Into<Box<[T]>> for Vec<T>`,
5713   `Into<Box<CStr>> for CString`,
5714   `Into<Box<OsStr>> for OsString`,
5715   `Into<Box<Path>> for PathBuf`,
5716   `Default for Box<str>`,
5717   `Default for Box<CStr>`,
5718   `Default for Box<OsStr>`,
5719   `From<&CStr> for Box<CStr>`,
5720   `From<&OsStr> for Box<OsStr>`,
5721   `From<&Path> for Box<Path>`
5722 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5723 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5724 * [Slightly optimize `slice::sort`][39538]
5725 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5726 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5727   `Box<str>` implements `From<&str>`][39438]
5728 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5729   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5730 * [`format!` estimates the needed capacity before writing a string][39356]
5731 * [Support unprivileged symlink creation in Windows][38921]
5732 * [`PathBuf` implements `Default`][38764]
5733 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5734 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5735   and poor hash functions.
5736
5737 Cargo
5738 -----
5739
5740 * [Add `cargo check --all`][cargo/3731]
5741 * [Add an option to ignore SSL revocation checking][cargo/3699]
5742 * [Add `cargo run --package`][cargo/3691]
5743 * [Add `required_features`][cargo/3667]
5744 * [Assume `build.rs` is a build script][cargo/3664]
5745 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5746
5747 Misc
5748 ----
5749
5750 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5751   `rustbook`][39633]
5752 * [The "Unstable Book" documents nightly-only features][ubook]
5753 * [Improve the style of the sidebar in rustdoc output][40265]
5754 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5755 * [Fix MSP430 breakage due to `i128`][40257]
5756 * [Preliminary Solaris/SPARCv9 support][39903]
5757 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5758   run without installing the MSVC runtime.
5759 * [`rustdoc --test` includes file names in test names][39788]
5760 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5761   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5762 * [Initial support for `aarch64-unknown-freebsd`][39491]
5763 * [Initial support for `i686-unknown-netbsd`][39426]
5764 * [This release no longer includes the old makefile build system][39431]. Rust
5765   is built with a custom build system, written in Rust, and with Cargo.
5766 * [Add Debug implementations for libcollection structs][39002]
5767 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5768 * [`--test-threads=0` produces an error][38945]
5769 * [`rustup` installs documentation by default][40526]
5770 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5771   WinDbg and Visual Studio to improve the debugging experience.
5772
5773 Compatibility Notes
5774 -------------------
5775
5776 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5777   workaround, either use MSVC 2015 or run vcvars.bat.
5778 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5779   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5780   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5781   fix.
5782 * [`format!` and `Display::to_string` panic if an underlying formatting
5783   implementation returns an error][40117]. Previously the error was silently
5784   ignored. It is incorrect for `write_fmt` to return an error when writing
5785   to a string.
5786 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5787   crates were marked stable and could be accessed from the stable toolchain.
5788 * [Rust git source no longer includes vendored crates][39728]. Those that need
5789   to build with vendored crates should build from release tarballs.
5790 * [Fix inert attributes from `proc_macro_derives`][39572]
5791 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5792   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5793   build system.
5794 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5795   existing code generally ignores the type of dead-code unless a type-hint is
5796   provided; this can cause surprising inference interactions particularly around
5797   defaulting. The new code uniformly ignores the result type of dead-code.
5798 * [Tuple-struct constructors with private fields are no longer visible][38932]
5799 * [Lifetime parameters that do not appear in the arguments are now considered
5800   early-bound][38897], resolving a soundness bug (#[32330]). The
5801   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5802   April of 2016.
5803 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5804 * [Make transmuting from fn item types to pointer-sized types a hard
5805   error][34198]
5806
5807 [27787]: https://github.com/rust-lang/rust/issues/27787
5808 [32330]: https://github.com/rust-lang/rust/issues/32330
5809 [34198]: https://github.com/rust-lang/rust/pull/34198
5810 [38161]: https://github.com/rust-lang/rust/pull/38161
5811 [38368]: https://github.com/rust-lang/rust/pull/38368
5812 [38584]: https://github.com/rust-lang/rust/issues/38584
5813 [38661]: https://github.com/rust-lang/rust/pull/38661
5814 [38764]: https://github.com/rust-lang/rust/pull/38764
5815 [38864]: https://github.com/rust-lang/rust/issues/38864
5816 [38897]: https://github.com/rust-lang/rust/pull/38897
5817 [38921]: https://github.com/rust-lang/rust/pull/38921
5818 [38932]: https://github.com/rust-lang/rust/pull/38932
5819 [38945]: https://github.com/rust-lang/rust/pull/38945
5820 [38981]: https://github.com/rust-lang/rust/pull/38981
5821 [39002]: https://github.com/rust-lang/rust/pull/39002
5822 [39116]: https://github.com/rust-lang/rust/pull/39116
5823 [39193]: https://github.com/rust-lang/rust/pull/39193
5824 [39265]: https://github.com/rust-lang/rust/pull/39265
5825 [39356]: https://github.com/rust-lang/rust/pull/39356
5826 [39372]: https://github.com/rust-lang/rust/pull/39372
5827 [39426]: https://github.com/rust-lang/rust/pull/39426
5828 [39431]: https://github.com/rust-lang/rust/pull/39431
5829 [39438]: https://github.com/rust-lang/rust/pull/39438
5830 [39440]: https://github.com/rust-lang/rust/pull/39440
5831 [39485]: https://github.com/rust-lang/rust/pull/39485
5832 [39491]: https://github.com/rust-lang/rust/pull/39491
5833 [39518]: https://github.com/rust-lang/rust/pull/39518
5834 [39538]: https://github.com/rust-lang/rust/pull/39538
5835 [39572]: https://github.com/rust-lang/rust/pull/39572
5836 [39633]: https://github.com/rust-lang/rust/pull/39633
5837 [39642]: https://github.com/rust-lang/rust/pull/39642
5838 [39728]: https://github.com/rust-lang/rust/pull/39728
5839 [39761]: https://github.com/rust-lang/rust/pull/39761
5840 [39788]: https://github.com/rust-lang/rust/pull/39788
5841 [39793]: https://github.com/rust-lang/rust/pull/39793
5842 [39837]: https://github.com/rust-lang/rust/pull/39837
5843 [39843]: https://github.com/rust-lang/rust/pull/39843
5844 [39851]: https://github.com/rust-lang/rust/pull/39851
5845 [39903]: https://github.com/rust-lang/rust/pull/39903
5846 [39939]: https://github.com/rust-lang/rust/pull/39939
5847 [39953]: https://github.com/rust-lang/rust/pull/39953
5848 [39960]: https://github.com/rust-lang/rust/pull/39960
5849 [39990]: https://github.com/rust-lang/rust/pull/39990
5850 [39995]: https://github.com/rust-lang/rust/pull/39995
5851 [40008]: https://github.com/rust-lang/rust/pull/40008
5852 [40009]: https://github.com/rust-lang/rust/pull/40009
5853 [40027]: https://github.com/rust-lang/rust/pull/40027
5854 [40028]: https://github.com/rust-lang/rust/pull/40028
5855 [40037]: https://github.com/rust-lang/rust/pull/40037
5856 [40117]: https://github.com/rust-lang/rust/pull/40117
5857 [40166]: https://github.com/rust-lang/rust/pull/40166
5858 [40245]: https://github.com/rust-lang/rust/pull/40245
5859 [40257]: https://github.com/rust-lang/rust/pull/40257
5860 [40261]: https://github.com/rust-lang/rust/pull/40261
5861 [40265]: https://github.com/rust-lang/rust/pull/40265
5862 [40319]: https://github.com/rust-lang/rust/pull/40319
5863 [40336]: https://github.com/rust-lang/rust/pull/40336
5864 [40526]: https://github.com/rust-lang/rust/pull/40526
5865 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5866 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5867 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5868 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5869 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5870 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5871 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5872 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5873 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5874 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5875 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5876 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5877 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5878 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5879 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5880 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5881 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5882 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5883 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5884 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5885 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5886 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5887 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5888 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5889 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5890 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5891 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5892 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5893 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5894 [mdbook]: https://crates.io/crates/mdbook
5895 [ubook]: https://doc.rust-lang.org/unstable-book/
5896
5897
5898 Version 1.16.0 (2017-03-16)
5899 ===========================
5900
5901 Language
5902 --------
5903
5904 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5905 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5906   match patterns][38069]
5907 * [Clean up semantics of `self` in an import list][38313]
5908 * [`Self` may appear in `impl` headers][38920]
5909 * [`Self` may appear in struct expressions][39282]
5910
5911 Compiler
5912 --------
5913
5914 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5915   a `.rmeta` file containing only crate metadata][38571]. This can be
5916   used by tools like the Rust Language Service to perform
5917   metadata-only builds.
5918 * [Levenshtein based typo suggestions now work in most places, while
5919   previously they worked only for fields and sometimes for local
5920   variables][38927]. Together with the overhaul of "no
5921   resolution"/"unexpected resolution" errors (#[38154]) they result in
5922   large and systematic improvement in resolution diagnostics.
5923 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5924   `U`][38670]
5925 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5926 * [`rustc` no longer attempts to provide "consider using an explicit
5927   lifetime" suggestions][37057]. They were inaccurate.
5928
5929 Stabilized APIs
5930 ---------------
5931
5932 * [`VecDeque::truncate`]
5933 * [`VecDeque::resize`]
5934 * [`String::insert_str`]
5935 * [`Duration::checked_add`]
5936 * [`Duration::checked_sub`]
5937 * [`Duration::checked_div`]
5938 * [`Duration::checked_mul`]
5939 * [`str::replacen`]
5940 * [`str::repeat`]
5941 * [`SocketAddr::is_ipv4`]
5942 * [`SocketAddr::is_ipv6`]
5943 * [`IpAddr::is_ipv4`]
5944 * [`IpAddr::is_ipv6`]
5945 * [`Vec::dedup_by`]
5946 * [`Vec::dedup_by_key`]
5947 * [`Result::unwrap_or_default`]
5948 * [`<*const T>::wrapping_offset`]
5949 * [`<*mut T>::wrapping_offset`]
5950 * `CommandExt::creation_flags`
5951 * [`File::set_permissions`]
5952 * [`String::split_off`]
5953
5954 Libraries
5955 ---------
5956
5957 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5958   their argument by `Borrow` parameter][37761]
5959 * [All public types in std implement `Debug`][38006]
5960 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5961 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5962 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5963   Windows][38274]
5964 * [std: Fix partial writes in `LineWriter`][38062]
5965 * [std: Clamp max read/write sizes on Unix][38062]
5966 * [Use more specific panic message for `&str` slicing errors][38066]
5967 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5968   functionality cannot be achieved in std currently.
5969 * [`writeln!`, like `println!`, now accepts a form with no string
5970   or formatting arguments, to just print a newline][38469]
5971 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5972 * [Reduce the size of static data in `std_unicode::tables`][38781]
5973 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5974   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5975   `Display`][38909]
5976 * [`Duration` implements `Sum`][38712]
5977 * [`String` implements `ToSocketAddrs`][39048]
5978
5979 Cargo
5980 -----
5981
5982 * [The `cargo check` command does a type check of a project without
5983   building it][cargo/3296]
5984 * [crates.io will display CI badges from Travis and AppVeyor, if
5985   specified in Cargo.toml][cargo/3546]
5986 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5987 * [Compilation profiles accept integer values for `debug`, in addition
5988   to `true` and `false`. These are passed to `rustc` as the value to
5989   `-C debuginfo`][cargo/3534]
5990 * [Implement `cargo --version --verbose`][cargo/3604]
5991 * [All builds now output 'dep-info' build dependencies compatible with
5992   make and ninja][cargo/3557]
5993 * [Build all workspace members with `build --all`][cargo/3511]
5994 * [Document all workspace members with `doc --all`][cargo/3515]
5995 * [Path deps outside workspace are not members][cargo/3443]
5996
5997 Misc
5998 ----
5999
6000 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6001   the path to the Rust implementation][38589]
6002 * [The `armv7-linux-androideabi` target no longer enables NEON
6003   extensions, per Google's ABI guide][38413]
6004 * [The stock standard library can be compiled for Redox OS][38401]
6005 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6006   available.
6007 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6008   builds available.
6009 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6010
6011 Compatibility Notes
6012 -------------------
6013
6014 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6015   match patterns][38069]
6016 * In this release, references to uninhabited types can not be
6017   pattern-matched. This was accidentally allowed in 1.15.
6018 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6019 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6020   Windows][38274]
6021 * [Clean up semantics of `self` in an import list][38313]
6022 * Reimplemented lifetime elision. This change was almost entirely compatible
6023   with existing code, but it did close a number of small bugs and loopholes,
6024   as well as being more accepting in some other [cases][41105].
6025
6026 [37057]: https://github.com/rust-lang/rust/pull/37057
6027 [37761]: https://github.com/rust-lang/rust/pull/37761
6028 [38006]: https://github.com/rust-lang/rust/pull/38006
6029 [38051]: https://github.com/rust-lang/rust/pull/38051
6030 [38062]: https://github.com/rust-lang/rust/pull/38062
6031 [38062]: https://github.com/rust-lang/rust/pull/38622
6032 [38066]: https://github.com/rust-lang/rust/pull/38066
6033 [38069]: https://github.com/rust-lang/rust/pull/38069
6034 [38131]: https://github.com/rust-lang/rust/pull/38131
6035 [38154]: https://github.com/rust-lang/rust/pull/38154
6036 [38274]: https://github.com/rust-lang/rust/pull/38274
6037 [38304]: https://github.com/rust-lang/rust/pull/38304
6038 [38313]: https://github.com/rust-lang/rust/pull/38313
6039 [38314]: https://github.com/rust-lang/rust/pull/38314
6040 [38327]: https://github.com/rust-lang/rust/pull/38327
6041 [38401]: https://github.com/rust-lang/rust/pull/38401
6042 [38413]: https://github.com/rust-lang/rust/pull/38413
6043 [38469]: https://github.com/rust-lang/rust/pull/38469
6044 [38559]: https://github.com/rust-lang/rust/pull/38559
6045 [38571]: https://github.com/rust-lang/rust/pull/38571
6046 [38580]: https://github.com/rust-lang/rust/pull/38580
6047 [38589]: https://github.com/rust-lang/rust/pull/38589
6048 [38670]: https://github.com/rust-lang/rust/pull/38670
6049 [38712]: https://github.com/rust-lang/rust/pull/38712
6050 [38726]: https://github.com/rust-lang/rust/pull/38726
6051 [38781]: https://github.com/rust-lang/rust/pull/38781
6052 [38798]: https://github.com/rust-lang/rust/pull/38798
6053 [38909]: https://github.com/rust-lang/rust/pull/38909
6054 [38920]: https://github.com/rust-lang/rust/pull/38920
6055 [38927]: https://github.com/rust-lang/rust/pull/38927
6056 [39048]: https://github.com/rust-lang/rust/pull/39048
6057 [39282]: https://github.com/rust-lang/rust/pull/39282
6058 [39379]: https://github.com/rust-lang/rust/pull/39379
6059 [41105]: https://github.com/rust-lang/rust/issues/41105
6060 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6061 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6062 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6063 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6064 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6065 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6066 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6067 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6068 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6069 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6070 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6071 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6072 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6073 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6074 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6075 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6076 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6077 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6078 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6079 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6080 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6081 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6082 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6083 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6084 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6085 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6086 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6087 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6088 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6089 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6090
6091
6092 Version 1.15.1 (2017-02-09)
6093 ===========================
6094
6095 * [Fix IntoIter::as_mut_slice's signature][39466]
6096 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6097
6098 [39466]: https://github.com/rust-lang/rust/pull/39466
6099 [39523]: https://github.com/rust-lang/rust/pull/39523
6100
6101
6102 Version 1.15.0 (2017-02-02)
6103 ===========================
6104
6105 Language
6106 --------
6107
6108 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6109   stable. This allows popular code-generating crates like Serde and Diesel to
6110   work ergonomically. [RFC 1681].
6111 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6112   with curly braces][36868]. Part of [RFC 1506].
6113 * [A number of minor changes to name resolution have been activated][37127].
6114   They add up to more consistent semantics, allowing for future evolution of
6115   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6116   details of what is different. The breaking changes here have been transitioned
6117   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6118 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6119   bounds][38279]
6120 * [`?Sized` can be used in `where` clauses][37791]
6121 * [There is now a limit on the size of monomorphized types and it can be
6122   modified with the `#![type_size_limit]` crate attribute, similarly to
6123   the `#![recursion_limit]` attribute][37789]
6124
6125 Compiler
6126 --------
6127
6128 * [On Windows, the compiler will apply dllimport attributes when linking to
6129   extern functions][37973]. Additional attributes and flags can control which
6130   library kind is linked and its name. [RFC 1717].
6131 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6132 * [The `--test` flag works with procedural macro crates][38107]
6133 * [Fix `extern "aapcs" fn` ABI][37814]
6134 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6135 * [The `format!` expander recognizes incorrect `printf` and shell-style
6136   formatting directives and suggests the correct format][37613].
6137 * [Only report one error for all unused imports in an import list][37456]
6138
6139 Compiler Performance
6140 --------------------
6141
6142 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6143 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6144 * [Don't clone in `UnificationTable::probe`][37848]
6145 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6146 * [Use small vectors in type walker][37760]
6147 * [Macro expansion performance was improved][37701]
6148 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6149 * [Replace FNV with a faster hash function][37229]
6150
6151 Stabilized APIs
6152 ---------------
6153
6154 * [`std::iter::Iterator::min_by`]
6155 * [`std::iter::Iterator::max_by`]
6156 * [`std::os::*::fs::FileExt`]
6157 * [`std::sync::atomic::Atomic*::get_mut`]
6158 * [`std::sync::atomic::Atomic*::into_inner`]
6159 * [`std::vec::IntoIter::as_slice`]
6160 * [`std::vec::IntoIter::as_mut_slice`]
6161 * [`std::sync::mpsc::Receiver::try_iter`]
6162 * [`std::os::unix::process::CommandExt::before_exec`]
6163 * [`std::rc::Rc::strong_count`]
6164 * [`std::rc::Rc::weak_count`]
6165 * [`std::sync::Arc::strong_count`]
6166 * [`std::sync::Arc::weak_count`]
6167 * [`std::char::encode_utf8`]
6168 * [`std::char::encode_utf16`]
6169 * [`std::cell::Ref::clone`]
6170 * [`std::io::Take::into_inner`]
6171
6172 Libraries
6173 ---------
6174
6175 * [The standard sorting algorithm has been rewritten for dramatic performance
6176   improvements][38192]. It is a hybrid merge sort, drawing influences from
6177   Timsort. Previously it was a naive merge sort.
6178 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6179 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6180   performance.
6181 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6182   and `char_indices().last()`][37882]
6183 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6184 * [Chinese characters display correctly in `fmt::Debug`][37855]
6185 * [Derive `Default` for `Duration`][37699]
6186 * [Support creation of anonymous pipes on WinXP/2k][37677]
6187 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6188 * [Don't pass overlapped handles to processes][38835]
6189
6190 Cargo
6191 -----
6192
6193 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6194   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6195   should instead check the variable at runtime with `std::env`. That the value
6196   was set at build time was a bug, and incorrect when cross-compiling. This
6197   change is known to cause breakage.
6198 * [Add `--all` flag to `cargo test`][cargo/3221]
6199 * [Compile statically against the MSVC CRT][cargo/3363]
6200 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6201 * [Link OpenSSL statically on OSX][cargo/3311]
6202 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6203 * [Test for bad path overrides with summaries][cargo/3336]
6204 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6205 * [Fix retrying crate downloads for network errors][cargo/3348]
6206 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6207 * [Emit more info on --message-format=json][cargo/3319]
6208 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6209 * [Don't ignore errors in workspace manifest][cargo/3409]
6210 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6211
6212 Tooling
6213 -------
6214
6215 * [Test runners (binaries built with `--test`) now support a `--list` argument
6216   that lists the tests it contains][38185]
6217 * [Test runners now support a `--exact` argument that makes the test filter
6218   match exactly, instead of matching only a substring of the test name][38181]
6219 * [rustdoc supports a `--playground-url` flag][37763]
6220 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6221
6222 Misc
6223 ----
6224
6225 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6226   continue to be used in this release by passing `--disable-rustbuild` to the
6227   configure script, but they will be deleted soon. Note that the new build
6228   system uses a different on-disk layout that will likely affect any scripts
6229   building Rust.
6230 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6231   releases.
6232 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6233 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6234   releases.
6235
6236 Compatibility Notes
6237 -------------------
6238
6239 * [A number of minor changes to name resolution have been activated][37127].
6240   They add up to more consistent semantics, allowing for future evolution of
6241   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6242   details of what is different. The breaking changes here have been transitioned
6243   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6244 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6245   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6246   should instead check the variable at runtime with `std::env`. That the value
6247   was set at build time was a bug, and incorrect when cross-compiling. This
6248   change is known to cause breakage.
6249 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6250   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6251   1.10 and is now an error by default. It will become a hard error in the near
6252   future.
6253 * [The semantics relating modules to file system directories are changing in
6254   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6255   lint, which is a warning in this release, and will become a hard error in the
6256   future.
6257 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6258 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6259   the underlying iterator][37834]
6260
6261 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6262 [33685]: https://github.com/rust-lang/rust/issues/33685
6263 [36868]: https://github.com/rust-lang/rust/pull/36868
6264 [37127]: https://github.com/rust-lang/rust/pull/37127
6265 [37229]: https://github.com/rust-lang/rust/pull/37229
6266 [37456]: https://github.com/rust-lang/rust/pull/37456
6267 [37527]: https://github.com/rust-lang/rust/pull/37527
6268 [37602]: https://github.com/rust-lang/rust/pull/37602
6269 [37613]: https://github.com/rust-lang/rust/pull/37613
6270 [37615]: https://github.com/rust-lang/rust/pull/37615
6271 [37636]: https://github.com/rust-lang/rust/pull/37636
6272 [37627]: https://github.com/rust-lang/rust/pull/37627
6273 [37642]: https://github.com/rust-lang/rust/pull/37642
6274 [37677]: https://github.com/rust-lang/rust/pull/37677
6275 [37699]: https://github.com/rust-lang/rust/pull/37699
6276 [37701]: https://github.com/rust-lang/rust/pull/37701
6277 [37705]: https://github.com/rust-lang/rust/pull/37705
6278 [37749]: https://github.com/rust-lang/rust/pull/37749
6279 [37760]: https://github.com/rust-lang/rust/pull/37760
6280 [37763]: https://github.com/rust-lang/rust/pull/37763
6281 [37764]: https://github.com/rust-lang/rust/pull/37764
6282 [37789]: https://github.com/rust-lang/rust/pull/37789
6283 [37791]: https://github.com/rust-lang/rust/pull/37791
6284 [37814]: https://github.com/rust-lang/rust/pull/37814
6285 [37817]: https://github.com/rust-lang/rust/pull/37817
6286 [37834]: https://github.com/rust-lang/rust/pull/37834
6287 [37848]: https://github.com/rust-lang/rust/pull/37848
6288 [37855]: https://github.com/rust-lang/rust/pull/37855
6289 [37882]: https://github.com/rust-lang/rust/pull/37882
6290 [37888]: https://github.com/rust-lang/rust/pull/37888
6291 [37973]: https://github.com/rust-lang/rust/pull/37973
6292 [37979]: https://github.com/rust-lang/rust/pull/37979
6293 [38086]: https://github.com/rust-lang/rust/pull/38086
6294 [38107]: https://github.com/rust-lang/rust/pull/38107
6295 [38117]: https://github.com/rust-lang/rust/pull/38117
6296 [38134]: https://github.com/rust-lang/rust/pull/38134
6297 [38146]: https://github.com/rust-lang/rust/pull/38146
6298 [38181]: https://github.com/rust-lang/rust/pull/38181
6299 [38182]: https://github.com/rust-lang/rust/pull/38182
6300 [38185]: https://github.com/rust-lang/rust/pull/38185
6301 [38192]: https://github.com/rust-lang/rust/pull/38192
6302 [38279]: https://github.com/rust-lang/rust/pull/38279
6303 [38835]: https://github.com/rust-lang/rust/pull/38835
6304 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6305 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6306 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6307 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6308 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6309 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6310 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6311 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6312 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6313 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6314 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6315 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6316 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6317 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6318 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6319 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6320 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6321 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6322 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6323 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6324 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6325 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6326 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6327 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6328 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6329 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6330 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6331 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6332 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6333 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6334 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6335 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6336 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6337 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6338 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6339 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6340 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6341 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6342
6343
6344 Version 1.14.0 (2016-12-22)
6345 ===========================
6346
6347 Language
6348 --------
6349
6350 * [`..` matches multiple tuple fields in enum variants, structs
6351   and tuples][36843]. [RFC 1492].
6352 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6353 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6354 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6355   dereferencing][36822]
6356
6357 Compiler
6358 --------
6359
6360 * [Mark enums with non-zero discriminant as non-zero][37224]
6361 * [Lower-case `static mut` names are linted like other
6362   statics and consts][37162]
6363 * [Fix ICE on some macros in const integer positions
6364    (e.g. `[u8; m!()]`)][36819]
6365 * [Improve error message and snippet for "did you mean `x`"][36798]
6366 * [Add a panic-strategy field to the target specification][36794]
6367 * [Include LLVM version in `--version --verbose`][37200]
6368
6369 Compile-time Optimizations
6370 --------------------------
6371
6372 * [Improve macro expansion performance][37569]
6373 * [Shrink `Expr_::ExprInlineAsm`][37445]
6374 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6375 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6376 * [Avoid more allocations when compiling html5ever][37373]
6377 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6378 * [Avoid some allocations in the macro parser][37318]
6379 * [Use a faster deflate setting][37298]
6380 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6381   during interning of slices][37270]
6382 * [Optimize `write_metadata`][37267]
6383 * [Don't process obligation forest cycles when stalled][37231]
6384 * [Avoid many `CrateConfig` clones][37161]
6385 * [Optimize `Substs::super_fold_with`][37108]
6386 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6387 * [Speed up `plug_leaks`][36917]
6388
6389 Libraries
6390 ---------
6391
6392 * [`println!()`, with no arguments, prints newline][36825].
6393   Previously, an empty string was required to achieve the same.
6394 * [`Wrapping` impls standard binary and unary operators, as well as
6395    the `Sum` and `Product` iterators][37356]
6396 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6397   Vec<T>`][37326]
6398 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6399   `VecDeque` iterators][37315]
6400 * [Improve `SipHasher` performance on small values][37312]
6401 * [Add Iterator trait TrustedLen to enable better FromIterator /
6402   Extend][37306]
6403 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6404 * [`ReadDir` implements `Debug`][37221]
6405 * [Implement `RefUnwindSafe` for atomic types][37178]
6406 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6407 * [Avoid allocations in `Decoder::read_str`][37064]
6408 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6409 * [Impl `Debug` for raw pointers to unsized data][36880]
6410 * [Don't reuse `HashMap` random seeds][37470]
6411 * [The internal memory layout of `HashMap` is more cache-friendly, for
6412   significant improvements in some operations][36692]
6413 * [`HashMap` uses less memory on 32-bit architectures][36595]
6414 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6415
6416 Cargo
6417 -----
6418
6419 * [Expose rustc cfg values to build scripts][cargo/3243]
6420 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6421 * [Fix passing --features when testing multiple packages][cargo/3280]
6422 * [Use a single profile set per workspace][cargo/3249]
6423 * [Load `replace` sections from lock files][cargo/3220]
6424 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6425
6426 Tooling
6427 -------
6428
6429 * [rustup is the recommended Rust installation method][1.14rustup]
6430 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6431   S390x. These are [tier 2] platforms and may have major defects. Follow the
6432   instructions on the website to install, or add the targets to an existing
6433   installation with `rustup target add`. The new target triples are:
6434   - `mips-unknown-linux-gnu`
6435   - `mipsel-unknown-linux-gnu`
6436   - `mips64-unknown-linux-gnuabi64`
6437   - `mips64el-unknown-linux-gnuabi64 `
6438   - `powerpc-unknown-linux-gnu`
6439   - `powerpc64-unknown-linux-gnu`
6440   - `powerpc64le-unknown-linux-gnu`
6441   - `s390x-unknown-linux-gnu `
6442 * This release includes target (std) builds for ARM Linux running MUSL
6443   libc. These are [tier 2] platforms and may have major defects. Add the
6444   following triples to an existing rustup installation with `rustup target add`:
6445   - `arm-unknown-linux-musleabi`
6446   - `arm-unknown-linux-musleabihf`
6447   - `armv7-unknown-linux-musleabihf`
6448 * This release includes [experimental support for WebAssembly][1.14wasm], via
6449   the `wasm32-unknown-emscripten` target. This target is known to have major
6450   defects. Please test, report, and fix.
6451 * rustup no longer installs documentation by default. Run `rustup
6452   component add rust-docs` to install.
6453 * [Fix line stepping in debugger][37310]
6454 * [Enable line number debuginfo in releases][37280]
6455
6456 Misc
6457 ----
6458
6459 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6460 * [Add support for Fuchsia OS][37313]
6461 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6462
6463 Compatibility Notes
6464 -------------------
6465
6466 * [A number of forward-compatibility lints used by the compiler
6467   to gradually introduce language changes have been converted
6468   to deny by default][36894]:
6469   - ["use of inaccessible extern crate erroneously allowed"][36886]
6470   - ["type parameter default erroneously allowed in invalid location"][36887]
6471   - ["detects super or self keywords at the beginning of global path"][36888]
6472   - ["two overlapping inherent impls define an item with the same name
6473     were erroneously allowed"][36889]
6474   - ["floating-point constants cannot be used in patterns"][36890]
6475   - ["constants of struct or enum type can only be used in a pattern if
6476      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6477   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6478 * [Prohibit patterns in trait methods without bodies][37378]
6479 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6480 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6481 * [The `$crate` macro variable is accepted in fewer locations][37213]
6482 * [Impls specifying extra region requirements beyond the trait
6483   they implement are rejected][37167]
6484 * [Enums may not be unsized][37111]. Unsized enums are intended to
6485   work but never have. For now they are forbidden.
6486 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6487
6488 [tier 2]: https://forge.rust-lang.org/platform-support.html
6489 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6490 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6491 [36430]: https://github.com/rust-lang/rust/pull/36430
6492 [36595]: https://github.com/rust-lang/rust/pull/36595
6493 [36595]: https://github.com/rust-lang/rust/pull/36595
6494 [36692]: https://github.com/rust-lang/rust/pull/36692
6495 [36767]: https://github.com/rust-lang/rust/pull/36767
6496 [36794]: https://github.com/rust-lang/rust/pull/36794
6497 [36798]: https://github.com/rust-lang/rust/pull/36798
6498 [36819]: https://github.com/rust-lang/rust/pull/36819
6499 [36822]: https://github.com/rust-lang/rust/pull/36822
6500 [36825]: https://github.com/rust-lang/rust/pull/36825
6501 [36843]: https://github.com/rust-lang/rust/pull/36843
6502 [36880]: https://github.com/rust-lang/rust/pull/36880
6503 [36886]: https://github.com/rust-lang/rust/issues/36886
6504 [36887]: https://github.com/rust-lang/rust/issues/36887
6505 [36888]: https://github.com/rust-lang/rust/issues/36888
6506 [36889]: https://github.com/rust-lang/rust/issues/36889
6507 [36890]: https://github.com/rust-lang/rust/issues/36890
6508 [36891]: https://github.com/rust-lang/rust/issues/36891
6509 [36892]: https://github.com/rust-lang/rust/issues/36892
6510 [36894]: https://github.com/rust-lang/rust/pull/36894
6511 [36917]: https://github.com/rust-lang/rust/pull/36917
6512 [36993]: https://github.com/rust-lang/rust/pull/36993
6513 [37037]: https://github.com/rust-lang/rust/pull/37037
6514 [37064]: https://github.com/rust-lang/rust/pull/37064
6515 [37094]: https://github.com/rust-lang/rust/pull/37094
6516 [37108]: https://github.com/rust-lang/rust/pull/37108
6517 [37111]: https://github.com/rust-lang/rust/pull/37111
6518 [37161]: https://github.com/rust-lang/rust/pull/37161
6519 [37162]: https://github.com/rust-lang/rust/pull/37162
6520 [37167]: https://github.com/rust-lang/rust/pull/37167
6521 [37178]: https://github.com/rust-lang/rust/pull/37178
6522 [37200]: https://github.com/rust-lang/rust/pull/37200
6523 [37213]: https://github.com/rust-lang/rust/pull/37213
6524 [37221]: https://github.com/rust-lang/rust/pull/37221
6525 [37224]: https://github.com/rust-lang/rust/pull/37224
6526 [37230]: https://github.com/rust-lang/rust/pull/37230
6527 [37231]: https://github.com/rust-lang/rust/pull/37231
6528 [37247]: https://github.com/rust-lang/rust/pull/37247
6529 [37267]: https://github.com/rust-lang/rust/pull/37267
6530 [37270]: https://github.com/rust-lang/rust/pull/37270
6531 [37273]: https://github.com/rust-lang/rust/pull/37273
6532 [37280]: https://github.com/rust-lang/rust/pull/37280
6533 [37298]: https://github.com/rust-lang/rust/pull/37298
6534 [37306]: https://github.com/rust-lang/rust/pull/37306
6535 [37310]: https://github.com/rust-lang/rust/pull/37310
6536 [37312]: https://github.com/rust-lang/rust/pull/37312
6537 [37313]: https://github.com/rust-lang/rust/pull/37313
6538 [37315]: https://github.com/rust-lang/rust/pull/37315
6539 [37318]: https://github.com/rust-lang/rust/pull/37318
6540 [37322]: https://github.com/rust-lang/rust/pull/37322
6541 [37326]: https://github.com/rust-lang/rust/pull/37326
6542 [37351]: https://github.com/rust-lang/rust/pull/37351
6543 [37356]: https://github.com/rust-lang/rust/pull/37356
6544 [37367]: https://github.com/rust-lang/rust/pull/37367
6545 [37373]: https://github.com/rust-lang/rust/pull/37373
6546 [37378]: https://github.com/rust-lang/rust/pull/37378
6547 [37389]: https://github.com/rust-lang/rust/pull/37389
6548 [37392]: https://github.com/rust-lang/rust/pull/37392
6549 [37427]: https://github.com/rust-lang/rust/pull/37427
6550 [37439]: https://github.com/rust-lang/rust/pull/37439
6551 [37445]: https://github.com/rust-lang/rust/pull/37445
6552 [37470]: https://github.com/rust-lang/rust/pull/37470
6553 [37569]: https://github.com/rust-lang/rust/pull/37569
6554 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6555 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6556 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6557 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6558 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6559 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6560 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6561
6562
6563 Version 1.13.0 (2016-11-10)
6564 ===========================
6565
6566 Language
6567 --------
6568
6569 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6570   errors, like the `try!` macro, described in [RFC 0243].
6571 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6572 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6573 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6574 * [Fix lifetime rules for 'if' conditions][36029]
6575 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6576
6577 Compiler
6578 --------
6579
6580 * [Add the `-C link-arg` argument][36574]
6581 * [Remove the old AST-based backend from rustc_trans][35764]
6582 * [Don't enable NEON by default on armv7 Linux][35814]
6583 * [Fix debug line number info for macro expansions][35238]
6584 * [Do not emit "class method" debuginfo for types that are not
6585   DICompositeType][36008]
6586 * [Warn about multiple conflicting #[repr] hints][34623]
6587 * [When sizing DST, don't double-count nested struct prefixes][36351]
6588 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6589 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6590 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6591 * [Expand macros without recursing to avoid stack overflows][36214]
6592
6593 Diagnostics
6594 -----------
6595
6596 * [Replace macro backtraces with labeled local uses][35702]
6597 * [Improve error message for misplaced doc comments][33922]
6598 * [Buffer unix and lock windows to prevent message interleaving][35975]
6599 * [Update lifetime errors to specifically note temporaries][36171]
6600 * [Special case a few colors for Windows][36178]
6601 * [Suggest `use self` when such an import resolves][36289]
6602 * [Be more specific when type parameter shadows primitive type][36338]
6603 * Many minor improvements
6604
6605 Compile-time Optimizations
6606 --------------------------
6607
6608 * [Compute and cache HIR hashes at beginning][35854]
6609 * [Don't hash types in loan paths][36004]
6610 * [Cache projections in trans][35761]
6611 * [Optimize the parser's last token handling][36527]
6612 * [Only instantiate #[inline] functions in codegen units referencing
6613   them][36524]. This leads to big improvements in cases where crates export
6614   define many inline functions without using them directly.
6615 * [Lazily allocate TypedArena's first chunk][36592]
6616 * [Don't allocate during default HashSet creation][36734]
6617
6618 Stabilized APIs
6619 ---------------
6620
6621 * [`checked_abs`]
6622 * [`wrapping_abs`]
6623 * [`overflowing_abs`]
6624 * [`RefCell::try_borrow`]
6625 * [`RefCell::try_borrow_mut`]
6626
6627 Libraries
6628 ---------
6629
6630 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6631 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6632   covariant][35354]
6633 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6634 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6635 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6636 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6637 * [Use arc4rand on FreeBSD][35884]
6638 * [memrchr: Correct aligned offset computation][35969]
6639 * [Improve Demangling of Rust Symbols][36059]
6640 * [Use monotonic time in condition variables][35048]
6641 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6642 * [Implement conversion traits for `char`][35755]
6643 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6644 * [Zero first byte of CString on drop][36264]
6645 * [Inherit overflow checks for sum and product][36372]
6646 * [Add missing Eq implementations][36423]
6647 * [Implement `Debug` for `DirEntry`][36631]
6648 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6649   `errno`][36754]
6650 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6651 * [Implement more traits for `std::io::ErrorKind`][35911]
6652 * [Optimize BinaryHeap bounds checking][36072]
6653 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6654   `extend_with_element`][36355]
6655 * [Fix overflow checking in unsigned pow()][34942]
6656
6657 Cargo
6658 -----
6659
6660 * This release includes security fixes to both curl and OpenSSL.
6661 * [Fix transitive doctests when panic=abort][cargo/3021]
6662 * [Add --all-features flag to cargo][cargo/3038]
6663 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6664 * [Don't parse the home directory more than once][cargo/3078]
6665 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6666 * [Update OpenSSL to 1.0.2j][cargo/3121]
6667 * [Add license and license_file to cargo metadata output][cargo/3110]
6668 * [Make crates-io registry URL optional in config; ignore all changes to
6669   source.crates-io][cargo/3089]
6670 * [Don't download dependencies from other platforms][cargo/3123]
6671 * [Build transitive dev-dependencies when needed][cargo/3125]
6672 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6673 * [Avoid updating registry when adding existing deps][cargo/3144]
6674 * [Warn about path overrides that won't work][cargo/3136]
6675 * [Use workspaces during `cargo install`][cargo/3146]
6676 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6677 * [Add --message-format flag][cargo/3000]
6678 * [Pass target environment for rustdoc][cargo/3205]
6679 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6680 * [Update curl and curl-sys][cargo/3241]
6681 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6682
6683 Tooling
6684 -------
6685
6686 * [rustdoc: Add the `--sysroot` argument][36586]
6687 * [rustdoc: Fix a couple of issues with the search results][35655]
6688 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6689 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6690 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6691
6692 Misc
6693 ----
6694
6695 * [Remove unmaintained style guide][35124]
6696 * [Add s390x support][36369]
6697 * [Initial work at Haiku OS support][36727]
6698 * [Add mips-uclibc targets][35734]
6699 * [Crate-ify compiler-rt into compiler-builtins][35021]
6700 * [Add rustc version info (git hash + date) to dist tarball][36213]
6701 * Many documentation improvements
6702
6703 Compatibility Notes
6704 -------------------
6705
6706 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6707 * [Deny (by default) transmuting from fn item types to pointer-sized
6708   types][34923]. Continuing the long transition to zero-sized fn items,
6709   per [RFC 401].
6710 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6711   Part of [RFC 1506].
6712 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6713 * [Fix lifetime rules for 'if' conditions][36029].
6714 * [Inherit overflow checks for sum and product][36372].
6715 * [Forbid user-defined macros named "macro_rules"][36730].
6716
6717 [33922]: https://github.com/rust-lang/rust/pull/33922
6718 [34623]: https://github.com/rust-lang/rust/pull/34623
6719 [34923]: https://github.com/rust-lang/rust/pull/34923
6720 [34942]: https://github.com/rust-lang/rust/pull/34942
6721 [34982]: https://github.com/rust-lang/rust/pull/34982
6722 [35021]: https://github.com/rust-lang/rust/pull/35021
6723 [35048]: https://github.com/rust-lang/rust/pull/35048
6724 [35074]: https://github.com/rust-lang/rust/pull/35074
6725 [35124]: https://github.com/rust-lang/rust/pull/35124
6726 [35234]: https://github.com/rust-lang/rust/pull/35234
6727 [35238]: https://github.com/rust-lang/rust/pull/35238
6728 [35354]: https://github.com/rust-lang/rust/pull/35354
6729 [35559]: https://github.com/rust-lang/rust/pull/35559
6730 [35585]: https://github.com/rust-lang/rust/pull/35585
6731 [35627]: https://github.com/rust-lang/rust/pull/35627
6732 [35655]: https://github.com/rust-lang/rust/pull/35655
6733 [35702]: https://github.com/rust-lang/rust/pull/35702
6734 [35707]: https://github.com/rust-lang/rust/pull/35707
6735 [35728]: https://github.com/rust-lang/rust/pull/35728
6736 [35734]: https://github.com/rust-lang/rust/pull/35734
6737 [35755]: https://github.com/rust-lang/rust/pull/35755
6738 [35761]: https://github.com/rust-lang/rust/pull/35761
6739 [35764]: https://github.com/rust-lang/rust/pull/35764
6740 [35814]: https://github.com/rust-lang/rust/pull/35814
6741 [35854]: https://github.com/rust-lang/rust/pull/35854
6742 [35871]: https://github.com/rust-lang/rust/pull/35871
6743 [35884]: https://github.com/rust-lang/rust/pull/35884
6744 [35911]: https://github.com/rust-lang/rust/pull/35911
6745 [35969]: https://github.com/rust-lang/rust/pull/35969
6746 [35975]: https://github.com/rust-lang/rust/pull/35975
6747 [36004]: https://github.com/rust-lang/rust/pull/36004
6748 [36008]: https://github.com/rust-lang/rust/pull/36008
6749 [36014]: https://github.com/rust-lang/rust/pull/36014
6750 [36029]: https://github.com/rust-lang/rust/pull/36029
6751 [36059]: https://github.com/rust-lang/rust/pull/36059
6752 [36072]: https://github.com/rust-lang/rust/pull/36072
6753 [36101]: https://github.com/rust-lang/rust/pull/36101
6754 [36104]: https://github.com/rust-lang/rust/pull/36104
6755 [36171]: https://github.com/rust-lang/rust/pull/36171
6756 [36173]: https://github.com/rust-lang/rust/pull/36173
6757 [36178]: https://github.com/rust-lang/rust/pull/36178
6758 [36213]: https://github.com/rust-lang/rust/pull/36213
6759 [36214]: https://github.com/rust-lang/rust/pull/36214
6760 [36264]: https://github.com/rust-lang/rust/pull/36264
6761 [36266]: https://github.com/rust-lang/rust/pull/36266
6762 [36289]: https://github.com/rust-lang/rust/pull/36289
6763 [36338]: https://github.com/rust-lang/rust/pull/36338
6764 [36351]: https://github.com/rust-lang/rust/pull/36351
6765 [36355]: https://github.com/rust-lang/rust/pull/36355
6766 [36369]: https://github.com/rust-lang/rust/pull/36369
6767 [36372]: https://github.com/rust-lang/rust/pull/36372
6768 [36423]: https://github.com/rust-lang/rust/pull/36423
6769 [36482]: https://github.com/rust-lang/rust/pull/36482
6770 [36505]: https://github.com/rust-lang/rust/pull/36505
6771 [36524]: https://github.com/rust-lang/rust/pull/36524
6772 [36527]: https://github.com/rust-lang/rust/pull/36527
6773 [36551]: https://github.com/rust-lang/rust/pull/36551
6774 [36574]: https://github.com/rust-lang/rust/pull/36574
6775 [36586]: https://github.com/rust-lang/rust/pull/36586
6776 [36592]: https://github.com/rust-lang/rust/pull/36592
6777 [36631]: https://github.com/rust-lang/rust/pull/36631
6778 [36639]: https://github.com/rust-lang/rust/pull/36639
6779 [36721]: https://github.com/rust-lang/rust/pull/36721
6780 [36727]: https://github.com/rust-lang/rust/pull/36727
6781 [36730]: https://github.com/rust-lang/rust/pull/36730
6782 [36734]: https://github.com/rust-lang/rust/pull/36734
6783 [36754]: https://github.com/rust-lang/rust/pull/36754
6784 [36995]: https://github.com/rust-lang/rust/pull/36995
6785 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6786 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6787 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6788 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6789 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6790 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6791 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6792 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6793 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6794 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6795 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6796 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6797 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6798 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6799 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6800 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6801 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6802 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6803 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6804 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6805 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6806 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6807 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6808 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6809 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6810 [rustup]: https://www.rustup.rs
6811 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6812 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6813 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6814 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6815 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6816 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6817 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6818
6819
6820 Version 1.12.1 (2016-10-20)
6821 ===========================
6822
6823 Regression Fixes
6824 ----------------
6825
6826 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6827 * [Confusion with double negation and booleans][36856]
6828 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6829 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6830 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6831 * [Corrupted memory after updated to 1.12][36936]
6832 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6833 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6834 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6835
6836 [36381]: https://github.com/rust-lang/rust/issues/36381
6837 [36856]: https://github.com/rust-lang/rust/issues/36856
6838 [36875]: https://github.com/rust-lang/rust/issues/36875
6839 [36924]: https://github.com/rust-lang/rust/issues/36924
6840 [36926]: https://github.com/rust-lang/rust/issues/36926
6841 [36936]: https://github.com/rust-lang/rust/issues/36936
6842 [37026]: https://github.com/rust-lang/rust/issues/37026
6843 [37112]: https://github.com/rust-lang/rust/issues/37112
6844 [37153]: https://github.com/rust-lang/rust/issues/37153
6845
6846
6847 Version 1.12.0 (2016-09-29)
6848 ===========================
6849
6850 Highlights
6851 ----------
6852
6853 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6854   This translation pass is far simpler than the previous AST->LLVM pass, and
6855   creates opportunities to perform new optimizations directly on the MIR. It
6856   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6857 * [`rustc` presents a new, more readable error format, along with
6858   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6859   Most common editors supporting Rust have been updated to work with it. It was
6860   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6861
6862 Compiler
6863 --------
6864
6865 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6866   This translation pass is far simpler than the previous AST->LLVM pass, and
6867   creates opportunities to perform new optimizations directly on the MIR. It
6868   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6869 * [Print the Rust target name, not the LLVM target name, with
6870   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6871 * [The computation of `TypeId` is correct in some cases where it was previously
6872   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6873 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6874 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6875   `--print relocation-models`, and `--print code-models` print the available
6876   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6877   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6878 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6879   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6880   These targets produce statically-linked binaries. There are no binary release
6881   builds yet though.
6882
6883 Diagnostics
6884 -----------
6885
6886 * [`rustc` presents a new, more readable error format, along with
6887   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6888   Most common editors supporting Rust have been updated to work with it. It was
6889   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6890 * [In error descriptions, references are now described in plain English,
6891   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6892 * [In error type descriptions, unknown numeric types are named `{integer}` or
6893   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6894 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6895
6896 Language
6897 --------
6898
6899 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6900 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6901 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6902   useful](https://github.com/rust-lang/rust/pull/34908)
6903 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6904   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6905 * [Semicolons are properly required as statement delimiters inside
6906   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6907 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6908
6909 Stabilized APIs
6910 ---------------
6911
6912 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6913 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6914 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6915 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6916 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6917 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6918 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6919 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6920 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6921 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6922   Both on Unix and Windows.
6923 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6924 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6925 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6926 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6927 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6928 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6929 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6930 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6931
6932 Libraries
6933 ---------
6934
6935 * [The `format!` macro and friends now allow a single argument to be formatted
6936   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6937 * [The lifetime bounds on `[T]::binary_search_by` and
6938   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6939 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6940 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6941 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6942 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6943 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6944 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6945 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6946 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6947   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6948 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6949   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6950 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6951 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6952   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6953 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6954 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6955 * [`mpsc::sync_channel` `Receiver`s return any available message before
6956   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6957 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6958 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6959
6960 Cargo
6961 -----
6962
6963 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6964 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6965 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6966 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6967 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6968 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6969 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6970 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6971 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6972 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6973 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6974 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6975 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6976 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6977 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6978 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6979
6980 Performance
6981 -----------
6982
6983 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6984 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6985
6986 Tooling
6987 -------
6988
6989 * [Test binaries now support a `--test-threads` argument to specify the number
6990   of threads used to run tests, and which acts the same as the
6991   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6992 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6993 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6994 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6995 * [Rust releases now come with source packages that can be installed by rustup
6996   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6997   The resulting source code can be used by tools and IDES, located in the
6998   sysroot under `lib/rustlib/src`.
6999
7000 Misc
7001 ----
7002
7003 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7004 * Many minor improvements to the documentation.
7005 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7006
7007 Compatibility Notes
7008 -------------------
7009
7010 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7011   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7012 * [When formatting strings, if "precision" is specified, the "fill",
7013   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7014 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7015
7016
7017 Version 1.11.0 (2016-08-18)
7018 ===========================
7019
7020 Language
7021 --------
7022
7023 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7024 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7025 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7026 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7027
7028 Stabilized APIs
7029 ---------------
7030
7031 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7032 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7033 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7034 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7035 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7036 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7037   (in libcore - previously stabilized in libstd)
7038 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7039   (in libcore - previously stabilized in libstd)
7040 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7041   (in libcore - previously stabilized in libstd)
7042 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7043   (in libcore - previously stabilized in libstd)
7044 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7045 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7046 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7047 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7048
7049 Libraries
7050 ---------
7051
7052 * [The `thread_local!` macro supports multiple definitions in a single
7053    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7054 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7055 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7056   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7057 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7058 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7059 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7060 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7061
7062 Cargo
7063 -----
7064
7065 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7066 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7067 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7068 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7069 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7070   and `-vv` prints warnings for all crates.
7071 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7072 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7073   This provides room for expansion by arbitrary tools.
7074 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7075 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7076 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7077 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7078 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7079 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7080 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7081
7082 Performance
7083 -----------
7084
7085 * [Caching projections speeds up type check dramatically for some
7086   workloads](https://github.com/rust-lang/rust/pull/33816)
7087 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7088   This hasher is faster, but is believed to provide sufficient
7089   protection from collision attacks.
7090 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7091
7092 Rustdoc
7093 -------
7094
7095 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7096 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7097 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7098 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7099 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7100
7101 Tooling
7102 -------
7103
7104 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7105 * [When emitting debug info, rustc emits frame pointers for closures,
7106   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7107 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7108 * Many more errors have been given error codes and extended
7109   explanations
7110 * API documentation continues to be improved, with many new examples
7111
7112 Misc
7113 ----
7114
7115 * [rustc no longer hangs when dependencies recursively re-export
7116   submodules](https://github.com/rust-lang/rust/pull/34542)
7117 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7118 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7119   rewritten](https://github.com/rust-lang/rust/pull/33895)
7120 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7121   No targets use this yet, but it works toward AVR support.
7122
7123 Compatibility Notes
7124 -------------------
7125
7126 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7127 * [The new follow-set rules that place restrictions on `macro_rules!`
7128   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7129   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7130   and has been a warning since 1.10.
7131 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7132   This causes breakage in some corner cases.
7133
7134
7135 Version 1.10.0 (2016-07-07)
7136 ===========================
7137
7138 Language
7139 --------
7140
7141 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7142   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7143 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7144 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7145 * [`panic!` can be converted to a runtime abort with the
7146   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7147   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7148 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7149   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7150   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7151   Note that Cargo does not yet directly support cdylibs.
7152
7153 Stabilized APIs
7154 ---------------
7155
7156 * `os::windows::fs::OpenOptionsExt::access_mode`
7157 * `os::windows::fs::OpenOptionsExt::share_mode`
7158 * `os::windows::fs::OpenOptionsExt::custom_flags`
7159 * `os::windows::fs::OpenOptionsExt::attributes`
7160 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7161 * `os::unix::fs::OpenOptionsExt::custom_flags`
7162 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7163 * `Default for sync::Weak`
7164 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7165 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7166 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7167 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7168 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7169 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7170 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7171 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7172 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7173 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7174 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7175 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7176 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7177 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7178 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7179 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7180 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7181 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7182 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7183 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7184 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7185 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7186 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7187 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7188 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7189 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7190 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7191 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7192 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7193 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7194 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7195 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7196 * Read/Write/RawFd impls for `UnixStream`
7197 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7198 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7199 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7200 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7201 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7202 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7203 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7204 * RawFd impls for `UnixListener`
7205 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7206 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7207 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7208 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7209 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7210 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7211 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7212 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7213 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7214 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7215 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7216 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7217 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7218 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7219 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7220 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7221 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7222 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7223 * RawFd impls for `UnixDatagram`
7224 * `{BTree,Hash}Map::values_mut`
7225 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7226
7227 Libraries
7228 ---------
7229
7230 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7231   The semantics of this minor method are subtle and probably not what
7232   most people want.
7233 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7234 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7235   will fall back to `/dev/urandom` temporarily to avoid blocking
7236   during early boot](https://github.com/rust-lang/rust/pull/33086).
7237 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7238 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7239 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7240 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7241 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7242 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7243   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7244
7245 Cargo
7246 -----
7247 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7248   This controls the runtime behavior of the `panic!` macro
7249   and can be either "unwind" (the default), or "abort".
7250   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7251 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7252 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7253 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7254   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7255 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7256 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7257 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7258   By default they are retried twice, which can be customized with the
7259   `net.retry` value in `.cargo/config`.
7260 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7261 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7262 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7263 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7264   Makes it possible to install multiple crates in parallel.
7265 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7266 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7267 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7268 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7269 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7270 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7271
7272 Performance
7273 -----------
7274
7275 * [rustc memory usage was reduced by refactoring the context used for
7276   type checking](https://github.com/rust-lang/rust/pull/33425).
7277 * [Speed up creation of `HashMap`s by caching the random keys used
7278   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7279 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7280 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7281 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7282   10x faster than the previous lookup tables.
7283 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7284
7285 Usability
7286 ---------
7287
7288 * Many incremental improvements to documentation and rustdoc.
7289 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7290 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7291 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7292 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7293 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7294 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7295 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7296
7297 Misc
7298 ----
7299
7300 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7301 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7302 * [`std` no longer prints backtraces on platforms where the running
7303   module must be loaded with `env::current_exe`, which can't be relied
7304   on](https://github.com/rust-lang/rust/pull/33554).
7305 * This release includes std binaries for the i586-unknown-linux-gnu,
7306   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7307   i586 target is for old x86 hardware without SSE2, and the armv7
7308   target is for Android running on modern ARM architectures.
7309 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7310   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7311 * [On Unix the runtime aborts by calling `libc::abort` instead of
7312   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7313 * [Rust is now bootstrapped from the previous release of Rust,
7314   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7315
7316 Compatibility Notes
7317 -------------------
7318
7319 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7320 * [`target_env` for Linux ARM targets is just `gnu`, not
7321   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7322 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7323 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7324 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7325   Affects how macros are parsed.
7326 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7327 * [Feature-gated attributes on macro-generated macro invocations are
7328   now rejected](https://github.com/rust-lang/rust/pull/32791).
7329 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7330   This caused some minor changes to type inference.
7331
7332
7333 Version 1.9.0 (2016-05-26)
7334 ==========================
7335
7336 Language
7337 --------
7338
7339 * The `#[deprecated]` attribute when applied to an API will generate
7340   warnings when used. The warnings may be suppressed with
7341   `#[allow(deprecated)]`. [RFC 1270].
7342 * [`fn` item types are zero sized, and each `fn` names a unique
7343   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7344   `transmute` on a `fn` type will generate a warning for a few cycles,
7345   then will be converted to an error.
7346 * [Field and method resolution understand visibility, so private
7347   fields and methods cannot prevent the proper use of public fields
7348   and methods][1.9fv].
7349 * [The parser considers unicode codepoints in the
7350   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7351
7352 Stabilized APIs
7353 ---------------
7354
7355 * [`std::panic`]
7356 * [`std::panic::catch_unwind`] (renamed from `recover`)
7357 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7358 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7359 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7360 * [`str::is_char_boundary`]
7361 * [`<*const T>::as_ref`]
7362 * [`<*mut T>::as_ref`]
7363 * [`<*mut T>::as_mut`]
7364 * [`AsciiExt::make_ascii_uppercase`]
7365 * [`AsciiExt::make_ascii_lowercase`]
7366 * [`char::decode_utf16`]
7367 * [`char::DecodeUtf16`]
7368 * [`char::DecodeUtf16Error`]
7369 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7370 * [`BTreeSet::take`]
7371 * [`BTreeSet::replace`]
7372 * [`BTreeSet::get`]
7373 * [`HashSet::take`]
7374 * [`HashSet::replace`]
7375 * [`HashSet::get`]
7376 * [`OsString::with_capacity`]
7377 * [`OsString::clear`]
7378 * [`OsString::capacity`]
7379 * [`OsString::reserve`]
7380 * [`OsString::reserve_exact`]
7381 * [`OsStr::is_empty`]
7382 * [`OsStr::len`]
7383 * [`std::os::unix::thread`]
7384 * [`RawPthread`]
7385 * [`JoinHandleExt`]
7386 * [`JoinHandleExt::as_pthread_t`]
7387 * [`JoinHandleExt::into_pthread_t`]
7388 * [`HashSet::hasher`]
7389 * [`HashMap::hasher`]
7390 * [`CommandExt::exec`]
7391 * [`File::try_clone`]
7392 * [`SocketAddr::set_ip`]
7393 * [`SocketAddr::set_port`]
7394 * [`SocketAddrV4::set_ip`]
7395 * [`SocketAddrV4::set_port`]
7396 * [`SocketAddrV6::set_ip`]
7397 * [`SocketAddrV6::set_port`]
7398 * [`SocketAddrV6::set_flowinfo`]
7399 * [`SocketAddrV6::set_scope_id`]
7400 * [`slice::copy_from_slice`]
7401 * [`ptr::read_volatile`]
7402 * [`ptr::write_volatile`]
7403 * [`OpenOptions::create_new`]
7404 * [`TcpStream::set_nodelay`]
7405 * [`TcpStream::nodelay`]
7406 * [`TcpStream::set_ttl`]
7407 * [`TcpStream::ttl`]
7408 * [`TcpStream::set_only_v6`]
7409 * [`TcpStream::only_v6`]
7410 * [`TcpStream::take_error`]
7411 * [`TcpStream::set_nonblocking`]
7412 * [`TcpListener::set_ttl`]
7413 * [`TcpListener::ttl`]
7414 * [`TcpListener::set_only_v6`]
7415 * [`TcpListener::only_v6`]
7416 * [`TcpListener::take_error`]
7417 * [`TcpListener::set_nonblocking`]
7418 * [`UdpSocket::set_broadcast`]
7419 * [`UdpSocket::broadcast`]
7420 * [`UdpSocket::set_multicast_loop_v4`]
7421 * [`UdpSocket::multicast_loop_v4`]
7422 * [`UdpSocket::set_multicast_ttl_v4`]
7423 * [`UdpSocket::multicast_ttl_v4`]
7424 * [`UdpSocket::set_multicast_loop_v6`]
7425 * [`UdpSocket::multicast_loop_v6`]
7426 * [`UdpSocket::set_multicast_ttl_v6`]
7427 * [`UdpSocket::multicast_ttl_v6`]
7428 * [`UdpSocket::set_ttl`]
7429 * [`UdpSocket::ttl`]
7430 * [`UdpSocket::set_only_v6`]
7431 * [`UdpSocket::only_v6`]
7432 * [`UdpSocket::join_multicast_v4`]
7433 * [`UdpSocket::join_multicast_v6`]
7434 * [`UdpSocket::leave_multicast_v4`]
7435 * [`UdpSocket::leave_multicast_v6`]
7436 * [`UdpSocket::take_error`]
7437 * [`UdpSocket::connect`]
7438 * [`UdpSocket::send`]
7439 * [`UdpSocket::recv`]
7440 * [`UdpSocket::set_nonblocking`]
7441
7442 Libraries
7443 ---------
7444
7445 * [`std::sync::Once` is poisoned if its initialization function
7446   fails][1.9o].
7447 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7448 * [Most types implement `fmt::Debug`][1.9db].
7449 * [The default buffer size used by `BufReader` and `BufWriter` was
7450   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7451   used by other languages.
7452 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7453   `Duration` additionally implements `*=` and `/=`][1.9ta].
7454 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7455 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7456 * [`Chain` implements `BufRead`][1.9ch].
7457 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7458
7459 Cargo
7460 -----
7461
7462 * [Cargo can now run concurrently][1.9cc].
7463 * [Top-level overrides allow specific revisions of crates to be
7464   overridden through the entire crate graph][1.9ct].  This is intended
7465   to make upgrades easier for large projects, by allowing crates to be
7466   forked temporarily until they've been upgraded and republished.
7467 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7468 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7469   on the commandline][1.9cf]. `rustc` arguments can also be specified
7470   in the `build.rustflags` configuration key.
7471
7472 Performance
7473 -----------
7474
7475 * [The time complexity of comparing variables for equivalence during type
7476   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7477   to major compilation time improvement in some scenarios.
7478 * [`ToString` is specialized for `str`, giving it the same performance
7479   as `to_owned`][1.9ts].
7480 * [Spawning processes with `Command::output` no longer creates extra
7481   threads][1.9sp].
7482 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7483   for C-like enums][1.9cl].
7484
7485 Misc
7486 ----
7487
7488 * [Passing the `--quiet` flag to a test runner will produce
7489   much-abbreviated output][1.9q].
7490 * The Rust Project now publishes std binaries for the
7491   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7492   `i586-pc-windows-msvc` targets.
7493
7494 Compatibility Notes
7495 -------------------
7496
7497 * [`std::sync::Once` is poisoned if its initialization function
7498   fails][1.9o].
7499 * [It is illegal to define methods with the same name in overlapping
7500   inherent `impl` blocks][1.9sn].
7501 * [`fn` item types are zero sized, and each `fn` names a unique
7502   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7503   `transmute` on a `fn` type will generate a warning for a few cycles,
7504   then will be converted to an error.
7505 * [Improvements to const evaluation may trigger new errors when integer
7506   literals are out of range][1.9ce].
7507
7508
7509 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7510 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7511 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7512 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7513 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7514 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7515 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7516 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7517 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7518 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7519 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7520 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7521 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7522 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7523 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7524 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7525 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7526 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7527 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7528 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7529 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7530 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7531 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7532 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7533 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7534 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7535 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7536 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7537 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7538 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7539 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7540 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7541 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7542 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7543 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7544 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7545 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7546 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7547 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7548 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7549 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7550 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7551 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7552 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7553 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7554 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7555 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7556 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7557 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7558 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7559 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7560 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7561 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7562 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7563 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7564 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7565 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7566 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7567 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7568 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7569 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7570 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7571 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7572 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7573 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7574 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7575 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7576 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7577 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7578 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7579 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7580 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7581 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7582 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7583 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7584 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7585 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7586 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7587 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7588 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7589 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7590 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7591 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7592 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7593 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7594 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7595 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7596 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7597 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7598 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7599 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7600 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7601 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7602 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7603 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7604 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7605 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7606 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7607 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7608 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7609 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7610 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7611 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7612 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7613 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7614 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7615 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7616 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7617 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7618 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7619
7620
7621 Version 1.8.0 (2016-04-14)
7622 ==========================
7623
7624 Language
7625 --------
7626
7627 * Rust supports overloading of compound assignment statements like
7628   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7629   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7630   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7631   traits. [RFC 953].
7632 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7633   addition to the non-braced form, `struct Foo;`. [RFC 218].
7634
7635 Libraries
7636 ---------
7637
7638 * Stabilized APIs:
7639   * [`str::encode_utf16`] (renamed from `utf16_units`)
7640   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7641   * [`Ref::map`]
7642   * [`RefMut::map`]
7643   * [`ptr::drop_in_place`]
7644   * [`time::Instant`]
7645   * [`time::SystemTime`]
7646   * [`Instant::now`]
7647   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7648   * [`Instant::elapsed`]
7649   * [`SystemTime::now`]
7650   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7651   * [`SystemTime::elapsed`]
7652   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7653   * [`SystemTimeError`]
7654   * [`SystemTimeError::duration`]
7655   * Various impls for `SystemTimeError`
7656   * [`UNIX_EPOCH`]
7657   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7658     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7659     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7660 * [The `write!` and `writeln!` macros correctly emit errors if any of
7661   their arguments can't be formatted][1.8w].
7662 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7663 * [The Unix-specific `raw` modules, which contain a number of
7664   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7665   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7666   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7667   across platforms was making it difficult to implement `std`
7668   correctly. Those that need these definitions should use the `libc`
7669   crate. [RFC 1415].
7670 * The Unix-specific `MetadataExt` traits, including
7671   `os::unix::fs::MetadataExt`, which expose values such as inode
7672   numbers [no longer return platform-specific types][1.8r], but
7673   instead return widened integers. [RFC 1415].
7674 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7675 * [Atomic loads and stores are not volatile][1.8a].
7676 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7677
7678 Performance
7679 -----------
7680
7681 * [Inlining hash functions lead to a 3% compile-time improvement in
7682   some workloads][1.8h].
7683 * When using jemalloc, its symbols are [unprefixed so that it
7684   overrides the libc malloc implementation][1.8h]. This means that for
7685   rustc, LLVM is now using jemalloc, which results in a 6%
7686   compile-time improvement on a specific workload.
7687 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7688
7689 Misc
7690 ----
7691
7692 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7693   i686-pc-windows-msvc is now considered a tier-1 platform.
7694 * [The `--print targets` flag prints a list of supported targets][1.8t].
7695 * [The `--print cfg` flag prints the `cfg`s defined for the current
7696   target][1.8cf].
7697 * [`rustc` can be built with an new Cargo-based build system, written
7698   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7699   build system. To enable it configure with `configure --rustbuild`.
7700 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7701   variants while also indicating the total number of missing variants
7702   if more than 3][1.8m].
7703 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7704 * The Rust Project now publishes binary releases of the standard
7705   library for a number of tier-2 targets:
7706   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7707   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7708   `x86_64-rumprun-netbsd`. These can be installed with
7709   tools such as [multirust][1.8mr].
7710
7711 Cargo
7712 -----
7713
7714 * [`cargo init` creates a new Cargo project in the current
7715   directory][1.8ci].  It is otherwise like `cargo new`.
7716 * [Cargo has configuration keys for `-v` and
7717   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7718   `[term]` section of `.cargo/config`.
7719 * [Configuration keys that evaluate to strings or integers can be set
7720   via environment variables][1.8ce]. For example the `build.jobs` key
7721   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7722   precedence over config files.
7723 * [Target-specific dependencies support Rust `cfg` syntax for
7724   describing targets][1.8cfg] so that dependencies for multiple
7725   targets can be specified together. [RFC 1361].
7726 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7727   `RUSTDOC` take precedence over the `build.target-dir`,
7728   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7729 * [The child process tree is killed on Windows when Cargo is
7730   killed][1.8ck].
7731 * [The `build.target` configuration value sets the target platform,
7732   like `--target`][1.8ct].
7733
7734 Compatibility Notes
7735 -------------------
7736
7737 * [Unstable compiler flags have been further restricted][1.8u]. Since
7738   1.0 `-Z` flags have been considered unstable, and other flags that
7739   were considered unstable additionally required passing `-Z
7740   unstable-options` to access. Unlike unstable language and library
7741   features though, these options have been accessible on the stable
7742   release channel. Going forward, *new unstable flags will not be
7743   available on the stable release channel*, and old unstable flags
7744   will warn about their usage. In the future, all unstable flags will
7745   be unavailable on the stable release channel.
7746 * [It is no longer possible to `match` on empty enum variants using
7747   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7748 * The Unix-specific `MetadataExt` traits, including
7749   `os::unix::fs::MetadataExt`, which expose values such as inode
7750   numbers [no longer return platform-specific types][1.8r], but
7751   instead return widened integers. [RFC 1415].
7752 * [Modules sourced from the filesystem cannot appear within arbitrary
7753   blocks, but only within other modules][1.8mf].
7754 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7755 * On Unix, [stack overflow triggers a runtime abort instead of a
7756   SIGSEGV][1.8so].
7757 * [`Command::spawn` and its equivalents return an error if any of
7758   its command-line arguments contain interior `NUL`s][1.8n].
7759 * [Tuple and unit enum variants from other crates are in the type
7760   namespace][1.8tn].
7761 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7762   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7763   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7764   instead of `foo.lib`.
7765
7766
7767 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7768 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7769 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7770 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7771 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7772 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7773 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7774 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7775 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7776 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7777 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7778 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7779 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7780 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7781 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7782 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7783 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7784 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7785 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7786 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7787 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7788 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7789 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7790 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7791 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7792 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7793 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7794 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7795 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7796 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7797 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7798 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7799 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7800 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7801 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7802 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7803 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7804 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7805 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7806 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7807 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7808 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7809 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7810 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7811 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7812 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7813 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7814 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7815 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7816 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7817 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7818 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7819 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7820 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7821 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7822 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7823 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7824 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7825 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7826 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7827
7828
7829 Version 1.7.0 (2016-03-03)
7830 ==========================
7831
7832 Libraries
7833 ---------
7834
7835 * Stabilized APIs
7836   * `Path`
7837     * [`Path::strip_prefix`] (renamed from relative_from)
7838     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7839   * `Ipv4Addr`
7840     * [`Ipv4Addr::is_loopback`]
7841     * [`Ipv4Addr::is_private`]
7842     * [`Ipv4Addr::is_link_local`]
7843     * [`Ipv4Addr::is_multicast`]
7844     * [`Ipv4Addr::is_broadcast`]
7845     * [`Ipv4Addr::is_documentation`]
7846   * `Ipv6Addr`
7847     * [`Ipv6Addr::is_unspecified`]
7848     * [`Ipv6Addr::is_loopback`]
7849     * [`Ipv6Addr::is_multicast`]
7850   * `Vec`
7851     * [`Vec::as_slice`]
7852     * [`Vec::as_mut_slice`]
7853   * `String`
7854     * [`String::as_str`]
7855     * [`String::as_mut_str`]
7856   * Slices
7857     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7858     be the same length
7859     * `<[T]>::`[`sort_by_key`]
7860   * checked, saturated, and overflowing operations
7861     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7862     * [`i32::saturating_mul`]
7863     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7864     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7865     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7866     * [`u32::saturating_mul`]
7867     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7868     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7869     * and checked, saturated, and overflowing operations for other primitive types
7870   * FFI
7871     * [`ffi::IntoStringError`]
7872     * [`CString::into_string`]
7873     * [`CString::into_bytes`]
7874     * [`CString::into_bytes_with_nul`]
7875     * `From<CString> for Vec<u8>`
7876   * `IntoStringError`
7877     * [`IntoStringError::into_cstring`]
7878     * [`IntoStringError::utf8_error`]
7879     * `Error for IntoStringError`
7880   * Hashing
7881     * [`std::hash::BuildHasher`]
7882     * [`BuildHasher::Hasher`]
7883     * [`BuildHasher::build_hasher`]
7884     * [`std::hash::BuildHasherDefault`]
7885     * [`HashMap::with_hasher`]
7886     * [`HashMap::with_capacity_and_hasher`]
7887     * [`HashSet::with_hasher`]
7888     * [`HashSet::with_capacity_and_hasher`]
7889     * [`std::collections::hash_map::RandomState`]
7890     * [`RandomState::new`]
7891 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7892   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7893   from bytes is faster.
7894 * [The performance of `LineWriter` (and thus `io::stdout`) was
7895   improved by using `memchr` to search for newlines][1.7m].
7896 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7897   `f64` variants were stabilized previously.
7898 * [`BTreeMap` was rewritten to use less memory and improve the performance
7899   of insertion and iteration, the latter by as much as 5x][1.7bm].
7900 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7901   covariant over their contained type][1.7bt].
7902 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7903   over their contained type][1.7ll].
7904 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7905   searching methods.
7906 * [`Any` is implemented for unsized types][1.7a].
7907 * [`Hash` is implemented for `Duration`][1.7h].
7908
7909 Misc
7910 ----
7911
7912 * [When running tests with `--test`, rustdoc will pass `--cfg`
7913   arguments to the compiler][1.7dt].
7914 * [The compiler is built with RPATH information by default][1.7rpa].
7915   This means that it will be possible to run `rustc` when installed in
7916   unusual configurations without configuring the dynamic linker search
7917   path explicitly.
7918 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7919   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7920   over `LD_LIBRARY_PATH`.
7921
7922 Cargo
7923 -----
7924
7925 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7926   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7927 * [The `rerun-if-changed` build script directive no longer causes the
7928   build script to incorrectly run twice in certain scenarios][1.7rr].
7929
7930 Compatibility Notes
7931 -------------------
7932
7933 * Soundness fixes to the interactions between associated types and
7934   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7935   code that violates the new rules. This is a significant change that
7936   is known to break existing code, so it has emitted warnings for the
7937   new error cases since 1.4 to give crate authors time to adapt. The
7938   details of what is changing are subtle; read the RFC for more.
7939 * [Several bugs in the compiler's visibility calculations were
7940   fixed][1.7v]. Since this was found to break significant amounts of
7941   code, the new errors will be emitted as warnings for several release
7942   cycles, under the `private_in_public` lint.
7943 * Defaulted type parameters were accidentally accepted in positions
7944   that were not intended. In this release, [defaulted type parameters
7945   appearing outside of type definitions will generate a
7946   warning][1.7d], which will become an error in future releases.
7947 * [Parsing "." as a float results in an error instead of 0][1.7p].
7948   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7949 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7950
7951 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7952 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7953 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7954 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7955 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7956 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7957 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7958 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7959 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7960 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7961 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7962 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7963 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7964 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7965 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7966 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7967 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7968 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7969 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7970 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7971 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7972 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7973 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7974 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7975 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7976 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7977 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7978 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7979 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7980 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7981 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7982 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7983 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7984 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7985 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7986 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7987 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7988 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7989 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7990 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7991 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7992 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7993 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7994 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7995 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7996 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7997 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7998 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7999 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8000 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8001 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8002 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8003 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8004 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8005 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8006 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8007 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8008 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8009 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8010 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8011 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8012 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8013 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8014 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8015 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8016 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8017 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8018 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8019 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8020 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8021 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8022 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8023 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8024 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8025 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8026 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8027 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8028 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8029 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8030
8031
8032 Version 1.6.0 (2016-01-21)
8033 ==========================
8034
8035 Language
8036 --------
8037
8038 * The `#![no_std]` attribute causes a crate to not be linked to the
8039   standard library, but only the [core library][1.6co], as described
8040   in [RFC 1184]. The core library defines common types and traits but
8041   has no platform dependencies whatsoever, and is the basis for Rust
8042   software in environments that cannot support a full port of the
8043   standard library, such as operating systems. Most of the core
8044   library is now stable.
8045
8046 Libraries
8047 ---------
8048
8049 * Stabilized APIs:
8050   [`Read::read_exact`],
8051   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8052   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8053   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8054   [`os::unix::fs::DirBuilderExt`],
8055   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8056   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8057   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8058   [`collections::hash_map::Drain`],
8059   [`collections::hash_map::HashMap::drain`],
8060   [`collections::hash_set::Drain`],
8061   [`collections::hash_set::HashSet::drain`],
8062   [`collections::binary_heap::Drain`],
8063   [`collections::binary_heap::BinaryHeap::drain`],
8064   [`Vec::extend_from_slice`] (renamed from `push_all`),
8065   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8066   [`RwLock::into_inner`],
8067   [`Iterator::min_by_key`] (renamed from `min_by`),
8068   [`Iterator::max_by_key`] (renamed from `max_by`).
8069 * The [core library][1.6co] is stable, as are most of its APIs.
8070 * [The `assert_eq!` macro supports arguments that don't implement
8071   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8072   `assert!`.
8073 * Several timer functions that take duration in milliseconds [are
8074   deprecated in favor of those that take `Duration`][1.6ms]. These
8075   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8076   `thread::park_timeout_ms`.
8077 * The algorithm by which `Vec` reserves additional elements was
8078   [tweaked to not allocate excessive space][1.6a] while still growing
8079   exponentially.
8080 * `From` conversions are [implemented from integers to floats][1.6f]
8081   in cases where the conversion is lossless. Thus they are not
8082   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8083   or `f64`. They are also not implemented for `isize` and `usize`
8084   because the implementations would be platform-specific. `From` is
8085   also implemented from `f32` to `f64`.
8086 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8087 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8088 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8089 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8090   improvements.
8091 * Sorting slices that are already sorted [is 50% faster in some
8092   cases][1.6s].
8093
8094 Cargo
8095 -----
8096
8097 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8098 * Cargo build scripts can specify their dependencies by emitting the
8099   [`rerun-if-changed`][1.6rr] key.
8100 * crates.io will reject publication of crates with dependencies that
8101   have a wildcard version constraint. Crates with wildcard
8102   dependencies were seen to cause a variety of problems, as described
8103   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8104   warning.
8105 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8106   release folder.  A variety of artifacts that Cargo failed to clean
8107   are now correctly deleted.
8108
8109 Misc
8110 ----
8111
8112 * The `unreachable_code` lint [warns when a function call's argument
8113   diverges][1.6dv].
8114 * The parser indicates [failures that may be caused by
8115   confusingly-similar Unicode characters][1.6uc]
8116 * Certain macro errors [are reported at definition time][1.6m], not
8117   expansion.
8118
8119 Compatibility Notes
8120 -------------------
8121
8122 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8123   environment variable when locating crates. This was a pre-cargo
8124   feature for integrating with the package manager that was
8125   accidentally never removed.
8126 * [A number of bugs were fixed in the privacy checker][1.6p] that
8127   could cause previously-accepted code to break.
8128 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8129 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8130   struct pattern syntax (`Foo(..)`) can no longer be used to match
8131   unit structs. This is a warning now, but will become an error in
8132   future releases. Patterns that share the same name as a const are
8133   now an error.
8134 * A bug was fixed that causes [rustc not to apply default type
8135   parameters][1.6xc] when resolving certain method implementations of
8136   traits defined in other crates.
8137
8138 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8139 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8140 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8141 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8142 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8143 [1.6co]: http://doc.rust-lang.org/core/index.html
8144 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8145 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8146 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8147 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8148 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8149 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8150 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8151 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8152 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8153 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8154 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8155 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8156 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8157 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8158 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8159 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8160 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8161 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8162 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8163 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8164 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8165 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8166 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8167 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8168 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8169 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8170 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8171 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8172 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8173 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8174 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8175 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8176 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8177 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8178 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8179 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8180 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8181 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8182 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8183 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8184 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8185
8186
8187 Version 1.5.0 (2015-12-10)
8188 ==========================
8189
8190 * ~700 changes, numerous bugfixes
8191
8192 Highlights
8193 ----------
8194
8195 * Stabilized APIs:
8196   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8197   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8198   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8199   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8200   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8201   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8202   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8203   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8204   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8205   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8206   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8207   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8208   [`Path::read_link`], [`Path::symlink_metadata`],
8209   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8210   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8211   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8212   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8213   [`slice::split_first_mut`], [`slice::split_first`],
8214   [`slice::split_last_mut`], [`slice::split_last`],
8215   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8216   [`str::MatchIndices`], [`str::RMatchIndices`],
8217   [`str::match_indices`], [`str::rmatch_indices`],
8218   [`str::slice_mut_unchecked`], [`string::ParseError`].
8219 * Rust applications hosted on crates.io can be installed locally to
8220   `~/.cargo/bin` with the [`cargo install`] command. Among other
8221   things this makes it easier to augment Cargo with new subcommands:
8222   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8223   invoked as `cargo foo`.
8224 * Crates with wildcard (`*`) dependencies will [emit warnings when
8225   published][1.5w]. In 1.6 it will no longer be possible to publish
8226   crates with wildcard dependencies.
8227
8228 Breaking Changes
8229 ----------------
8230
8231 * The rules determining when a particular lifetime must outlive
8232   a particular value (known as '[dropck]') have been [modified
8233   to not rely on parametricity][1.5p].
8234 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8235   and `Arc`][1.5a]. Because these smart pointer types implement
8236   `Deref`, this causes breakage in cases where the interior type
8237   contains methods of the same name.
8238 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8239   that they could drop their content. Soundness fix.
8240 * All method invocations are [properly checked][1.5wf1] for
8241   [well-formedness][1.5wf2]. Soundness fix.
8242 * Traits whose supertraits contain `Self` are [not object
8243   safe][1.5o]. Soundness fix.
8244 * Target specifications support a [`no_default_libraries`][1.5nd]
8245   setting that controls whether `-nodefaultlibs` is passed to the
8246   linker, and in turn the `is_like_windows` setting no longer affects
8247   the `-nodefaultlibs` flag.
8248 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8249 * The `#[inline]` and `#[repr]` attributes [can only appear
8250   in valid locations][1.5at].
8251 * Native libraries linked from the local crate are [passed to
8252   the linker before native libraries from upstream crates][1.5nl].
8253 * Two rarely-used attributes, `#[no_debug]` and
8254   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8255 * Negation of unsigned integers, which has been a warning for
8256   several releases, [is now behind a feature gate and will
8257   generate errors][1.5nu].
8258 * The parser accidentally accepted visibility modifiers on
8259   enum variants, a bug [which has been fixed][1.5ev].
8260 * [A bug was fixed that allowed `use` statements to import unstable
8261   features][1.5use].
8262
8263 Language
8264 --------
8265
8266 * When evaluating expressions at compile-time that are not
8267   compile-time constants (const-evaluating expressions in non-const
8268   contexts), incorrect code such as overlong bitshifts and arithmetic
8269   overflow will [generate a warning instead of an error][1.5ce],
8270   delaying the error until runtime. This will allow the
8271   const-evaluator to be expanded in the future backwards-compatibly.
8272 * The `improper_ctypes` lint [no longer warns about using `isize` and
8273   `usize` in FFI][1.5ict].
8274
8275 Libraries
8276 ---------
8277
8278 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8279   invariant][1.5c].
8280 * `Default` is [implemented for mutable slices][1.5d].
8281 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8282 * There are now `From` conversions [between floating point
8283   types][1.5f] where the conversions are lossless.
8284 * There are now `From` conversions [between integer types][1.5i] where
8285   the conversions are lossless.
8286 * [`fs::Metadata` implements `Clone`][1.5fs].
8287 * The `parse` method [accepts a leading "+" when parsing
8288   integers][1.5pi].
8289 * [`AsMut` is implemented for `Vec`][1.5am].
8290 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8291   been optimized][1.5cf] and no longer rely on the default impl.
8292 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8293   `unsafe extern "C"` function types now [implement `Clone`,
8294   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8295   `fmt::Debug` for up to 12 arguments][1.5fp].
8296 * [Dropping `Vec`s is much faster in unoptimized builds when the
8297   element types don't implement `Drop`][1.5dv].
8298 * A bug that caused in incorrect behavior when [combining `VecDeque`
8299   with zero-sized types][1.5vdz] was resolved.
8300 * [`PartialOrd` for slices is faster][1.5po].
8301
8302 Miscellaneous
8303 -------------
8304
8305 * [Crate metadata size was reduced by 20%][1.5md].
8306 * [Improvements to code generation reduced the size of libcore by 3.3
8307   MB and rustc's memory usage by 18MB][1.5m].
8308 * [Improvements to deref translation increased performance in
8309   unoptimized builds][1.5dr].
8310 * Various errors in trait resolution [are deduplicated to only be
8311   reported once][1.5te].
8312 * Rust has preliminary [support for rumprun kernels][1.5rr].
8313 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8314
8315 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8316 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8317 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8318 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8319 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8320 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8321 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8322 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8323 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8324 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8325 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8326 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8327 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8328 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8329 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8330 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8331 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8332 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8333 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8334 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8335 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8336 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8337 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8338 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8339 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8340 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8341 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8342 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8343 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8344 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8345 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8346 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8347 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8348 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8349 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8350 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8351 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8352 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8353 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8354 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8355 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8356 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8357 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8358 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8359 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8360 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8361 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8362 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8363 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8364 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8365 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8366 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8367 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8368 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8369 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8370 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8371 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8372 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8373 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8374 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8375 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8376 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8377 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8378 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8379 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8380 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8381 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8382 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8383 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8384 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8385 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8386 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8387 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8388 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8389 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8390 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8391 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8392 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8393 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8394 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8395 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8396 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8397 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8398 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8399 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8400 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8401 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8402 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8403 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8404
8405 Version 1.4.0 (2015-10-29)
8406 ==========================
8407
8408 * ~1200 changes, numerous bugfixes
8409
8410 Highlights
8411 ----------
8412
8413 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8414   GNU) are now supported and recommended for use.
8415
8416 Breaking Changes
8417 ----------------
8418
8419 * [Several changes have been made to fix type soundness and improve
8420   the behavior of associated types][sound]. See [RFC 1214]. Although
8421   we have mostly introduced these changes as warnings this release, to
8422   become errors next release, there are still some scenarios that will
8423   see immediate breakage.
8424 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8425   line breaks in addition to `\n`][crlf].
8426 * [Loans of `'static` lifetime extend to the end of a function][stat].
8427 * [`str::parse` no longer introduces avoidable rounding error when
8428   parsing floating point numbers. Together with earlier changes to
8429   float formatting/output, "round trips" like f.to_string().parse()
8430   now preserve the value of f exactly. Additionally, leading plus
8431   signs are now accepted][fp3].
8432
8433
8434 Language
8435 --------
8436
8437 * `use` statements that import multiple items [can now rename
8438   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8439 * [Binops work correctly on fat pointers][binfat].
8440 * `pub extern crate`, which does not behave as expected, [issues a
8441   warning][pec] until a better solution is found.
8442
8443 Libraries
8444 ---------
8445
8446 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8447   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8448   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8449   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8450   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8451   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8452   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8453   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8454   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8455   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8456   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8457   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8458   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8459   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8460   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8461   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8462   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8463   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8464   [`thread::sleep`].
8465 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8466   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8467   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8468   `f64::from_str_radix`.
8469 * [Reverse-searching strings is faster with the 'two-way'
8470   algorithm][s].
8471 * [`std::io::copy` allows `?Sized` arguments][cc].
8472 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8473   [override `count`, `nth` and `last` with an *O*(1)
8474   implementation][it].
8475 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8476 * [`IntoRawFd` has been added to the Unix-specific prelude,
8477   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8478   prelude][pr].
8479 * [`Extend<String>` and `FromIterator<String` are both implemented for
8480   `String`][es].
8481 * [`IntoIterator` is implemented for references to `Option` and
8482   `Result`][into2].
8483 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8484   Copy`][ext] as part of [RFC 839]. This will cause type inference
8485   breakage in rare situations.
8486 * [`BinaryHeap` implements `Debug`][bh2].
8487 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8488   arrays][bm].
8489 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8490   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8491 * [String comparison is faster][faststr].
8492 * `&mut T` where `T: std::fmt::Write` [also implements
8493   `std::fmt::Write`][mutw].
8494 * [A stable regression in `VecDeque::push_back` and other
8495   capacity-altering methods that caused panics for zero-sized types
8496   was fixed][vd].
8497 * [Function pointers implement traits for up to 12 parameters][fp2].
8498
8499 Miscellaneous
8500 -------------
8501
8502 * The compiler [no longer uses the 'morestack' feature to prevent
8503   stack overflow][mm]. Instead it uses guard pages and stack
8504   probes (though stack probes are not yet implemented on any platform
8505   but Windows).
8506 * [The compiler matches traits faster when projections are involved][p].
8507 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8508   `usize`][ffi].
8509 * [Cargo now displays useful information about what its doing during
8510   `cargo update`][cu].
8511
8512 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8513 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8514 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8515 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8516 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8517 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8518 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8519 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8520 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8521 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8522 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8523 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8524 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8525 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8526 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8527 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8528 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8529 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8530 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8531 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8532 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8533 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8534 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8535 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8536 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8537 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8538 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8539 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8540 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8541 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8542 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8543 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8544 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8545 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8546 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8547 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8548 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8549 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8550 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8551 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8552 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8553 [bh2]: https://github.com/rust-lang/rust/pull/28156
8554 [binfat]: https://github.com/rust-lang/rust/pull/28270
8555 [bm]: https://github.com/rust-lang/rust/pull/28197
8556 [cc]: https://github.com/rust-lang/rust/pull/27531
8557 [crlf]: https://github.com/rust-lang/rust/pull/28034
8558 [cu]: https://github.com/rust-lang/cargo/pull/1931
8559 [d]: https://github.com/rust-lang/rust/pull/27825
8560 [dep]: https://github.com/rust-lang/rust/pull/28339
8561 [es]: https://github.com/rust-lang/rust/pull/27956
8562 [ext]: https://github.com/rust-lang/rust/pull/28094
8563 [faststr]: https://github.com/rust-lang/rust/pull/28338
8564 [ffi]: https://github.com/rust-lang/rust/pull/28779
8565 [fp]: https://github.com/rust-lang/rust/pull/28268
8566 [fp2]: https://github.com/rust-lang/rust/pull/28560
8567 [fp3]: https://github.com/rust-lang/rust/pull/27307
8568 [i]: https://github.com/rust-lang/rust/pull/27451
8569 [into2]: https://github.com/rust-lang/rust/pull/28039
8570 [it]: https://github.com/rust-lang/rust/pull/27652
8571 [mm]: https://github.com/rust-lang/rust/pull/27338
8572 [mutw]: https://github.com/rust-lang/rust/pull/28368
8573 [sound]: https://github.com/rust-lang/rust/pull/27641
8574 [p]: https://github.com/rust-lang/rust/pull/27866
8575 [pec]: https://github.com/rust-lang/rust/pull/28486
8576 [pr]: https://github.com/rust-lang/rust/pull/27896
8577 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8578 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8579 [s]: https://github.com/rust-lang/rust/pull/27474
8580 [stab]: https://github.com/rust-lang/rust/pull/28339
8581 [stat]: https://github.com/rust-lang/rust/pull/28321
8582 [vd]: https://github.com/rust-lang/rust/pull/28494
8583
8584 Version 1.3.0 (2015-09-17)
8585 ==============================
8586
8587 * ~900 changes, numerous bugfixes
8588
8589 Highlights
8590 ----------
8591
8592 * The [new object lifetime defaults][nold] have been [turned
8593   on][nold2] after a cycle of warnings about the change. Now types
8594   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8595   being interpreted as `&'a Box<Trait+'a>` to `&'a
8596   Box<Trait+'static>`.
8597 * [The Rustonomicon][nom] is a new book in the official documentation
8598   that dives into writing unsafe Rust.
8599 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8600   timekeeping is employed by other std APIs, as well as out-of-tree
8601   time crates.
8602
8603 Breaking Changes
8604 ----------------
8605
8606 * The [new object lifetime defaults][nold] have been [turned
8607   on][nold2] after a cycle of warnings about the change.
8608 * There is a known [regression][lr] in how object lifetime elision is
8609   interpreted, the proper solution for which is undetermined.
8610 * The `#[prelude_import]` attribute, an internal implementation
8611   detail, was accidentally stabilized previously. [It has been put
8612   behind the `prelude_import` feature gate][pi]. This change is
8613   believed to break no existing code.
8614 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8615   [more sane for dynamically sized types][dst3]. Code that relied on
8616   the previous behavior is thought to be broken.
8617 * The `dropck` rules, which checks that destructors can't access
8618   destroyed values, [have been updated][dropck] to match the
8619   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8620   cause some previously-compiling code to no longer build.
8621
8622 Language
8623 --------
8624
8625 * The [new object lifetime defaults][nold] have been [turned
8626   on][nold2] after a cycle of warnings about the change.
8627 * Semicolons may [now follow types and paths in
8628   macros](https://github.com/rust-lang/rust/pull/27000).
8629 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8630   [more sane for dynamically sized types][dst3]. Code that relied on
8631   the previous behavior is not known to exist, and suspected to be
8632   broken.
8633 * `'static` variables [may now be recursive][st].
8634 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8635   implementations correctly.
8636 * The `dropck` rules, which checks that destructors can't access
8637   destroyed values, [have been updated][dropck] to match the
8638   [RFC][dropckrfc].
8639
8640 Libraries
8641 ---------
8642
8643 * The [`Duration`] API, [has been stabilized][ds], as well as the
8644   `std::time` module, which presently contains only `Duration`.
8645 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8646 * The owned C string, [`CString`], implements [`Borrow`] and the
8647   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8648   these allow C strings to be borrowed and cloned in generic code.
8649 * [`CStr`] implements [`Debug`].
8650 * [`AtomicPtr`] implements [`Debug`].
8651 * [`Error`] trait objects [can be downcast to their concrete types][e]
8652   in many common configurations, using the [`is`], [`downcast`],
8653   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8654   [`Any`] trait.
8655 * Searching for substrings now [employs the two-way algorithm][search]
8656   instead of doing a naive search. This gives major speedups to a
8657   number of methods, including [`contains`][sc], [`find`][sf],
8658   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8659   [`ends_with`][sew] are also faster.
8660 * The performance of `PartialEq` for slices is [much faster][ps].
8661 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8662   is overridden and optimized by the implementations for scalars.
8663 * The [`Hasher`] trait now has a number of specialized `write_*`
8664   methods for primitive types, for efficiency.
8665 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8666   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8667   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8668   of [`std::error::Error::cause`][iec] also delegates to the inner
8669   error.
8670 * [`process::Child`][pc] gained the [`id`] method, which returns a
8671   `u32` representing the platform-specific process identifier.
8672 * The [`connect`] method on slices is deprecated, replaced by the new
8673   [`join`] method (note that both of these are on the *unstable*
8674   [`SliceConcatExt`] trait, but through the magic of the prelude are
8675   available to stable code anyway).
8676 * The [`Div`] operator is implemented for [`Wrapping`] types.
8677 * [`DerefMut` is implemented for `String`][dms].
8678 * Performance of SipHash (the default hasher for `HashMap`) is
8679   [better for long data][sh].
8680 * [`AtomicPtr`] implements [`Send`].
8681 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8682   are now [specialized to use uninitialized buffers for increased
8683   performance][rte].
8684 * Lifetime parameters of foreign functions [are now resolved
8685   properly][f].
8686
8687 Misc
8688 ----
8689
8690 * Rust can now, with some coercion, [produce programs that run on
8691   Windows XP][xp], though XP is not considered a supported platform.
8692 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8693   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8694   recommended for use in 1.3, though should be fully-functional
8695   in the [64-bit 1.4 beta][b14].
8696 * On Fedora-based systems installation will [properly configure the
8697   dynamic linker][fl].
8698 * The compiler gained many new extended error descriptions, which can
8699   be accessed with the `--explain` flag.
8700 * The `dropck` pass, which checks that destructors can't access
8701   destroyed values, [has been rewritten][dropck]. This fixes some
8702   soundness holes, and as such will cause some previously-compiling
8703   code to no longer build.
8704 * `rustc` now uses [LLVM to write archive files where possible][ar].
8705   Eventually this will eliminate the compiler's dependency on the ar
8706   utility.
8707 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8708   supported FreeBSD on x86_64).
8709 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8710   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8711   more strict.
8712 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8713   will kill the process instead of leaking][nlp].
8714
8715 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8716 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8717 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8718 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8719 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8720 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8721 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8722 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8723 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8724 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8725 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8726 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8727 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8728 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8729 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8730 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8731 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8732 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8733 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8734 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8735 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8736 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8737 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8738 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8739 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8740 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8741 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8742 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8743 [ar]: https://github.com/rust-lang/rust/pull/26926
8744 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8745 [dms]: https://github.com/rust-lang/rust/pull/26241
8746 [dropck]: https://github.com/rust-lang/rust/pull/27261
8747 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8748 [ds]: https://github.com/rust-lang/rust/pull/26818
8749 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8750 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8751 [dst3]: https://github.com/rust-lang/rust/pull/27351
8752 [e]: https://github.com/rust-lang/rust/pull/24793
8753 [f]: https://github.com/rust-lang/rust/pull/26588
8754 [fb]: https://github.com/rust-lang/rust/pull/26959
8755 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8756 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8757 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8758 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8759 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8760 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8761 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8762 [lic]: https://github.com/rust-lang/rust/pull/26583
8763 [lnu]: https://github.com/rust-lang/rust/pull/27026
8764 [lr]: https://github.com/rust-lang/rust/issues/27248
8765 [lum]: https://github.com/rust-lang/rust/pull/26378
8766 [lur]: https://github.com/rust-lang/rust/pull/26783
8767 [nlp]: https://github.com/rust-lang/rust/pull/27176
8768 [nold2]: https://github.com/rust-lang/rust/pull/27045
8769 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8770 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8771 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8772 [pi]: https://github.com/rust-lang/rust/pull/26699
8773 [ps]: https://github.com/rust-lang/rust/pull/26884
8774 [rte]: https://github.com/rust-lang/rust/pull/26950
8775 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8776 [search]: https://github.com/rust-lang/rust/pull/26327
8777 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8778 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8779 [sh]: https://github.com/rust-lang/rust/pull/27280
8780 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8781 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8782 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8783 [st]: https://github.com/rust-lang/rust/pull/26630
8784 [win1]: https://github.com/rust-lang/rust/pull/26569
8785 [win2]: https://github.com/rust-lang/rust/pull/26741
8786 [win3]: https://github.com/rust-lang/rust/pull/26741
8787 [win4]: https://github.com/rust-lang/rust/pull/27210
8788 [xp]: https://github.com/rust-lang/rust/pull/26569
8789
8790 Version 1.2.0 (2015-08-07)
8791 ==========================
8792
8793 * ~1200 changes, numerous bugfixes
8794
8795 Highlights
8796 ----------
8797
8798 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8799   like `Rc` to contain types without a fixed size, arrays and trait
8800   objects, finally enabling use of `Rc<[T]>` and completing the
8801   implementation of DST.
8802 * [Parallel codegen][parcodegen] is now working again, which can
8803   substantially speed up large builds in debug mode; It also gets
8804   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8805   jobs). It's not enabled by default, but will be "in the near
8806   future". It can be activated with the `-C codegen-units=N` flag to
8807   `rustc`.
8808 * This is the first release with [experimental support for linking
8809   with the MSVC linker and lib C on Windows (instead of using the GNU
8810   variants via MinGW)][win]. It is yet recommended only for the most
8811   intrepid Rustaceans.
8812 * Benchmark compilations are showing a 30% improvement in
8813   bootstrapping over 1.1.
8814
8815 Breaking Changes
8816 ----------------
8817
8818 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8819   unicode case mapping, which is a previously-planned change in
8820   behavior and considered a bugfix.
8821 * [`mem::align_of`] now specifies [the *minimum alignment* for
8822   T][align], which is usually the alignment programs are interested
8823   in, and the same value reported by clang's
8824   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8825   break real code.
8826 * [The `#[packed]` attribute is no longer silently accepted by the
8827   compiler][packed]. This attribute did nothing and code that
8828   mentioned it likely did not work as intended.
8829 * Associated type defaults are [now behind the
8830   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8831   defaults *did not work*, but could be mentioned syntactically. As
8832   such this breakage has minimal impact.
8833
8834 Language
8835 --------
8836
8837 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8838   matching against dereferenceable values.
8839
8840 Libraries
8841 ---------
8842
8843 * The [`Extend`] trait, which grows a collection from an iterator, is
8844   implemented over iterators of references, for `String`, `Vec`,
8845   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8846   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8847 * The [`iter::once`] function returns an iterator that yields a single
8848   element, and [`iter::empty`] returns an iterator that yields no
8849   elements.
8850 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8851   over substring matches.
8852 * [`Cell`] and [`RefCell`] both implement `Eq`.
8853 * A number of methods for wrapping arithmetic are added to the
8854   integral types, [`wrapping_div`], [`wrapping_rem`],
8855   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8856   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8857   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8858   type.. It is illegal for the default arithmetic operations in Rust
8859   to overflow; the desire to wrap must be explicit.
8860 * The `{:#?}` formatting specifier [displays the alternate,
8861   pretty-printed][debugfmt] form of the `Debug` formatter. This
8862   feature was actually introduced prior to 1.0 with little
8863   fanfare.
8864 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8865   for writing data to formatted strings, similar to [`io::Write`].
8866 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8867   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8868   are used by code generators to emit implementations of [`Debug`].
8869 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8870   methods that convert case, following Unicode case mapping.
8871 * It is now easier to handle poisoned locks. The [`PoisonError`]
8872   type, returned by failing lock operations, exposes `into_inner`,
8873   `get_ref`, and `get_mut`, which all give access to the inner lock
8874   guard, and allow the poisoned lock to continue to operate. The
8875   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8876   poisoned lock without attempting to take the lock.
8877 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8878   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8879   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8880   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8881   `ChildStderr`.
8882 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8883   malformed input.
8884
8885 Misc
8886 ----
8887
8888 * `rustc` employs smarter heuristics for guessing at [typos].
8889 * `rustc` emits more efficient code for [no-op conversions between
8890   unsafe pointers][nop].
8891 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8892   resulting in faster compile times and smaller code.
8893
8894 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8895 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8896 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8897 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8898 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8899 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8900 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8901 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8902 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8903 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8904 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8905 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8906 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8907 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8908 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8909 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8910 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8911 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8912 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8913 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8914 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8915 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8916 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8917 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8918 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8919 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8920 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8921 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8922 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8923 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8924 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8925 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8926 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8927 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8928 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8929 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8930 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8931 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8932 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8933 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8934 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8935 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8936 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8937 [align]: https://github.com/rust-lang/rust/pull/25646
8938 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8939 [typos]: https://github.com/rust-lang/rust/pull/26087
8940 [nop]: https://github.com/rust-lang/rust/pull/26336
8941 [fat]: https://github.com/rust-lang/rust/pull/26411
8942 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8943 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8944 [packed]: https://github.com/rust-lang/rust/pull/25541
8945 [ad]: https://github.com/rust-lang/rust/pull/27382
8946 [win]: https://github.com/rust-lang/rust/pull/25350
8947
8948 Version 1.1.0 (2015-06-25)
8949 =========================
8950
8951 * ~850 changes, numerous bugfixes
8952
8953 Highlights
8954 ----------
8955
8956 * The [`std::fs` module has been expanded][fs] to expand the set of
8957   functionality exposed:
8958   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8959     don't incur a syscall on some platforms.
8960   * A `symlink_metadata` function has been added.
8961   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8962     access to all underlying information.
8963 * The compiler now contains extended explanations of many errors. When an error
8964   with an explanation occurs the compiler suggests using the `--explain` flag
8965   to read the explanation. Error explanations are also [available online][err-index].
8966 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8967   well as other work, the time to bootstrap the compiler decreased by
8968   32%.
8969
8970 Libraries
8971 ---------
8972
8973 * The [`str::split_whitespace`] method splits a string on unicode
8974   whitespace boundaries.
8975 * On both Windows and Unix, new extension traits provide conversion of
8976   I/O types to and from the underlying system handles. On Unix, these
8977   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8978   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8979   `TcpListener`, and `UpdSocket`. Further implementations for
8980   `std::process` will be stabilized later.
8981 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8982   Windows, symlinks can be created with
8983   `std::os::windows::symlink_dir` and
8984   `std::os::windows::symlink_file`.
8985 * The `mpsc::Receiver` type can now be converted into an iterator with
8986   `into_iter` on the [`IntoIterator`] trait.
8987 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8988   implementation of the [`From`] trait.
8989 * The `Debug` implementation for `RangeFull` [creates output that is
8990   more consistent with other implementations][rf].
8991 * [`Debug` is implemented for `File`][file].
8992 * The `Default` implementation for `Arc` [no longer requires `Sync +
8993   Send`][arc].
8994 * [The `Iterator` methods `count`, `nth`, and `last` have been
8995   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
8996 * Incorrect handling of paths on Windows has been improved in both the
8997   compiler and the standard library.
8998 * [`AtomicPtr` gained a `Default` implementation][ap].
8999 * In accordance with Rust's policy on arithmetic overflow `abs` now
9000   [panics on overflow when debug assertions are enabled][abs].
9001 * The [`Cloned`] iterator, which was accidentally left unstable for
9002   1.0 [has been stabilized][c].
9003 * The [`Incoming`] iterator, which iterates over incoming TCP
9004   connections, and which was accidentally unnamable in 1.0, [is now
9005   properly exported][inc].
9006 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9007   `sift_up` or `sift_down` panic][bh].
9008 * The [`split_off`] method of `LinkedList` [no longer corrupts
9009   the list in certain scenarios][ll].
9010
9011 Misc
9012 ----
9013
9014 * Type checking performance [has improved notably][sk] with
9015   [multiple improvements][pre].
9016 * The compiler [suggests code changes][ch] for more errors.
9017 * rustc and it's build system have experimental support for [building
9018   toolchains against MUSL][m] instead of glibc on Linux.
9019 * The compiler defines the `target_env` cfg value, which is used for
9020   distinguishing toolchains that are otherwise for the same
9021   platform. Presently this is set to `gnu` for common GNU Linux
9022   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9023 * The [`cargo rustc`][crc] command invokes a build with custom flags
9024   to rustc.
9025 * [Android executables are always position independent][pie].
9026 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9027   with `Drop`][drop].
9028
9029 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9030 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9031 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9032 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9033 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9034 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9035 [rf]: https://github.com/rust-lang/rust/pull/24491
9036 [err-index]: https://doc.rust-lang.org/error-index.html
9037 [sk]: https://github.com/rust-lang/rust/pull/24615
9038 [pre]: https://github.com/rust-lang/rust/pull/25323
9039 [file]: https://github.com/rust-lang/rust/pull/24598
9040 [ch]: https://github.com/rust-lang/rust/pull/24683
9041 [arc]: https://github.com/rust-lang/rust/pull/24695
9042 [si]: https://github.com/rust-lang/rust/pull/24701
9043 [ap]: https://github.com/rust-lang/rust/pull/24834
9044 [m]: https://github.com/rust-lang/rust/pull/24777
9045 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9046 [crc]: https://github.com/rust-lang/cargo/pull/1568
9047 [pie]: https://github.com/rust-lang/rust/pull/24953
9048 [abs]: https://github.com/rust-lang/rust/pull/25441
9049 [c]: https://github.com/rust-lang/rust/pull/25496
9050 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9051 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9052 [inc]: https://github.com/rust-lang/rust/pull/25522
9053 [bh]: https://github.com/rust-lang/rust/pull/25856
9054 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9055 [ll]: https://github.com/rust-lang/rust/pull/26022
9056 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9057 [drop]: https://github.com/rust-lang/rust/pull/24935
9058
9059 Version 1.0.0 (2015-05-15)
9060 ========================
9061
9062 * ~1500 changes, numerous bugfixes
9063
9064 Highlights
9065 ----------
9066
9067 * The vast majority of the standard library is now `#[stable]`. It is
9068   no longer possible to use unstable features with a stable build of
9069   the compiler.
9070 * Many popular crates on [crates.io] now work on the stable release
9071   channel.
9072 * Arithmetic on basic integer types now [checks for overflow in debug
9073   builds][overflow].
9074
9075 Language
9076 --------
9077
9078 * Several [restrictions have been added to trait coherence][coh] in
9079   order to make it easier for upstream authors to change traits
9080   without breaking downstream code.
9081 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9082   improve error messages and macro behavior. For example, `0b1234` is
9083   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9084 * Trait bounds [are always invariant][inv], eliminating the need for
9085   the `PhantomFn` and `MarkerTrait` lang items, which have been
9086   removed.
9087 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9088   "foo" as bar` syntax has been replaced with `extern crate foo as
9089   bar`, and Cargo now automatically translates "-" in *package* names
9090   to underscore for the crate name.
9091 * [Lifetime shadowing is an error][lt].
9092 * [`Send` no longer implies `'static`][send-rfc].
9093 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9094   `MyType::default()`.
9095 * Primitive types [now have inherent methods][prim-inherent],
9096   obviating the need for extension traits like `SliceExt`.
9097 * Methods with `Self: Sized` in their `where` clause are [considered
9098   object-safe][self-sized], allowing many extension traits like
9099   `IteratorExt` to be merged into the traits they extended.
9100 * You can now [refer to associated types][assoc-where] whose
9101   corresponding trait bounds appear only in a `where` clause.
9102 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9103   like `Send` and `Sync` are now library-defined.
9104 * A [Reflect trait][reflect] was introduced, which means that
9105   downcasting via the `Any` trait is effectively limited to concrete
9106   types. This helps retain the potentially-important "parametricity"
9107   property: generic code cannot behave differently for different type
9108   arguments except in minor ways.
9109 * The `unsafe_destructor` feature is now deprecated in favor of the
9110   [new `dropck`][dropck]. This change is a major reduction in unsafe
9111   code.
9112
9113 Libraries
9114 ---------
9115
9116 * The `thread_local` module [has been renamed to `std::thread`][th].
9117 * The methods of `IteratorExt` [have been moved to the `Iterator`
9118   trait itself][ie].
9119 * Several traits that implement Rust's conventions for type
9120   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9121   [centralized in the `std::convert` module][con].
9122 * The `FromError` trait [was removed in favor of `From`][fe].
9123 * The basic sleep function [has moved to
9124   `std::thread::sleep_ms`][slp].
9125 * The `splitn` function now takes an `n` parameter that represents the
9126   number of items yielded by the returned iterator [instead of the
9127   number of 'splits'][spl].
9128 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9129 * [Derived implementations of `PartialOrd` now order enums according
9130   to their explicitly-assigned discriminants][po].
9131 * [Methods for searching strings are generic over `Pattern`s][pat],
9132   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9133   some others.
9134 * [In method resolution, object methods are resolved before inherent
9135   methods][meth].
9136 * [`String::from_str` has been deprecated in favor of the `From` impl,
9137   `String::from`][sf].
9138 * [`io::Error` implements `Sync`][ios].
9139 * [The `words` method on `&str` has been replaced with
9140   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9141   a word?'
9142 * The new path and IO modules are complete and `#[stable]`. This
9143   was the major library focus for this cycle.
9144 * The path API was [revised][path-normalize] to normalize `.`,
9145   adjusting the tradeoffs in favor of the most common usage.
9146 * A large number of remaining APIs in `std` were also stabilized
9147   during this cycle; about 75% of the non-deprecated API surface
9148   is now stable.
9149 * The new [string pattern API][string-pattern] landed, which makes
9150   the string slice API much more internally consistent and flexible.
9151 * A new set of [generic conversion traits][conversion] replaced
9152   many existing ad hoc traits.
9153 * Generic numeric traits were [completely removed][num-traits]. This
9154   was made possible thanks to inherent methods for primitive types,
9155   and the removal gives maximal flexibility for designing a numeric
9156   hierarchy in the future.
9157 * The `Fn` traits are now related via [inheritance][fn-inherit]
9158   and provide ergonomic [blanket implementations][fn-blanket].
9159 * The `Index` and `IndexMut` traits were changed to
9160   [take the index by value][index-value], enabling code like
9161   `hash_map["string"]` to work.
9162 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9163   `Copy` data is known to be `Clone` as well.
9164
9165 Misc
9166 ----
9167
9168 * Many errors now have extended explanations that can be accessed with
9169   the `--explain` flag to `rustc`.
9170 * Many new examples have been added to the standard library
9171   documentation.
9172 * rustdoc has received a number of improvements focused on completion
9173   and polish.
9174 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9175 * Much headway was made on ecosystem-wide CI, making it possible
9176   to [compare builds for breakage][ci-compare].
9177
9178
9179 [crates.io]: http://crates.io
9180 [clo]: https://github.com/rust-lang/rust/pull/24034
9181 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9182 [con]: https://github.com/rust-lang/rust/pull/23875
9183 [cr]: https://github.com/rust-lang/rust/pull/23419
9184 [fe]: https://github.com/rust-lang/rust/pull/23879
9185 [ie]: https://github.com/rust-lang/rust/pull/23300
9186 [inv]: https://github.com/rust-lang/rust/pull/23938
9187 [ios]: https://github.com/rust-lang/rust/pull/24133
9188 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9189 [lt]: https://github.com/rust-lang/rust/pull/24057
9190 [meth]: https://github.com/rust-lang/rust/pull/24056
9191 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9192 [po]: https://github.com/rust-lang/rust/pull/24270
9193 [sf]: https://github.com/rust-lang/rust/pull/24517
9194 [slp]: https://github.com/rust-lang/rust/pull/23949
9195 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9196 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9197 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9198 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9199 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9200 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9201 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9202 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9203 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9204 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9205 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9206 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9207 [reflect]: https://github.com/rust-lang/rust/pull/23712
9208 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9209 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9210 [index-value]: https://github.com/rust-lang/rust/pull/23601
9211 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9212 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9213 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9214 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9215 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9216 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9217
9218
9219 Version 1.0.0-alpha.2 (2015-02-20)
9220 =====================================
9221
9222 * ~1300 changes, numerous bugfixes
9223
9224 * Highlights
9225
9226     * The various I/O modules were [overhauled][io-rfc] to reduce
9227       unnecessary abstractions and provide better interoperation with
9228       the underlying platform. The old `io` module remains temporarily
9229       at `std::old_io`.
9230     * The standard library now [participates in feature gating][feat],
9231       so use of unstable libraries now requires a `#![feature(...)]`
9232       attribute. The impact of this change is [described on the
9233       forum][feat-forum]. [RFC][feat-rfc].
9234
9235 * Language
9236
9237     * `for` loops [now operate on the `IntoIterator` trait][into],
9238       which eliminates the need to call `.iter()`, etc. to iterate
9239       over collections. There are some new subtleties to remember
9240       though regarding what sort of iterators various types yield, in
9241       particular that `for foo in bar { }` yields values from a move
9242       iterator, destroying the original collection. [RFC][into-rfc].
9243     * Objects now have [default lifetime bounds][obj], so you don't
9244       have to write `Box<Trait+'static>` when you don't care about
9245       storing references. [RFC][obj-rfc].
9246     * In types that implement `Drop`, [lifetimes must outlive the
9247       value][drop]. This will soon make it possible to safely
9248       implement `Drop` for types where `#[unsafe_destructor]` is now
9249       required. Read the [gorgeous RFC][drop-rfc] for details.
9250     * The fully qualified <T as Trait>::X syntax lets you set the Self
9251       type for a trait method or associated type. [RFC][ufcs-rfc].
9252     * References to types that implement `Deref<U>` now [automatically
9253       coerce to references][deref] to the dereferenced type `U`,
9254       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9255       should eliminate many unsightly uses of `&*`, as when converting
9256       from references to vectors into references to
9257       slices. [RFC][deref-rfc].
9258     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9259       `|:|`) is obsolete and closure kind is inferred from context.
9260     * [`Self` is a keyword][Self].
9261
9262 * Libraries
9263
9264     * The `Show` and `String` formatting traits [have been
9265       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9266       their related purposes. Automatically getting a string
9267       conversion to use with `format!("{:?}", something_to_debug)` is
9268       now written `#[derive(Debug)]`.
9269     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9270       OsStr}`, provide strings in platform-specific encodings for easier
9271       interop with system APIs. [RFC][osstr-rfc].
9272     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9273       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9274       creating raw pointers.
9275
9276 * Tooling
9277
9278     * Certain long error messages of the form 'expected foo found bar'
9279       are now [split neatly across multiple
9280       lines][multiline]. Examples in the PR.
9281     * On Unix Rust can be [uninstalled][un] by running
9282       `/usr/local/lib/rustlib/uninstall.sh`.
9283     * The `#[rustc_on_unimplemented]` attribute, requiring the
9284       'on_unimplemented' feature, lets rustc [display custom error
9285       messages when a trait is expected to be implemented for a type
9286       but is not][onun].
9287
9288 * Misc
9289
9290     * Rust is tested against a [LALR grammar][lalr], which parses
9291       almost all the Rust files that rustc does.
9292
9293 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9294 [close]: https://github.com/rust-lang/rust/pull/21843
9295 [deref]: https://github.com/rust-lang/rust/pull/21351
9296 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9297 [drop]: https://github.com/rust-lang/rust/pull/21972
9298 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9299 [feat]: https://github.com/rust-lang/rust/pull/21248
9300 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9301 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9302 [fmt]: https://github.com/rust-lang/rust/pull/21457
9303 [into]: https://github.com/rust-lang/rust/pull/20790
9304 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9305 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9306 [lalr]: https://github.com/rust-lang/rust/pull/21452
9307 [multiline]: https://github.com/rust-lang/rust/pull/19870
9308 [obj]: https://github.com/rust-lang/rust/pull/22230
9309 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9310 [onun]: https://github.com/rust-lang/rust/pull/20889
9311 [osstr]: https://github.com/rust-lang/rust/pull/21488
9312 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9313 [Self]: https://github.com/rust-lang/rust/pull/22158
9314 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9315 [un]: https://github.com/rust-lang/rust/pull/22256
9316
9317
9318 Version 1.0.0-alpha (2015-01-09)
9319 ==================================
9320
9321   * ~2400 changes, numerous bugfixes
9322
9323   * Highlights
9324
9325     * The language itself is considered feature complete for 1.0,
9326       though there will be many usability improvements and bugfixes
9327       before the final release.
9328     * Nearly 50% of the public API surface of the standard library has
9329       been declared 'stable'. Those interfaces are unlikely to change
9330       before 1.0.
9331     * The long-running debate over integer types has been
9332       [settled][ints]: Rust will ship with types named `isize` and
9333       `usize`, rather than `int` and `uint`, for pointer-sized
9334       integers. Guidelines will be rolled out during the alpha cycle.
9335     * Most crates that are not `std` have been moved out of the Rust
9336       distribution into the Cargo ecosystem so they can evolve
9337       separately and don't need to be stabilized as quickly, including
9338       'time', 'getopts', 'num', 'regex', and 'term'.
9339     * Documentation continues to be expanded with more API coverage, more
9340       examples, and more in-depth explanations. The guides have been
9341       consolidated into [The Rust Programming Language][trpl].
9342     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9343     * All official Rust binary installers now come with [Cargo], the
9344       Rust package manager.
9345
9346 * Language
9347
9348     * Closures have been [completely redesigned][unboxed] to be
9349       implemented in terms of traits, can now be used as generic type
9350       bounds and thus monomorphized and inlined, or via an opaque
9351       pointer (boxed) as in the old system. The new system is often
9352       referred to as 'unboxed' closures.
9353     * Traits now support [associated types][assoc], allowing families
9354       of related types to be defined together and used generically in
9355       powerful ways.
9356     * Enum variants are [namespaced by their type names][enum].
9357     * [`where` clauses][where] provide a more versatile and attractive
9358       syntax for specifying generic bounds, though the previous syntax
9359       remains valid.
9360     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9361       numeric types.
9362     * Rust [no longer has a runtime][rt] of any description, and only
9363       supports OS threads, not green threads.
9364     * At long last, Rust has been overhauled for 'dynamically-sized
9365       types' ([DST]), which integrates 'fat pointers' (object types,
9366       arrays, and `str`) more deeply into the type system, making it
9367       more consistent.
9368     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9369       `..j` that produce range types and which, when combined with the
9370       `Index` operator and multidispatch, leads to a convenient slice
9371       notation, `[i..j]`.
9372     * The new range syntax revealed an ambiguity in the fixed-length
9373       array syntax, so now fixed length arrays [are written `[T;
9374       N]`][arrays].
9375     * The `Copy` trait is no longer implemented automatically. Unsafe
9376       pointers no longer implement `Sync` and `Send` so types
9377       containing them don't automatically either. `Sync` and `Send`
9378       are now 'unsafe traits' so one can "forcibly" implement them via
9379       `unsafe impl` if a type confirms to the requirements for them
9380       even though the internals do not (e.g. structs containing unsafe
9381       pointers like `Arc`). These changes are intended to prevent some
9382       footguns and are collectively known as [opt-in built-in
9383       traits][oibit] (though `Sync` and `Send` will soon become pure
9384       library types unknown to the compiler).
9385     * Operator traits now take their operands [by value][ops], and
9386       comparison traits can use multidispatch to compare one type
9387       against multiple other types, allowing e.g. `String` to be
9388       compared with `&str`.
9389     * `if let` and `while let` are no longer feature-gated.
9390     * Rust has adopted a more [uniform syntax for escaping unicode
9391       characters][unicode].
9392     * `macro_rules!` [has been declared stable][mac]. Though it is a
9393       flawed system it is sufficiently popular that it must be usable
9394       for 1.0. Effort has gone into [future-proofing][mac-future] it
9395       in ways that will allow other macro systems to be developed in
9396       parallel, and won't otherwise impact the evolution of the
9397       language.
9398     * The prelude has been [pared back significantly][prelude] such
9399       that it is the minimum necessary to support the most pervasive
9400       code patterns, and through [generalized where clauses][where]
9401       many of the prelude extension traits have been consolidated.
9402     * Rust's rudimentary reflection [has been removed][refl], as it
9403       incurred too much code generation for little benefit.
9404     * [Struct variants][structvars] are no longer feature-gated.
9405     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9406       known as 'higher-ranked trait bounds', this crucially allows
9407       unboxed closures to work.
9408     * Macros invocations surrounded by parens or square brackets and
9409       not terminated by a semicolon are [parsed as
9410       expressions][macros], which makes expressions like `vec![1i32,
9411       2, 3].len()` work as expected.
9412     * Trait objects now implement their traits automatically, and
9413       traits that can be coerced to objects now must be [object
9414       safe][objsafe].
9415     * Automatically deriving traits is now done with `#[derive(...)]`
9416       not `#[deriving(...)]` for [consistency with other naming
9417       conventions][derive].
9418     * Importing the containing module or enum at the same time as
9419       items or variants they contain is [now done with `self` instead
9420       of `mod`][self], as in use `foo::{self, bar}`
9421     * Glob imports are no longer feature-gated.
9422     * The `box` operator and `box` patterns have been feature-gated
9423       pending a redesign. For now unique boxes should be allocated
9424       like other containers, with `Box::new`.
9425
9426 * Libraries
9427
9428     * A [series][coll1] of [efforts][coll2] to establish
9429       [conventions][coll3] for collections types has resulted in API
9430       improvements throughout the standard library.
9431     * New [APIs for error handling][err] provide ergonomic interop
9432       between error types, and [new conventions][err-conv] describe
9433       more clearly the recommended error handling strategies in Rust.
9434     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9435       it is easier to discuss failure in the context of error handling
9436       without making clarifications as to whether you are referring to
9437       the 'fail' macro or failure more generally.
9438     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9439       syscall when available.
9440     * The 'serialize' crate has been renamed 'rustc-serialize' and
9441       moved out of the distribution to Cargo. Although it is widely
9442       used now, it is expected to be superseded in the near future.
9443     * The `Show` formatter, typically implemented with
9444       `#[derive(Show)]` is [now requested with the `{:?}`
9445       specifier][show] and is intended for use by all types, for uses
9446       such as `println!` debugging. The new `String` formatter must be
9447       implemented by hand, uses the `{}` specifier, and is intended
9448       for full-fidelity conversions of things that can logically be
9449       represented as strings.
9450
9451 * Tooling
9452
9453     * [Flexible target specification][flex] allows rustc's code
9454       generation to be configured to support otherwise-unsupported
9455       platforms.
9456     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9457       respective debuggers with Rust-appropriate pretty-printing.
9458     * The Windows installation of Rust is distributed with the
9459       MinGW components currently required to link binaries on that
9460       platform.
9461
9462 * Misc
9463
9464     * Nullable enum optimizations have been extended to more types so
9465       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9466       space than the inner types themselves.
9467     * Work has begun on supporting AArch64.
9468
9469 [Cargo]: https://crates.io
9470 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9471 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9472 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9473 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9474 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9475 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9476 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9477 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9478 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9479 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9480 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9481 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9482 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9483 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9484 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9485 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9486 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9487 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9488 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9489 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9490 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9491 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9492 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9493 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9494 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9495 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9496 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9497 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9498 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9499 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9500 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9501 [trpl]: https://doc.rust-lang.org/book/index.html
9502 [rbe]: http://rustbyexample.com/
9503
9504
9505 Version 0.12.0 (2014-10-09)
9506 =============================
9507
9508   * ~1900 changes, numerous bugfixes
9509
9510   * Highlights
9511
9512     * The introductory documentation (now called The Rust Guide) has
9513       been completely rewritten, as have a number of supplementary
9514       guides.
9515     * Rust's package manager, Cargo, continues to improve and is
9516       sometimes considered to be quite awesome.
9517     * Many API's in `std` have been reviewed and updated for
9518       consistency with the in-development Rust coding
9519       guidelines. The standard library documentation tracks
9520       stabilization progress.
9521     * Minor libraries have been moved out-of-tree to the rust-lang org
9522       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9523       be installed with Cargo.
9524     * Lifetime elision allows lifetime annotations to be left off of
9525       function declarations in many common scenarios.
9526     * Rust now works on 64-bit Windows.
9527
9528   * Language
9529     * Indexing can be overloaded with the `Index` and `IndexMut`
9530       traits.
9531     * The `if let` construct takes a branch only if the `let` pattern
9532       matches, currently behind the 'if_let' feature gate.
9533     * 'where clauses', a more flexible syntax for specifying trait
9534       bounds that is more aesthetic, have been added for traits and
9535       free functions. Where clauses will in the future make it
9536       possible to constrain associated types, which would be
9537       impossible with the existing syntax.
9538     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9539       the 'slicing_syntax' feature gate, and can be overloaded with
9540       the `Slice` or `SliceMut` traits.
9541     * The syntax for matching of sub-slices has been changed to use a
9542       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9543       consistency with other uses of `..` and to future-proof
9544       potential additional uses of the syntax.
9545     * The syntax for matching inclusive ranges in patterns has changed
9546       from `0..3` to `0...4` to be consistent with the exclusive range
9547       syntax for slicing.
9548     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9549       c]`) has been put behind the 'advanced_slice_patterns' feature
9550       gate and may be removed in the future.
9551     * Components of tuples and tuple structs can be extracted using
9552       the `value.0` syntax, currently behind the `tuple_indexing`
9553       feature gate.
9554     * The `#[crate_id]` attribute is no longer supported; versioning
9555       is handled by the package manager.
9556     * Renaming crate imports are now written `extern crate foo as bar`
9557       instead of `extern crate bar = foo`.
9558     * Renaming use statements are now written `use foo as bar` instead
9559       of `use bar = foo`.
9560     * `let` and `match` bindings and argument names in macros are now
9561       hygienic.
9562     * The new, more efficient, closure types ('unboxed closures') have
9563       been added under a feature gate, 'unboxed_closures'. These will
9564       soon replace the existing closure types, once higher-ranked
9565       trait lifetimes are added to the language.
9566     * `move` has been added as a keyword, for indicating closures
9567       that capture by value.
9568     * Mutation and assignment is no longer allowed in pattern guards.
9569     * Generic structs and enums can now have trait bounds.
9570     * The `Share` trait is now called `Sync` to free up the term
9571       'shared' to refer to 'shared reference' (the default reference
9572       type.
9573     * Dynamically-sized types have been mostly implemented,
9574       unifying the behavior of fat-pointer types with the rest of the
9575       type system.
9576     * As part of dynamically-sized types, the `Sized` trait has been
9577       introduced, which qualifying types implement by default, and
9578       which type parameters expect by default. To specify that a type
9579       parameter does not need to be sized, write `<Sized? T>`. Most
9580       types are `Sized`, notable exceptions being unsized arrays
9581       (`[T]`) and trait types.
9582     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9583     * Lifetime bounds can now be applied to type parameters and object
9584       types.
9585     * The old, reference counted GC type, `Gc<T>` which was once
9586       denoted by the `@` sigil, has finally been removed. GC will be
9587       revisited in the future.
9588
9589   * Libraries
9590     * Library documentation has been improved for a number of modules.
9591     * Bit-vectors, collections::bitv has been modernized.
9592     * The url crate is deprecated in favor of
9593       http://github.com/servo/rust-url, which can be installed with
9594       Cargo.
9595     * Most I/O stream types can be cloned and subsequently closed from
9596       a different thread.
9597     * A `std::time::Duration` type has been added for use in I/O
9598       methods that rely on timers, as well as in the 'time' crate's
9599       `Timespec` arithmetic.
9600     * The runtime I/O abstraction layer that enabled the green thread
9601       scheduler to do non-thread-blocking I/O has been removed, along
9602       with the libuv-based implementation employed by the green thread
9603       scheduler. This will greatly simplify the future I/O work.
9604     * `collections::btree` has been rewritten to have a more
9605       idiomatic and efficient design.
9606
9607   * Tooling
9608     * rustdoc output now indicates the stability levels of API's.
9609     * The `--crate-name` flag can specify the name of the crate
9610       being compiled, like `#[crate_name]`.
9611     * The `-C metadata` specifies additional metadata to hash into
9612       symbol names, and `-C extra-filename` specifies additional
9613       information to put into the output filename, for use by the
9614       package manager for versioning.
9615     * debug info generation has continued to improve and should be
9616       more reliable under both gdb and lldb.
9617     * rustc has experimental support for compiling in parallel
9618       using the `-C codegen-units` flag.
9619     * rustc no longer encodes rpath information into binaries by
9620       default.
9621
9622   * Misc
9623     * Stack usage has been optimized with LLVM lifetime annotations.
9624     * Official Rust binaries on Linux are more compatible with older
9625       kernels and distributions, built on CentOS 5.10.
9626
9627
9628 Version 0.11.0 (2014-07-02)
9629 ==========================
9630
9631   * ~1700 changes, numerous bugfixes
9632
9633   * Language
9634     * ~[T] has been removed from the language. This type is superseded by
9635       the Vec<T> type.
9636     * ~str has been removed from the language. This type is superseded by
9637       the String type.
9638     * ~T has been removed from the language. This type is superseded by the
9639       Box<T> type.
9640     * @T has been removed from the language. This type is superseded by the
9641       standard library's std::gc::Gc<T> type.
9642     * Struct fields are now all private by default.
9643     * Vector indices and shift amounts are both required to be a `uint`
9644       instead of any integral type.
9645     * Byte character, byte string, and raw byte string literals are now all
9646       supported by prefixing the normal literal with a `b`.
9647     * Multiple ABIs are no longer allowed in an ABI string
9648     * The syntax for lifetimes on closures/procedures has been tweaked
9649       slightly: `<'a>|A, B|: 'b + K -> T`
9650     * Floating point modulus has been removed from the language; however it
9651       is still provided by a library implementation.
9652     * Private enum variants are now disallowed.
9653     * The `priv` keyword has been removed from the language.
9654     * A closure can no longer be invoked through a &-pointer.
9655     * The `use foo, bar, baz;` syntax has been removed from the language.
9656     * The transmute intrinsic no longer works on type parameters.
9657     * Statics now allow blocks/items in their definition.
9658     * Trait bounds are separated from objects with + instead of : now.
9659     * Objects can no longer be read while they are mutably borrowed.
9660     * The address of a static is now marked as insignificant unless the
9661       #[inline(never)] attribute is placed it.
9662     * The #[unsafe_destructor] attribute is now behind a feature gate.
9663     * Struct literals are no longer allowed in ambiguous positions such as
9664       if, while, match, and for..in.
9665     * Declaration of lang items and intrinsics are now feature-gated by
9666       default.
9667     * Integral literals no longer default to `int`, and floating point
9668       literals no longer default to `f64`. Literals must be suffixed with an
9669       appropriate type if inference cannot determine the type of the
9670       literal.
9671     * The Box<T> type is no longer implicitly borrowed to &mut T.
9672     * Procedures are now required to not capture borrowed references.
9673
9674   * Libraries
9675     * The standard library is now a "facade" over a number of underlying
9676       libraries. This means that development on the standard library should
9677       be speedier due to smaller crates, as well as a clearer line between
9678       all dependencies.
9679     * A new library, libcore, lives under the standard library's facade
9680       which is Rust's "0-assumption" library, suitable for embedded and
9681       kernel development for example.
9682     * A regex crate has been added to the standard distribution. This crate
9683       includes statically compiled regular expressions.
9684     * The unwrap/unwrap_err methods on Result require a Show bound for
9685       better error messages.
9686     * The return types of the std::comm primitives have been centralized
9687       around the Result type.
9688     * A number of I/O primitives have gained the ability to time out their
9689       operations.
9690     * A number of I/O primitives have gained the ability to close their
9691       reading/writing halves to cancel pending operations.
9692     * Reverse iterator methods have been removed in favor of `rev()` on
9693       their forward-iteration counterparts.
9694     * A bitflags! macro has been added to enable easy interop with C and
9695       management of bit flags.
9696     * A debug_assert! macro is now provided which is disabled when
9697       `--cfg ndebug` is passed to the compiler.
9698     * A graphviz crate has been added for creating .dot files.
9699     * The std::cast module has been migrated into std::mem.
9700     * The std::local_data api has been migrated from freestanding functions
9701       to being based on methods.
9702     * The Pod trait has been renamed to Copy.
9703     * jemalloc has been added as the default allocator for types.
9704     * The API for allocating memory has been changed to use proper alignment
9705       and sized deallocation
9706     * Connecting a TcpStream or binding a TcpListener is now based on a
9707       string address and a u16 port. This allows connecting to a hostname as
9708       opposed to an IP.
9709     * The Reader trait now contains a core method, read_at_least(), which
9710       correctly handles many repeated 0-length reads.
9711     * The process-spawning API is now centered around a builder-style
9712       Command struct.
9713     * The :? printing qualifier has been moved from the standard library to
9714       an external libdebug crate.
9715     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9716       have been renamed to Eq/Ord.
9717     * The select/plural methods have been removed from format!. The escapes
9718       for { and } have also changed from \{ and \} to {{ and }},
9719       respectively.
9720     * The TaskBuilder API has been re-worked to be a true builder, and
9721       extension traits for spawning native/green tasks have been added.
9722
9723   * Tooling
9724     * All breaking changes to the language or libraries now have their
9725       commit message annotated with `[breaking-change]` to allow for easy
9726       discovery of breaking changes.
9727     * The compiler will now try to suggest how to annotate lifetimes if a
9728       lifetime-related error occurs.
9729     * Debug info continues to be improved greatly with general bug fixes and
9730       better support for situations like link time optimization (LTO).
9731     * Usage of syntax extensions when cross-compiling has been fixed.
9732     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9733       -fdata-sections and --gc-sections has been enabled by default
9734     * The compiler is now stricter about where it will load module files
9735       from when a module is declared via `mod foo;`.
9736     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9737       Syntax extensions are now discovered via a "plugin registrar" type
9738       which will be extended in the future to other various plugins.
9739     * Lints have been restructured to allow for dynamically loadable lints.
9740     * A number of rustdoc improvements:
9741       * The HTML output has been visually redesigned.
9742       * Markdown is now powered by hoedown instead of sundown.
9743       * Searching heuristics have been greatly improved.
9744       * The search index has been reduced in size by a great amount.
9745       * Cross-crate documentation via `pub use` has been greatly improved.
9746       * Primitive types are now hyperlinked and documented.
9747     * Documentation has been moved from static.rust-lang.org/doc to
9748       doc.rust-lang.org
9749     * A new sandbox, play.rust-lang.org, is available for running and
9750       sharing rust code examples on-line.
9751     * Unused attributes are now more robustly warned about.
9752     * The dead_code lint now warns about unused struct fields.
9753     * Cross-compiling to iOS is now supported.
9754     * Cross-compiling to mipsel is now supported.
9755     * Stability attributes are now inherited by default and no longer apply
9756       to intra-crate usage, only inter-crate usage.
9757     * Error message related to non-exhaustive match expressions have been
9758       greatly improved.
9759
9760
9761 Version 0.10 (2014-04-03)
9762 =========================
9763
9764   * ~1500 changes, numerous bugfixes
9765
9766   * Language
9767     * A new RFC process is now in place for modifying the language.
9768     * Patterns with `@`-pointers have been removed from the language.
9769     * Patterns with unique vectors (`~[T]`) have been removed from the
9770       language.
9771     * Patterns with unique strings (`~str`) have been removed from the
9772       language.
9773     * `@str` has been removed from the language.
9774     * `@[T]` has been removed from the language.
9775     * `@self` has been removed from the language.
9776     * `@Trait` has been removed from the language.
9777     * Headers on `~` allocations which contain `@` boxes inside the type for
9778       reference counting have been removed.
9779     * The semantics around the lifetimes of temporary expressions have changed,
9780       see #3511 and #11585 for more information.
9781     * Cross-crate syntax extensions are now possible, but feature gated. See
9782       #11151 for more information. This includes both `macro_rules!` macros as
9783       well as syntax extensions such as `format!`.
9784     * New lint modes have been added, and older ones have been turned on to be
9785       warn-by-default.
9786       * Unnecessary parentheses
9787       * Uppercase statics
9788       * Camel Case types
9789       * Uppercase variables
9790       * Publicly visible private types
9791       * `#[deriving]` with raw pointers
9792     * Unsafe functions can no longer be coerced to closures.
9793     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9794     * The `#[simd]` attribute is now behind a feature gate.
9795     * Visibility is no longer allowed on `extern crate` statements, and
9796       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9797     * Trailing commas are now allowed in argument lists and tuple patterns.
9798     * The `do` keyword has been removed, it is now a reserved keyword.
9799     * Default type parameters have been implemented, but are feature gated.
9800     * Borrowed variables through captures in closures are now considered soundly.
9801     * `extern mod` is now `extern crate`
9802     * The `Freeze` trait has been removed.
9803     * The `Share` trait has been added for types that can be shared among
9804       threads.
9805     * Labels in macros are now hygienic.
9806     * Expression/statement macro invocations can be delimited with `{}` now.
9807     * Treatment of types allowed in `static mut` locations has been tweaked.
9808     * The `*` and `.` operators are now overloadable through the `Deref` and
9809       `DerefMut` traits.
9810     * `~Trait` and `proc` no longer have `Send` bounds by default.
9811     * Partial type hints are now supported with the `_` type marker.
9812     * An `Unsafe` type was introduced for interior mutability. It is now
9813       considered undefined to transmute from `&T` to `&mut T` without using the
9814       `Unsafe` type.
9815     * The #[linkage] attribute was implemented for extern statics/functions.
9816     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9817     * `Pod` was renamed to `Copy`.
9818
9819   * Libraries
9820     * The `libextra` library has been removed. It has now been decomposed into
9821       component libraries with smaller and more focused nuggets of
9822       functionality. The full list of libraries can be found on the
9823       documentation index page.
9824     * std: `std::condition` has been removed. All I/O errors are now propagated
9825       through the `Result` type. In order to assist with error handling, a
9826       `try!` macro for unwrapping errors with an early return and a lint for
9827       unused results has been added. See #12039 for more information.
9828     * std: The `vec` module has been renamed to `slice`.
9829     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9830       This will become the only growable vector in the future.
9831     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9832       are now found at `std::io::BufferedReader` instead of
9833       `std::io::buffered::BufferedReader`.
9834     * std: `print` and `println` are no longer in the prelude, the `print!` and
9835       `println!` macros are intended to be used instead.
9836     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9837       attempts to statically prevent cycles.
9838     * std: The standard distribution is adopting the policy of pushing failure
9839       to the user rather than failing in libraries. Many functions (such as
9840       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9841     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9842       deriving mode: `#[deriving(Show)]`.
9843     * std: `ToStr` is now implemented for all types implementing `Show`.
9844     * std: The formatting trait methods now take `&self` instead of `&T`
9845     * std: The `invert()` method on iterators has been renamed to `rev()`
9846     * std: `std::num` has seen a reduction in the genericity of its traits,
9847       consolidating functionality into a few core traits.
9848     * std: Backtraces are now printed on task failure if the environment
9849       variable `RUST_BACKTRACE` is present.
9850     * std: Naming conventions for iterators have been standardized. More details
9851       can be found on the wiki's style guide.
9852     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9853       still implement the function.
9854     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9855     * std: `assert_approx_eq!` has been removed
9856     * std: The `e` and `E` formatting specifiers for floats have been added to
9857       print them in exponential notation.
9858     * std: The `Times` trait has been removed
9859     * std: Indications of variance and opting out of builtin bounds is done
9860       through marker types in `std::kinds::marker` now
9861     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9862       `#[deriving(Hash)]` is now possible.
9863     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9864     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9865     * std: `Chan::new` is now `channel()`.
9866     * std: A new synchronous channel type has been implemented.
9867     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9868     * std: `hashmap` and `trie` have been moved to `libcollections`
9869     * std: `run` has been rolled into `io::process`
9870     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9871     * std: The equality and comparison traits have seen some reorganization.
9872     * std: `rand` has moved to `librand`.
9873     * std: `to_{lower,upper}case` has been implemented for `char`.
9874     * std: Logging has been moved to `liblog`.
9875     * collections: `HashMap` has been rewritten for higher performance and less
9876       memory usage.
9877     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9878       it can be booted manually. The runtime guide has more information and
9879       examples.
9880     * native: All I/O functionality except signals has been implemented.
9881     * green: Task spawning with `libgreen` has been optimized with stack caching
9882       and various trimming of code.
9883     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9884     * sync: The `extra::sync` module has been updated to modern rust (and moved
9885       to the `sync` library), tweaking and improving various interfaces while
9886       dropping redundant functionality.
9887     * sync: A new `Barrier` type has been added to the `sync` library.
9888     * sync: An efficient mutex for native and green tasks has been implemented.
9889     * serialize: The `base64` module has seen some improvement. It treats
9890       newlines better, has non-string error values, and has seen general
9891       cleanup.
9892     * fourcc: A `fourcc!` macro was introduced
9893     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9894       hexadecimal literal.
9895
9896   * Tooling
9897     * `rustpkg` has been deprecated and removed from the main repository. Its
9898       replacement, `cargo`, is under development.
9899     * Nightly builds of rust are now available
9900     * The memory usage of rustc has been improved many times throughout this
9901       release cycle.
9902     * The build process supports disabling rpath support for the rustc binary
9903       itself.
9904     * Code generation has improved in some cases, giving more information to the
9905       LLVM optimization passes to enable more extensive optimizations.
9906     * Debuginfo compatibility with lldb on OSX has been restored.
9907     * The master branch is now gated on an android bot, making building for
9908       android much more reliable.
9909     * Output flags have been centralized into one `--emit` flag.
9910     * Crate type flags have been centralized into one `--crate-type` flag.
9911     * Codegen flags have been consolidated behind a `-C` flag.
9912     * Linking against outdated crates now has improved error messages.
9913     * Error messages with lifetimes will often suggest how to annotate the
9914       function to fix the error.
9915     * Many more types are documented in the standard library, and new guides
9916       were written.
9917     * Many `rustdoc` improvements:
9918       * code blocks are syntax highlighted.
9919       * render standalone markdown files.
9920       * the --test flag tests all code blocks by default.
9921       * exported macros are displayed.
9922       * re-exported types have their documentation inlined at the location of the
9923         first re-export.
9924       * search works across crates that have been rendered to the same output
9925         directory.
9926
9927
9928 Version 0.9 (2014-01-09)
9929 ==========================
9930
9931    * ~1800 changes, numerous bugfixes
9932
9933    * Language
9934       * The `float` type has been removed. Use `f32` or `f64` instead.
9935       * A new facility for enabling experimental features (feature gating) has
9936         been added, using the crate-level `#[feature(foo)]` attribute.
9937       * Managed boxes (@) are now behind a feature gate
9938         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9939         standard library's `Gc` or `Rc` types instead.
9940       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9941       * Jumping back to the top of a loop is now done with `continue` instead of
9942         `loop`.
9943       * Strings can no longer be mutated through index assignment.
9944       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9945         hash delimiters, as in `r###"foo"###`.
9946       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9947         called once.
9948       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9949       * `@fn`s have been removed.
9950       * `do` only works with procs in order to make it obvious what the cost
9951         of `do` is.
9952       * Single-element tuple-like structs can no longer be dereferenced to
9953         obtain the inner value. A more comprehensive solution for overloading
9954         the dereference operator will be provided in the future.
9955       * The `#[link(...)]` attribute has been replaced with
9956         `#[crate_id = "name#vers"]`.
9957       * Empty `impl`s must be terminated with empty braces and may not be
9958         terminated with a semicolon.
9959       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9960         no longer has any special meaning.
9961       * The old `fmt!` string formatting macro has been removed.
9962       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9963         `print!` and `println!`.
9964       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9965       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9966         `extern mod foo = "bar"` instead.
9967       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9968       * Macros can have attributes.
9969       * Macros can expand to items with attributes.
9970       * Macros can expand to multiple items.
9971       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9972       * Comments may be nested.
9973       * Values automatically coerce to trait objects they implement, without
9974         an explicit `as`.
9975       * Enum discriminants are no longer an entire word but as small as needed to
9976         contain all the variants. The `repr` attribute can be used to override
9977         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9978         `#[repr(C)]` to match C enums.
9979       * Non-string literals are not allowed in attributes (they never worked).
9980       * The FFI now supports variadic functions.
9981       * Octal numeric literals, as in `0o7777`.
9982       * The `concat!` syntax extension performs compile-time string concatenation.
9983       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9984         removed as Rust no longer uses segmented stacks.
9985       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9986       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9987         not `*`; ignoring remaining fields of a struct is also done with `..`,
9988         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9989       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9990       * `rustc` supports the "system" calling convention, which defaults to the
9991         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9992         "C" elsewhere.
9993       * The `type_overflow` lint (default: warn) checks literals for overflow.
9994       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9995       * The `attribute_usage` lint (default: warn) warns about unknown
9996         attributes.
9997       * The `unknown_features` lint (default: warn) warns about unknown
9998         feature gates.
9999       * The `dead_code` lint (default: warn) checks for dead code.
10000       * Rust libraries can be linked statically to one another
10001       * `#[link_args]` is behind the `link_args` feature gate.
10002       * Native libraries are now linked with `#[link(name = "foo")]`
10003       * Native libraries can be statically linked to a rust crate
10004         (`#[link(name = "foo", kind = "static")]`).
10005       * Native OS X frameworks are now officially supported
10006         (`#[link(name = "foo", kind = "framework")]`).
10007       * The `#[thread_local]` attribute creates thread-local (not task-local)
10008         variables. Currently behind the `thread_local` feature gate.
10009       * The `return` keyword may be used in closures.
10010       * Types that can be copied via a memcpy implement the `Pod` kind.
10011       * The `cfg` attribute can now be used on struct fields and enum variants.
10012
10013    * Libraries
10014       * std: The `option` and `result` API's have been overhauled to make them
10015         simpler, more consistent, and more composable.
10016       * std: The entire `std::io` module has been replaced with one that is
10017         more comprehensive and that properly interfaces with the underlying
10018         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10019         implemented.
10020       * std: `io::util` contains a number of useful implementations of
10021         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10022         `ZeroReader`, `TeeReader`.
10023       * std: The reference counted pointer type `extra::rc` moved into std.
10024       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10025         just a wrapper around it).
10026       * std: The `Either` type has been removed.
10027       * std: `fmt::Default` can be implemented for any type to provide default
10028         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10029       * std: The `rand` API continues to be tweaked.
10030       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10031         on failure in gdb, is now named `rust_fail`.
10032       * std: The `each_key` and `each_value` methods on `HashMap` have been
10033         replaced by the `keys` and `values` iterators.
10034       * std: Functions dealing with type size and alignment have moved from the
10035         `sys` module to the `mem` module.
10036       * std: The `path` module was written and API changed.
10037       * std: `str::from_utf8` has been changed to cast instead of allocate.
10038       * std: `starts_with` and `ends_with` methods added to vectors via the
10039         `ImmutableEqVector` trait, which is in the prelude.
10040       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10041         if the index is out of bounds.
10042       * std: Task failure no longer propagates between tasks, as the model was
10043         complex, expensive, and incompatible with thread-based tasks.
10044       * std: The `Any` type can be used for dynamic typing.
10045       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10046         `task::try`.
10047       * std: Methods that produce iterators generally do not have an `_iter`
10048         suffix now.
10049       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10050         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10051       * std: `util::ignore` renamed to `prelude::drop`.
10052       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10053         trait.
10054       * std: `vec::raw` has seen a lot of cleanup and API changes.
10055       * std: The standard library no longer includes any C++ code, and very
10056         minimal C, eliminating the dependency on libstdc++.
10057       * std: Runtime scheduling and I/O functionality has been factored out into
10058         extensible interfaces and is now implemented by two different crates:
10059         libnative, for native threading and I/O; and libgreen, for green threading
10060         and I/O. This paves the way for using the standard library in more limited
10061         embedded environments.
10062       * std: The `comm` module has been rewritten to be much faster, have a
10063         simpler, more consistent API, and to work for both native and green
10064         threading.
10065       * std: All libuv dependencies have been moved into the rustuv crate.
10066       * native: New implementations of runtime scheduling on top of OS threads.
10067       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10068         and other I/O.
10069       * green: The green thread scheduler and message passing types are almost
10070         entirely lock-free.
10071       * extra: The `flatpipes` module had bitrotted and was removed.
10072       * extra: All crypto functions have been removed and Rust now has a policy of
10073         not reimplementing crypto in the standard library. In the future crypto
10074         will be provided by external crates with bindings to established libraries.
10075       * extra: `c_vec` has been modernized.
10076       * extra: The `sort` module has been removed. Use the `sort` method on
10077         mutable slices.
10078
10079    * Tooling
10080       * The `rust` and `rusti` commands have been removed, due to lack of
10081         maintenance.
10082       * `rustdoc` was completely rewritten.
10083       * `rustdoc` can test code examples in documentation.
10084       * `rustpkg` can test packages with the argument, 'test'.
10085       * `rustpkg` supports arbitrary dependencies, including C libraries.
10086       * `rustc`'s support for generating debug info is improved again.
10087       * `rustc` has better error reporting for unbalanced delimiters.
10088       * `rustc`'s JIT support was removed due to bitrot.
10089       * Executables and static libraries can be built with LTO (-Z lto)
10090       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10091         build tools.
10092
10093
10094 Version 0.8 (2013-09-26)
10095 ============================
10096
10097    * ~2200 changes, numerous bugfixes
10098
10099    * Language
10100       * The `for` loop syntax has changed to work with the `Iterator` trait.
10101       * At long last, unwinding works on Windows.
10102       * Default methods are ready for use.
10103       * Many trait inheritance bugs fixed.
10104       * Owned and borrowed trait objects work more reliably.
10105       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10106       * rustc can omit emission of code for the `debug!` macro if it is passed
10107         `--cfg ndebug`
10108       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10109         for foo.rs, then foo/mod.rs, and will generate an error when both are
10110         present.
10111       * Strings no longer contain trailing nulls. The new `std::c_str` module
10112         provides new mechanisms for converting to C strings.
10113       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10114       * The FFI has been overhauled such that foreign functions are called directly,
10115         instead of through a stack-switching wrapper.
10116       * Calling a foreign function must be done through a Rust function with the
10117         `#[fixed_stack_segment]` attribute.
10118       * The `externfn!` macro can be used to declare both a foreign function and
10119         a `#[fixed_stack_segment]` wrapper at once.
10120       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10121       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10122       * `priv` is disallowed everywhere except for struct fields and enum variants.
10123       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10124       * `ref` bindings in irrefutable patterns work correctly now.
10125       * `char` is now prevented from containing invalid code points.
10126       * Casting to `bool` is no longer allowed.
10127       * `\0` is now accepted as an escape in chars and strings.
10128       * `yield` is a reserved keyword.
10129       * `typeof` is a reserved keyword.
10130       * Crates may be imported by URL with `extern mod foo = "url";`.
10131       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10132       * Static vectors can be initialized with repeating elements,
10133         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10134       * Static structs can be initialized with functional record update,
10135         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10136       * `cfg!` can be used to conditionally execute code based on the crate
10137         configuration, similarly to `#[cfg(...)]`.
10138       * The `unnecessary_qualification` lint detects unneeded module
10139         prefixes (default: allow).
10140       * Arithmetic operations have been implemented on the SIMD types in
10141         `std::unstable::simd`.
10142       * Exchange allocation headers were removed, reducing memory usage.
10143       * `format!` implements a completely new, extensible, and higher-performance
10144         string formatting system. It will replace `fmt!`.
10145       * `print!` and `println!` write formatted strings (using the `format!`
10146         extension) to stdout.
10147       * `write!` and `writeln!` write formatted strings (using the `format!`
10148         extension) to the new Writers in `std::rt::io`.
10149       * The library section in which a function or static is placed may
10150         be specified with `#[link_section = "..."]`.
10151       * The `proto!` syntax extension for defining bounded message protocols
10152         was removed.
10153       * `macro_rules!` is hygienic for `let` declarations.
10154       * The `#[export_name]` attribute specifies the name of a symbol.
10155       * `unreachable!` can be used to indicate unreachable code, and fails
10156         if executed.
10157
10158    * Libraries
10159       * std: Transitioned to the new runtime, written in Rust.
10160       * std: Added an experimental I/O library, `rt::io`, based on the new
10161         runtime.
10162       * std: A new generic `range` function was added to the prelude, replacing
10163         `uint::range` and friends.
10164       * std: `range_rev` no longer exists. Since range is an iterator it can be
10165         reversed with `range(lo, hi).invert()`.
10166       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10167         renamed to `unwrap_or`.
10168       * std: The `iterator` module was renamed to `iter`.
10169       * std: Integral types now support the `checked_add`, `checked_sub`, and
10170         `checked_mul` operations for detecting overflow.
10171       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10172         consistency.
10173       * std: Methods are standardizing on conventions for casting methods:
10174         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10175         and cheap casts.
10176       * std: The `CString` type in `c_str` provides new ways to convert to and
10177         from C strings.
10178       * std: `DoubleEndedIterator` can yield elements in two directions.
10179       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10180         two splices.
10181       * std: `str::from_bytes` renamed to `str::from_utf8`.
10182       * std: `pop_opt` and `shift_opt` methods added to vectors.
10183       * std: The task-local data interface no longer uses @, and keys are
10184         no longer function pointers.
10185       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10186       * std: Added `SharedPort` to `comm`.
10187       * std: `Eq` has a default method for `ne`; only `eq` is required
10188         in implementations.
10189       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10190         is required in implementations.
10191       * std: `is_utf8` performance is improved, impacting many string functions.
10192       * std: `os::MemoryMap` provides cross-platform mmap.
10193       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10194         are not 'in-bounds' are considered undefined.
10195       * std: Many freestanding functions in `vec` removed in favor of methods.
10196       * std: Many freestanding functions on scalar types removed in favor of
10197         methods.
10198       * std: Many options to task builders were removed since they don't make
10199         sense in the new scheduler design.
10200       * std: More containers implement `FromIterator` so can be created by the
10201         `collect` method.
10202       * std: More complete atomic types in `unstable::atomics`.
10203       * std: `comm::PortSet` removed.
10204       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10205         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10206         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10207         default implementations.
10208       * std: Various `from_str` functions were removed in favor of a generic
10209         `from_str` which is available in the prelude.
10210       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10211       * extra: `dlist`, the doubly-linked list was modernized.
10212       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10213       * extra: Added `glob` module, replacing `std::os::glob`.
10214       * extra: `rope` was removed.
10215       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10216       * extra: `net`, and `timer` were removed. The experimental replacements
10217         are `std::rt::io::net` and `std::rt::io::timer`.
10218       * extra: Iterators implemented for `SmallIntMap`.
10219       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10220       * extra: `SmallIntSet` removed. Use `BitvSet`.
10221       * extra: Performance of JSON parsing greatly improved.
10222       * extra: `semver` updated to SemVer 2.0.0.
10223       * extra: `term` handles more terminals correctly.
10224       * extra: `dbg` module removed.
10225       * extra: `par` module removed.
10226       * extra: `future` was cleaned up, with some method renames.
10227       * extra: Most free functions in `getopts` were converted to methods.
10228
10229    * Other
10230       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10231       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10232         similarly to gcc's `--march` flag.
10233       * rustc's performance compiling small crates is much better.
10234       * rustpkg has received many improvements.
10235       * rustpkg supports git tags as package IDs.
10236       * rustpkg builds into target-specific directories so it can be used for
10237         cross-compiling.
10238       * The number of concurrent test tasks is controlled by the environment
10239         variable RUST_TEST_TASKS.
10240       * The test harness can now report metrics for benchmarks.
10241       * All tools have man pages.
10242       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10243       * The runtime uses jemalloc for allocations.
10244       * Segmented stacks are temporarily disabled as part of the transition to
10245         the new runtime. Stack overflows are possible!
10246       * A new documentation backend, rustdoc_ng, is available for use. It is
10247         still invoked through the normal `rustdoc` command.
10248
10249
10250 Version 0.7 (2013-07-03)
10251 =======================
10252
10253    * ~2000 changes, numerous bugfixes
10254
10255    * Language
10256       * `impl`s no longer accept a visibility qualifier. Put them on methods
10257         instead.
10258       * The borrow checker has been rewritten with flow-sensitivity, fixing
10259         many bugs and inconveniences.
10260       * The `self` parameter no longer implicitly means `&'self self`,
10261         and can be explicitly marked with a lifetime.
10262       * Overloadable compound operators (`+=`, etc.) have been temporarily
10263         removed due to bugs.
10264       * The `for` loop protocol now requires `for`-iterators to return `bool`
10265         so they compose better.
10266       * The `Durable` trait is replaced with the `'static` bounds.
10267       * Trait default methods work more often.
10268       * Structs with the `#[packed]` attribute have byte alignment and
10269         no padding between fields.
10270       * Type parameters bound by `Copy` must now be copied explicitly with
10271         the `copy` keyword.
10272       * It is now illegal to move out of a dereferenced unsafe pointer.
10273       * `Option<~T>` is now represented as a nullable pointer.
10274       * `@mut` does dynamic borrow checks correctly.
10275       * The `main` function is only detected at the topmost level of the crate.
10276         The `#[main]` attribute is still valid anywhere.
10277       * Struct fields may no longer be mutable. Use inherited mutability.
10278       * The `#[no_send]` attribute makes a type that would otherwise be
10279         `Send`, not.
10280       * The `#[no_freeze]` attribute makes a type that would otherwise be
10281         `Freeze`, not.
10282       * Unbounded recursion will abort the process after reaching the limit
10283         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10284       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10285         are never implicitly copyable.
10286       * `#[static_assert]` makes compile-time assertions about static bools.
10287       * At long last, 'argument modes' no longer exist.
10288       * The rarely used `use mod` statement no longer exists.
10289
10290    * Syntax extensions
10291       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10292         argument list.
10293       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10294         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10295         `#[deriving(...)]`.
10296       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10297         and unsuffixed integer literals.
10298
10299    * Libraries
10300       * The `core` crate was renamed to `std`.
10301       * The `std` crate was renamed to `extra`.
10302       * More and improved documentation.
10303       * std: `iterator` module for external iterator objects.
10304       * Many old-style (internal, higher-order function) iterators replaced by
10305         implementations of `Iterator`.
10306       * std: Many old internal vector and string iterators,
10307         incl. `any`, `all`. removed.
10308       * std: The `finalize` method of `Drop` renamed to `drop`.
10309       * std: The `drop` method now takes `&mut self` instead of `&self`.
10310       * std: The prelude no longer re-exports any modules, only types and traits.
10311       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10312         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10313       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10314         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10315       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10316         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10317       * std: Many types implement `Clone`.
10318       * std: `path` type renamed to `Path`.
10319       * std: `mut` module and `Mut` type removed.
10320       * std: Many standalone functions removed in favor of methods and iterators
10321         in `vec`, `str`. In the future methods will also work as functions.
10322       * std: `reinterpret_cast` removed. Use `transmute`.
10323       * std: ascii string handling in `std::ascii`.
10324       * std: `Rand` is implemented for ~/@.
10325       * std: `run` module for spawning processes overhauled.
10326       * std: Various atomic types added to `unstable::atomic`.
10327       * std: Various types implement `Zero`.
10328       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10329       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10330       * std: Added `os::mkdir_recursive`.
10331       * std: Added `os::glob` function performs filesystems globs.
10332       * std: `FuzzyEq` renamed to `ApproxEq`.
10333       * std: `Map` now defines `pop` and `swap` methods.
10334       * std: `Cell` constructors converted to static methods.
10335       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10336       * extra: `flate` module moved from `std` to `extra`.
10337       * extra: `fileinput` module for iterating over a series of files.
10338       * extra: `Complex` number type and `complex` module.
10339       * extra: `Rational` number type and `rational` module.
10340       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10341       * extra: `term` uses terminfo now, is more correct.
10342       * extra: `arc` functions converted to methods.
10343       * extra: Implementation of fixed output size variations of SHA-2.
10344
10345    * Tooling
10346       * `unused_variables` lint mode for unused variables (default: warn).
10347       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10348         (default: warn).
10349       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10350         (default: warn).
10351       * `dead_assignment` lint mode for unread variables (default: warn).
10352       * `unnecessary_allocation` lint mode detects some heap allocations that are
10353         immediately borrowed so could be written without allocating (default: warn).
10354       * `missing_doc` lint mode (default: allow).
10355       * `unreachable_code` lint mode (default: warn).
10356       * The `rusti` command has been rewritten and a number of bugs addressed.
10357       * rustc outputs in color on more terminals.
10358       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10359       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10360       * Compiling with `-g` will make the binary record information about
10361         dynamic borrowcheck failures for debugging.
10362       * rustdoc has a nicer stylesheet.
10363       * Various improvements to rustdoc.
10364       * Improvements to rustpkg (see the detailed release notes).
10365
10366
10367 Version 0.6 (2013-04-03)
10368 ========================
10369
10370    * ~2100 changes, numerous bugfixes
10371
10372    * Syntax changes
10373       * The self type parameter in traits is now spelled `Self`
10374       * The `self` parameter in trait and impl methods must now be explicitly
10375         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10376       * Static methods no longer require the `static` keyword and instead
10377         are distinguished by the lack of a `self` parameter
10378       * Replaced the `Durable` trait with the `'static` lifetime
10379       * The old closure type syntax with the trailing sigil has been
10380         removed in favor of the more consistent leading sigil
10381       * `super` is a keyword, and may be prefixed to paths
10382       * Trait bounds are separated with `+` instead of whitespace
10383       * Traits are implemented with `impl Trait for Type`
10384         instead of `impl Type: Trait`
10385       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10386       * The `export` keyword has finally been removed
10387       * The `move` keyword has been removed (see "Semantic changes")
10388       * The interior mutability qualifier on vectors, `[mut T]`, has been
10389         removed. Use `&mut [T]`, etc.
10390       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10391       * `fail` is no longer a keyword. Use `fail!()`
10392       * `assert` is no longer a keyword. Use `assert!()`
10393       * `log` is no longer a keyword. use `debug!`, etc.
10394       * 1-tuples may be represented as `(T,)`
10395       * Struct fields may no longer be `mut`. Use inherited mutability,
10396         `@mut T`, `core::mut` or `core::cell`
10397       * `extern mod { ... }` is no longer valid syntax for foreign
10398         function modules. Use extern blocks: `extern { ... }`
10399       * Newtype enums removed. Use tuple-structs.
10400       * Trait implementations no longer support visibility modifiers
10401       * Pattern matching over vectors improved and expanded
10402       * `const` renamed to `static` to correspond to lifetime name,
10403         and make room for future `static mut` unsafe mutable globals.
10404       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10405       * `Clone` implementations can be automatically generated with
10406         `#[deriving(Clone)]`
10407       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10408         instead of `foo as Bar`.
10409       * Fixed length vector types are now written as `[int, .. 3]`
10410         instead of `[int * 3]`.
10411       * Fixed length vector types can express the length as a constant
10412         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10413
10414    * Semantic changes
10415       * Types with owned pointers or custom destructors move by default,
10416         eliminating the `move` keyword
10417       * All foreign functions are considered unsafe
10418       * &mut is now unaliasable
10419       * Writes to borrowed @mut pointers are prevented dynamically
10420       * () has size 0
10421       * The name of the main function can be customized using #[main]
10422       * The default type of an inferred closure is &fn instead of @fn
10423       * `use` statements may no longer be "chained" - they cannot import
10424         identifiers imported by previous `use` statements
10425       * `use` statements are crate relative, importing from the "top"
10426         of the crate by default. Paths may be prefixed with `super::`
10427         or `self::` to change the search behavior.
10428       * Method visibility is inherited from the implementation declaration
10429       * Structural records have been removed
10430       * Many more types can be used in static items, including enums
10431         'static-lifetime pointers and vectors
10432       * Pattern matching over vectors improved and expanded
10433       * Typechecking of closure types has been overhauled to
10434         improve inference and eliminate unsoundness
10435       * Macros leave scope at the end of modules, unless that module is
10436         tagged with #[macro_escape]
10437
10438    * Libraries
10439       * Added big integers to `std::bigint`
10440       * Removed `core::oldcomm` module
10441       * Added pipe-based `core::comm` module
10442       * Numeric traits have been reorganized under `core::num`
10443       * `vec::slice` finally returns a slice
10444       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10445       * Containers reorganized around traits in `core::container`
10446       * `core::dvec` removed, `~[T]` is a drop-in replacement
10447       * `core::send_map` renamed to `core::hashmap`
10448       * `std::map` removed; replaced with `core::hashmap`
10449       * `std::treemap` reimplemented as an owned balanced tree
10450       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10451       * `core::trie` added as a fast ordered map for integer keys
10452       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10453       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10454         overload the comparison operators, whereas `TotalOrd` is used
10455         by certain container types
10456
10457    * Other
10458       * Replaced the 'cargo' package manager with 'rustpkg'
10459       * Added all-purpose 'rust' tool
10460       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10461       * rustc now *attempts* to offer spelling suggestions
10462       * Improved support for ARM and Android
10463       * Preliminary MIPS backend
10464       * Improved foreign function ABI implementation for x86, x86_64
10465       * Various memory usage improvements
10466       * Rust code may be embedded in foreign code under limited circumstances
10467       * Inline assembler supported by new asm!() syntax extension.
10468
10469
10470 Version 0.5 (2012-12-21)
10471 ===========================
10472
10473    * ~900 changes, numerous bugfixes
10474
10475    * Syntax changes
10476       * Removed `<-` move operator
10477       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10478       * Removed old fixed length vector syntax - `[T]/N`
10479       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10480       * Macros may now expand to items and statements
10481       * `a.b()` is always parsed as a method call, never as a field projection
10482       * `Eq` and `IterBytes` implementations can be automatically generated
10483         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10484       * Removed the special crate language for `.rc` files
10485       * Function arguments may consist of any irrefutable pattern
10486
10487    * Semantic changes
10488       * `&` and `~` pointers may point to objects
10489       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10490       * Enum variants may be structs
10491       * Destructors can be added to all nominal types with the Drop trait
10492       * Structs and nullary enum variants may be constants
10493       * Values that cannot be implicitly copied are now automatically moved
10494         without writing `move` explicitly
10495       * `&T` may now be coerced to `*T`
10496       * Coercions happen in `let` statements as well as function calls
10497       * `use` statements now take crate-relative paths
10498       * The module and type namespaces have been merged so that static
10499         method names can be resolved under the trait in which they are
10500         declared
10501
10502    * Improved support for language features
10503       * Trait inheritance works in many scenarios
10504       * More support for explicit self arguments in methods - `self`, `&self`
10505         `@self`, and `~self` all generally work as expected
10506       * Static methods work in more situations
10507       * Experimental: Traits may declare default methods for the implementations
10508         to use
10509
10510    * Libraries
10511       * New condition handling system in `core::condition`
10512       * Timsort added to `std::sort`
10513       * New priority queue, `std::priority_queue`
10514       * Pipes for serializable types, `std::flatpipes'
10515       * Serialization overhauled to be trait-based
10516       * Expanded `getopts` definitions
10517       * Moved futures to `std`
10518       * More functions are pure now
10519       * `core::comm` renamed to `oldcomm`. Still deprecated
10520       * `rustdoc` and `cargo` are libraries now
10521
10522    * Misc
10523       * Added a preliminary REPL, `rusti`
10524       * License changed from MIT to dual MIT/APL2
10525
10526
10527 Version 0.4 (2012-10-15)
10528 ==========================
10529
10530    * ~2000 changes, numerous bugfixes
10531
10532    * Syntax
10533       * All keywords are now strict and may not be used as identifiers anywhere
10534       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10535         'of', 'with', 'to', 'class'.
10536       * Classes are replaced with simpler structs
10537       * Explicit method self types
10538       * `ret` became `return` and `alt` became `match`
10539       * `import` is now `use`; `use is now `extern mod`
10540       * `extern mod { ... }` is now `extern { ... }`
10541       * `use mod` is the recommended way to import modules
10542       * `pub` and `priv` replace deprecated export lists
10543       * The syntax of `match` pattern arms now uses fat arrow (=>)
10544       * `main` no longer accepts an args vector; use `os::args` instead
10545
10546    * Semantics
10547       * Trait implementations are now coherent, ala Haskell typeclasses
10548       * Trait methods may be static
10549       * Argument modes are deprecated
10550       * Borrowed pointers are much more mature and recommended for use
10551       * Strings and vectors in the static region are stored in constant memory
10552       * Typestate was removed
10553       * Resolution rewritten to be more reliable
10554       * Support for 'dual-mode' data structures (freezing and thawing)
10555
10556    * Libraries
10557       * Most binary operators can now be overloaded via the traits in
10558         `core::ops'
10559       * `std::net::url` for representing URLs
10560       * Sendable hash maps in `core::send_map`
10561       * `core::task' gained a (currently unsafe) task-local storage API
10562
10563    * Concurrency
10564       * An efficient new intertask communication primitive called the pipe,
10565         along with a number of higher-level channel types, in `core::pipes`
10566       * `std::arc`, an atomically reference counted, immutable, shared memory
10567         type
10568       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10569       * Futures are now based on pipes and sendable
10570       * More robust linked task failure
10571       * Improved task builder API
10572
10573    * Other
10574       * Improved error reporting
10575       * Preliminary JIT support
10576       * Preliminary work on precise GC
10577       * Extensive architectural improvements to rustc
10578       * Begun a transition away from buggy C++-based reflection (shape) code to
10579         Rust-based (visitor) code
10580       * All hash functions and tables converted to secure, randomized SipHash
10581
10582
10583 Version 0.3  (2012-07-12)
10584 ========================
10585
10586    * ~1900 changes, numerous bugfixes
10587
10588    * New coding conveniences
10589       * Integer-literal suffix inference
10590       * Per-item control over warnings, errors
10591       * #[cfg(windows)] and #[cfg(unix)] attributes
10592       * Documentation comments
10593       * More compact closure syntax
10594       * 'do' expressions for treating higher-order functions as
10595         control structures
10596       * *-patterns (wildcard extended to all constructor fields)
10597
10598    * Semantic cleanup
10599       * Name resolution pass and exhaustiveness checker rewritten
10600       * Region pointers and borrow checking supersede alias
10601         analysis
10602       * Init-ness checking is now provided by a region-based liveness
10603         pass instead of the typestate pass; same for last-use analysis
10604       * Extensive work on region pointers
10605
10606    * Experimental new language features
10607       * Slices and fixed-size, interior-allocated vectors
10608       * #!-comments for lang versioning, shell execution
10609       * Destructors and iface implementation for classes;
10610         type-parameterized classes and class methods
10611       * 'const' type kind for types that can be used to implement
10612         shared-memory concurrency patterns
10613
10614    * Type reflection
10615
10616    * Removal of various obsolete features
10617       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10618                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10619
10620       * Constructs: do-while loops ('do' repurposed), fn binding,
10621                     resources (replaced by destructors)
10622
10623    * Compiler reorganization
10624       * Syntax-layer of compiler split into separate crate
10625       * Clang (from LLVM project) integrated into build
10626       * Typechecker split into sub-modules
10627
10628    * New library code
10629       * New time functions
10630       * Extension methods for many built-in types
10631       * Arc: atomic-refcount read-only / exclusive-use shared cells
10632       * Par: parallel map and search routines
10633       * Extensive work on libuv interface
10634       * Much vector code moved to libraries
10635       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10636         #include, #include_str, #include_bin
10637
10638    * Tool improvements
10639       * Cargo automatically resolves dependencies
10640
10641
10642 Version 0.2  (2012-03-29)
10643 =========================
10644
10645    * >1500 changes, numerous bugfixes
10646
10647    * New docs and doc tooling
10648
10649    * New port: FreeBSD x86_64
10650
10651    * Compilation model enhancements
10652       * Generics now specialized, multiply instantiated
10653       * Functions now inlined across separate crates
10654
10655    * Scheduling, stack and threading fixes
10656       * Noticeably improved message-passing performance
10657       * Explicit schedulers
10658       * Callbacks from C
10659       * Helgrind clean
10660
10661    * Experimental new language features
10662       * Operator overloading
10663       * Region pointers
10664       * Classes
10665
10666    * Various language extensions
10667       * C-callback function types: 'crust fn ...'
10668       * Infinite-loop construct: 'loop { ... }'
10669       * Shorten 'mutable' to 'mut'
10670       * Required mutable-local qualifier: 'let mut ...'
10671       * Basic glob-exporting: 'export foo::*;'
10672       * Alt now exhaustive, 'alt check' for runtime-checked
10673       * Block-function form of 'for' loop, with 'break' and 'ret'.
10674
10675    * New library code
10676       * AST quasi-quote syntax extension
10677       * Revived libuv interface
10678       * New modules: core::{future, iter}, std::arena
10679       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10680       * Extensive cleanup, regularization in libstd, libcore
10681
10682
10683 Version 0.1  (2012-01-20)
10684 ===============================
10685
10686    * Most language features work, including:
10687       * Unique pointers, unique closures, move semantics
10688       * Interface-constrained generics
10689       * Static interface dispatch
10690       * Stack growth
10691       * Multithread task scheduling
10692       * Typestate predicates
10693       * Failure unwinding, destructors
10694       * Pattern matching and destructuring assignment
10695       * Lightweight block-lambda syntax
10696       * Preliminary macro-by-example
10697
10698    * Compiler works with the following configurations:
10699       * Linux: x86 and x86_64 hosts and targets
10700       * macOS: x86 and x86_64 hosts and targets
10701       * Windows: x86 hosts and targets
10702
10703    * Cross compilation / multi-target configuration supported.
10704
10705    * Preliminary API-documentation and package-management tools included.
10706
10707 Known issues:
10708
10709    * Documentation is incomplete.
10710
10711    * Performance is below intended target.
10712
10713    * Standard library APIs are subject to extensive change, reorganization.
10714
10715    * Language-level versioning is not yet operational - future code will
10716      break unexpectedly.