]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #88601 - ibraheemdev:termination-result-infallible, r=yaahc
[rust.git] / RELEASES.md
1 Version 1.56.1 (2021-11-01)
2 ===========================
3
4 - New lints to detect the presence of bidirectional-override Unicode
5   codepoints in the compiled source code ([CVE-2021-42574])
6
7 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
8
9 Version 1.56.0 (2021-10-21)
10 ========================
11
12 Language
13 --------
14
15 - [The 2021 Edition is now stable.][rust#88100]
16   See [the edition guide][rust-2021-edition-guide] for more details.
17 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
18 - [Union field access is permitted in `const fn`.][rust#85769]
19
20 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
21
22 Compiler
23 --------
24
25 - [Upgrade to LLVM 13.][rust#87570]
26 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
27 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
28 - [Warnings can be forced on with `--force-warn`.][rust#87472]
29   This feature is primarily intended for usage by `cargo fix`, rather than end users.
30 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
31 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
32 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
33
34 \* Refer to Rust's [platform support page][platform-support-doc] for more
35 information on Rust's tiered platform support.
36
37 Libraries
38 ---------
39
40 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
41   The Windows console still requires valid Unicode, but this change allows
42   splitting a UTF-8 character across multiple write calls. This allows, for
43   instance, programs that just read and write data buffers (e.g. copying a file
44   to stdout) without regard for Unicode or character boundaries.
45 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
46   For this use case, atomics scale much better under contention.
47 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
48 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
49 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
50 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
51 - [Treat invalid environment variable names as non-existent.][rust#86183]
52   Previously, the environment functions would panic if given a variable name
53   with an internal null character or equal sign (`=`). Now, these functions will
54   just treat such names as non-existent variables, since the OS cannot represent
55   the existence of a variable with such a name.
56
57 Stabilised APIs
58 ---------------
59
60 - [`std::os::unix::fs::chroot`]
61 - [`UnsafeCell::raw_get`]
62 - [`BufWriter::into_parts`]
63 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
64   These APIs were previously stable in `std`, but are now also available in `core`.
65 - [`Vec::shrink_to`]
66 - [`String::shrink_to`]
67 - [`OsString::shrink_to`]
68 - [`PathBuf::shrink_to`]
69 - [`BinaryHeap::shrink_to`]
70 - [`VecDeque::shrink_to`]
71 - [`HashMap::shrink_to`]
72 - [`HashSet::shrink_to`]
73
74 These APIs are now usable in const contexts:
75
76 - [`std::mem::transmute`]
77 - [`[T]::first`][`slice::first`]
78 - [`[T]::split_first`][`slice::split_first`]
79 - [`[T]::last`][`slice::last`]
80 - [`[T]::split_last`][`slice::split_last`]
81
82 Cargo
83 -----
84
85 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
86   This has no effect at present on dependency version selection.
87   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
88   that support Rust code to include a crate's specified minimum version in the test matrix for that
89   crate by default.
90
91 Compatibility notes
92 -------------------
93
94 - [Update to new argument parsing rules on Windows.][rust#87580]
95   This adjusts Rust's standard library to match the behavior of the standard
96   libraries for C/C++. The rules have changed slightly over time, and this PR
97   brings us to the latest set of rules (changed in 2008).
98 - [Disallow the aapcs calling convention on aarch64][rust#88399]
99   This was already not supported by LLVM; this change surfaces this lack of
100   support with a better error message.
101 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
102 - [Warn when an escaped newline skips multiple lines.][rust#87671]
103 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
104    may return different values on glibc <= 2.24.][rust#81825]
105    Rust now invokes the `clone3` system call directly, when available, to use new functionality
106    available via that system call. Older versions of glibc cache the result of `getpid`, and only
107    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
108    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
109
110 Internal changes
111 ----------------
112 These changes provide no direct user facing benefits, but represent significant
113 improvements to the internals and overall performance of rustc
114 and related tools.
115
116 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
117   This improves the performance of most Rust builds.
118 - [Unify representation of macros in internal data structures.][rust#88019]
119   This change fixes a host of bugs with the handling of macros by the compiler,
120   as well as rustdoc.
121
122 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
123 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
124 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
125 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
126 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
127 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
128 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
129 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
130 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
131 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
132 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
133 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
134 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
135 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
136 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
137 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
138 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
139 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
140 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
141 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
142 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
143 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
144 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
145 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
146 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
147 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
148 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
149 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
150 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
151 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
152 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
153 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
154 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
155 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
156 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
157 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
158 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
159 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
160 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
161 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
162 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
163 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
164 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
165 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
166 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
167 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
168 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
169 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
170 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
171 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
172 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
173 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
174 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
175 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
176 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
177 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
178 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
179 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
180 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
181 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
182 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
183 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
184 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
185 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
186 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
187 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
188 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
189 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
190
191 Version 1.55.0 (2021-09-09)
192 ============================
193
194 Language
195 --------
196 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
197   will end at the maximum value of the integer.][83918]
198 - [You can now explicitly import the prelude of different editions
199   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
200
201 Compiler
202 --------
203 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
204
205 \* Refer to Rust's [platform support page][platform-support-doc] for more
206    information on Rust's tiered platform support.
207
208 Libraries
209 ---------
210
211 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
212   These improvements should in general provide faster string parsing of floats,
213   no longer reject certain valid floating point values, and reduce
214   the produced code size for non-stripped artifacts.
215 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
216
217 Stabilised APIs
218 ---------------
219
220 - [`Bound::cloned`]
221 - [`Drain::as_str`]
222 - [`IntoInnerError::into_error`]
223 - [`IntoInnerError::into_parts`]
224 - [`MaybeUninit::assume_init_mut`]
225 - [`MaybeUninit::assume_init_ref`]
226 - [`MaybeUninit::write`]
227 - [`array::map`]
228 - [`ops::ControlFlow`]
229 - [`x86::_bittest`]
230 - [`x86::_bittestandcomplement`]
231 - [`x86::_bittestandreset`]
232 - [`x86::_bittestandset`]
233 - [`x86_64::_bittest64`]
234 - [`x86_64::_bittestandcomplement64`]
235 - [`x86_64::_bittestandreset64`]
236 - [`x86_64::_bittestandset64`]
237
238 The following previously stable functions are now `const`.
239
240 - [`str::from_utf8_unchecked`]
241
242
243 Cargo
244 -----
245 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
246   rustc in parallel such as when using `cargo test`.][cargo/9675]
247 - [The package definition in `cargo metadata` now includes the `"default_run"`
248   field from the manifest.][cargo/9550]
249 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
250 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
251   of packages.][cargo/9663]
252
253 Rustdoc
254 -------
255 - [Added "Go to item on exact match" search option.][85876]
256 - [The "Implementors" section on traits no longer shows redundant
257   method definitions.][85970]
258 - [Trait implementations are toggled open by default.][86260] This should make the
259   implementations more searchable by tools like `CTRL+F` in your browser.
260 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
261   through type aliases.][86334]
262 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
263   "Trait Implementations" section.][86513]
264
265
266 Compatibility Notes
267 -------------------
268 - [std functions that return an `io::Error` will no longer use the
269   `ErrorKind::Other` variant.][85746] This is to better reflect that these
270   kinds of errors could be categorised [into newer more specific `ErrorKind`
271   variants][79965], and that they do not represent a user error.
272 - [Using environment variable names with `process::Command` on Windows now
273   behaves as expected.][85270] Previously using envionment variables with
274   `Command` would cause them to be ASCII-uppercased.
275 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
276   with `rustdoc::`][86849]
277
278 [86849]: https://github.com/rust-lang/rust/pull/86849
279 [86513]: https://github.com/rust-lang/rust/pull/86513
280 [86334]: https://github.com/rust-lang/rust/pull/86334
281 [86260]: https://github.com/rust-lang/rust/pull/86260
282 [85970]: https://github.com/rust-lang/rust/pull/85970
283 [85876]: https://github.com/rust-lang/rust/pull/85876
284 [83572]: https://github.com/rust-lang/rust/pull/83572
285 [86294]: https://github.com/rust-lang/rust/pull/86294
286 [86858]: https://github.com/rust-lang/rust/pull/86858
287 [86761]: https://github.com/rust-lang/rust/pull/86761
288 [85769]: https://github.com/rust-lang/rust/pull/85769
289 [85746]: https://github.com/rust-lang/rust/pull/85746
290 [85305]: https://github.com/rust-lang/rust/pull/85305
291 [85270]: https://github.com/rust-lang/rust/pull/85270
292 [84111]: https://github.com/rust-lang/rust/pull/84111
293 [83918]: https://github.com/rust-lang/rust/pull/83918
294 [79965]: https://github.com/rust-lang/rust/pull/79965
295 [87370]: https://github.com/rust-lang/rust/pull/87370
296 [87298]: https://github.com/rust-lang/rust/pull/87298
297 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
298 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
299 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
300 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
301 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
302 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
303 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
304 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
305 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
306 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
307 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
308 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
309 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
310 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
311 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
312 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
313 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
314 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
315 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
316 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
317 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
318 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
319 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
320 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
321
322
323 Version 1.54.0 (2021-07-29)
324 ============================
325
326 Language
327 -----------------------
328
329 - [You can now use macros for values in some built-in attributes.][83366]
330   This primarily allows you to call macros within the `#[doc]` attribute. For
331   example, to include external documentation in your crate, you can now write
332   the following:
333   ```rust
334   #![doc = include_str!("README.md")]
335   ```
336
337 - [You can now cast between unsized slice types (and types which contain
338   unsized slices) in `const fn`.][85078]
339 - [You can now use multiple generic lifetimes with `impl Trait` where the
340    lifetimes don't explicitly outlive another.][84701] In code this means
341    that you can now have `impl Trait<'a, 'b>` where as before you could
342    only have `impl Trait<'a, 'b> where 'b: 'a`.
343
344 Compiler
345 -----------------------
346
347 - [Rustc will now search for custom JSON targets in
348   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
349   directory.][83800] You can find your sysroot directory by running
350   `rustc --print sysroot`.
351 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
352 - [You can now use `#[target_feature]` on safe functions when targeting
353   WebAssembly platforms.][84988]
354 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
355 - [Added tier 3\* support for `bpfel-unknown-none`
356    and `bpfeb-unknown-none`.][79608]
357 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
358
359 \* Refer to Rust's [platform support page][platform-support-doc] for more
360    information on Rust's tiered platform support.
361
362 Libraries
363 -----------------------
364
365 - [`panic::panic_any` will now `#[track_caller]`.][85745]
366 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
367 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
368 - [The implementations of vendor intrinsics in core::arch have been
369    significantly refactored.][83278] The main user-visible changes are
370    a 50% reduction in the size of libcore.rlib and stricter validation
371    of constant operands passed to intrinsics. The latter is technically
372    a breaking change, but allows Rust to more closely match the C vendor
373    intrinsics API.
374
375 Stabilized APIs
376 ---------------
377
378 - [`BTreeMap::into_keys`]
379 - [`BTreeMap::into_values`]
380 - [`HashMap::into_keys`]
381 - [`HashMap::into_values`]
382 - [`arch::wasm32`]
383 - [`VecDeque::binary_search`]
384 - [`VecDeque::binary_search_by`]
385 - [`VecDeque::binary_search_by_key`]
386 - [`VecDeque::partition_point`]
387
388 Cargo
389 -----
390
391 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
392   the dependency graph.][cargo/9520]
393 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
394   in the tree ][cargo/9499]
395 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
396   macro dependencies.][cargo/9488]
397 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
398   This variable points to a directory that integration tests and benches
399   can use as a "scratchpad" for testing filesystem operations.
400
401 Compatibility Notes
402 -------------------
403 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
404 - [Previously unsound code is no longer permitted where different constructors in branches
405   could require different lifetimes.][85574]
406 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
407   than before and may reject some previously accepted code.
408 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
409    when compiled with `codegen-units = 1`.][86063]
410
411 [85574]: https://github.com/rust-lang/rust/issues/85574
412 [86831]: https://github.com/rust-lang/rust/issues/86831
413 [86063]: https://github.com/rust-lang/rust/issues/86063
414 [86831]: https://github.com/rust-lang/rust/issues/86831
415 [79608]: https://github.com/rust-lang/rust/pull/79608
416 [84988]: https://github.com/rust-lang/rust/pull/84988
417 [84701]: https://github.com/rust-lang/rust/pull/84701
418 [84072]: https://github.com/rust-lang/rust/pull/84072
419 [85745]: https://github.com/rust-lang/rust/pull/85745
420 [84744]: https://github.com/rust-lang/rust/pull/84744
421 [85078]: https://github.com/rust-lang/rust/pull/85078
422 [84717]: https://github.com/rust-lang/rust/pull/84717
423 [83800]: https://github.com/rust-lang/rust/pull/83800
424 [83366]: https://github.com/rust-lang/rust/pull/83366
425 [83278]: https://github.com/rust-lang/rust/pull/83278
426 [85292]: https://github.com/rust-lang/rust/pull/85292
427 [82834]: https://github.com/rust-lang/rust/pull/82834
428 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
429 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
430 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
431 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
432 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
433 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
434 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
435 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
436 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
437 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
438 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
439
440 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
441
442 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
443
444 Version 1.53.0 (2021-06-17)
445 ============================
446
447 Language
448 -----------------------
449 - [You can now use unicode for identifiers.][83799] This allows multilingual
450   identifiers but still doesn't allow glyphs that are not considered characters
451   such as `◆` or `🦀`. More specifically you can now use any identifier that
452   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
453   is the same standard as languages like Python, however Rust uses NFC
454   normalization which may be different from other languages.
455 - [You can now specify "or patterns" inside pattern matches.][79278]
456   Previously you could only use `|` (OR) on complete patterns. E.g.
457   ```rust
458   let x = Some(2u8);
459   // Before
460   matches!(x, Some(1) | Some(2));
461   // Now
462   matches!(x, Some(1 | 2));
463   ```
464 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
465   has the same semantics as the `:pat` matcher. This is to allow `:pat`
466   to change semantics to being a pattern fragment in a future edition.
467
468 Compiler
469 -----------------------
470 - [Updated the minimum external LLVM version to LLVM 10.][83387]
471 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
472 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
473
474 \* Refer to Rust's [platform support page][platform-support-doc] for more
475 information on Rust's tiered platform support.
476
477 Libraries
478 -----------------------
479 - [Abort messages will now forward to `android_set_abort_message` on
480   Android platforms when available.][81469]
481 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
482 - [Arrays of any length now implement `IntoIterator`.][84147]
483   Currently calling `.into_iter()` as a method on an array will
484   return `impl Iterator<Item=&T>`, but this may change in a
485   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
486   directly on arrays will provide `impl Iterator<Item=T>` as expected.
487 - [`leading_zeros`, and `trailing_zeros` are now available on all
488   `NonZero` integer types.][84082]
489 - [`{f32, f64}::from_str` now parse and print special values
490   (`NaN`, `-0`) according to IEEE 754.][78618]
491 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
492 - [Add the `BITS` associated constant to all numeric types.][82565]
493
494 Stabilised APIs
495 ---------------
496 - [`AtomicBool::fetch_update`]
497 - [`AtomicPtr::fetch_update`]
498 - [`BTreeMap::retain`]
499 - [`BTreeSet::retain`]
500 - [`BufReader::seek_relative`]
501 - [`DebugStruct::non_exhaustive`]
502 - [`Duration::MAX`]
503 - [`Duration::ZERO`]
504 - [`Duration::is_zero`]
505 - [`Duration::saturating_add`]
506 - [`Duration::saturating_mul`]
507 - [`Duration::saturating_sub`]
508 - [`ErrorKind::Unsupported`]
509 - [`Option::insert`]
510 - [`Ordering::is_eq`]
511 - [`Ordering::is_ge`]
512 - [`Ordering::is_gt`]
513 - [`Ordering::is_le`]
514 - [`Ordering::is_lt`]
515 - [`Ordering::is_ne`]
516 - [`OsStr::is_ascii`]
517 - [`OsStr::make_ascii_lowercase`]
518 - [`OsStr::make_ascii_uppercase`]
519 - [`OsStr::to_ascii_lowercase`]
520 - [`OsStr::to_ascii_uppercase`]
521 - [`Peekable::peek_mut`]
522 - [`Rc::decrement_strong_count`]
523 - [`Rc::increment_strong_count`]
524 - [`Vec::extend_from_within`]
525 - [`array::from_mut`]
526 - [`array::from_ref`]
527 - [`cmp::max_by_key`]
528 - [`cmp::max_by`]
529 - [`cmp::min_by_key`]
530 - [`cmp::min_by`]
531 - [`f32::is_subnormal`]
532 - [`f64::is_subnormal`]
533
534 Cargo
535 -----------------------
536 - [Cargo now supports git repositories where the default `HEAD` branch is not
537   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
538   which can handle default branches correctly.
539 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
540 - [The `authors` field is no longer included in `Cargo.toml` for new
541   projects.][cargo/9282]
542
543 Rustdoc
544 -----------------------
545 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
546   without hyperlinks.][81764]
547
548 Compatibility Notes
549 -------------------
550 - [Implement token-based handling of attributes during expansion][82608]
551 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
552   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
553   to confusion and potential security vulnerabilities and [is no
554   longer recommended][ietf6943].
555 - [The added `BITS` constant may conflict with external definitions.][85667]
556   In particular, this was known to be a problem in the `lexical-core` crate,
557   but they have published fixes for semantic versions 0.4 through 0.7. To
558   update this dependency alone, use `cargo update -p lexical-core`.
559 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
560
561 Internal Only
562 -------------
563 These changes provide no direct user facing benefits, but represent significant
564 improvements to the internals and overall performance of rustc and
565 related tools.
566
567 - [Rework the `std::sys::windows::alloc` implementation.][83065]
568 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
569 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
570 - [Rework rustdoc const type][82873]
571
572 [85667]: https://github.com/rust-lang/rust/pull/85667
573 [83386]: https://github.com/rust-lang/rust/pull/83386
574 [82771]: https://github.com/rust-lang/rust/pull/82771
575 [84147]: https://github.com/rust-lang/rust/pull/84147
576 [84082]: https://github.com/rust-lang/rust/pull/84082
577 [83799]: https://github.com/rust-lang/rust/pull/83799
578 [83681]: https://github.com/rust-lang/rust/pull/83681
579 [83652]: https://github.com/rust-lang/rust/pull/83652
580 [83387]: https://github.com/rust-lang/rust/pull/83387
581 [82873]: https://github.com/rust-lang/rust/pull/82873
582 [82864]: https://github.com/rust-lang/rust/pull/82864
583 [82608]: https://github.com/rust-lang/rust/pull/82608
584 [82565]: https://github.com/rust-lang/rust/pull/82565
585 [80525]: https://github.com/rust-lang/rust/pull/80525
586 [79278]: https://github.com/rust-lang/rust/pull/79278
587 [78618]: https://github.com/rust-lang/rust/pull/78618
588 [77704]: https://github.com/rust-lang/rust/pull/77704
589 [83941]: https://github.com/rust-lang/rust/pull/83941
590 [83065]: https://github.com/rust-lang/rust/pull/83065
591 [81764]: https://github.com/rust-lang/rust/pull/81764
592 [81469]: https://github.com/rust-lang/rust/pull/81469
593 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
594 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
595 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
596 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
597 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
598 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
599 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
600 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
601 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
602 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
603 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
604 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
605 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
606 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
607 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
608 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
609 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
610 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
611 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
612 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
613 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
614 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
615 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
616 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
617 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
618 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
619 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
620 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
621 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
622 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
623 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
624 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
625 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
626 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
627 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
628 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
629 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
630 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
631 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
632 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
633 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
634 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
635
636
637 Version 1.52.1 (2021-05-10)
638 ============================
639
640 This release disables incremental compilation, unless the user has explicitly
641 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
642
643 This is due to the widespread, and frequently occuring, breakage encountered by
644 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
645 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
646 newly added incremental verification are still present in past stable versions,
647 and are not yet fixed on any channel. These bugs can lead to miscompilation of
648 Rust binaries.
649
650 These problems only affect incremental builds, so release builds with Cargo
651 should not be affected unless the user has explicitly opted into incremental.
652 Debug and check builds are affected.
653
654 See [84970] for more details.
655
656 [84970]: https://github.com/rust-lang/rust/issues/84970
657
658 Version 1.52.0 (2021-05-06)
659 ============================
660
661 Language
662 --------
663 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
664   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
665   is allowed by default, and may become a warning or hard error in a
666   future edition.
667 - [You can now cast mutable references to arrays to a pointer of the same type as
668   the element.][81479]
669
670 Compiler
671 --------
672 - [Upgraded the default LLVM to LLVM 12.][81451]
673
674 Added tier 3\* support for the following targets.
675
676 - [`s390x-unknown-linux-musl`][82166]
677 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
678 - [`powerpc-unknown-openbsd`][82733]
679
680 \* Refer to Rust's [platform support page][platform-support-doc] for more
681 information on Rust's tiered platform support.
682
683 Libraries
684 ---------
685 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
686 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
687 - [`Arc<impl Error>` now implements `error::Error`.][80553]
688 - [All integer division and remainder operations are now `const`.][80962]
689
690 Stabilised APIs
691 -------------
692 - [`Arguments::as_str`]
693 - [`char::MAX`]
694 - [`char::REPLACEMENT_CHARACTER`]
695 - [`char::UNICODE_VERSION`]
696 - [`char::decode_utf16`]
697 - [`char::from_digit`]
698 - [`char::from_u32_unchecked`]
699 - [`char::from_u32`]
700 - [`slice::partition_point`]
701 - [`str::rsplit_once`]
702 - [`str::split_once`]
703
704 The following previously stable APIs are now `const`.
705
706 - [`char::len_utf8`]
707 - [`char::len_utf16`]
708 - [`char::to_ascii_uppercase`]
709 - [`char::to_ascii_lowercase`]
710 - [`char::eq_ignore_ascii_case`]
711 - [`u8::to_ascii_uppercase`]
712 - [`u8::to_ascii_lowercase`]
713 - [`u8::eq_ignore_ascii_case`]
714
715 Rustdoc
716 -------
717 - [Rustdoc lints are now treated as a tool lint, meaning that
718   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
719   Using the old style is still allowed, and will become a warning in
720   a future release.
721 - [Rustdoc now supports argument files.][82261]
722 - [Rustdoc now generates smart punctuation for documentation.][79423]
723 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
724   ```markdown
725   - [x] Complete
726   - [ ] Todo
727   ```
728
729 Misc
730 ----
731 - [You can now pass multiple filters to tests.][81356] E.g.
732   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
733 - [Rustup now distributes PDB symbols for the `std` library on Windows,
734   allowing you to see `std` symbols when debugging.][82218]
735
736 Internal Only
737 -------------
738 These changes provide no direct user facing benefits, but represent significant
739 improvements to the internals and overall performance of rustc and
740 related tools.
741
742 - [Check the result cache before the DepGraph when ensuring queries][81855]
743 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
744 - [Only store a LocalDefId in some HIR nodes][81611]
745 - [Store HIR attributes in a side table][79519]
746
747 Compatibility Notes
748 -------------------
749 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
750 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
751 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
752 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
753   languages in code blocks.][78429]
754 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
755 - [Changes in how proc macros handle whitespace may lead to panics when used
756   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
757 - [Turn `#[derive]` into a regular macro attribute][79078]
758
759 [84136]: https://github.com/rust-lang/rust/issues/84136
760 [80763]: https://github.com/rust-lang/rust/pull/80763
761 [82166]: https://github.com/rust-lang/rust/pull/82166
762 [82121]: https://github.com/rust-lang/rust/pull/82121
763 [81879]: https://github.com/rust-lang/rust/pull/81879
764 [82261]: https://github.com/rust-lang/rust/pull/82261
765 [82218]: https://github.com/rust-lang/rust/pull/82218
766 [82216]: https://github.com/rust-lang/rust/pull/82216
767 [82202]: https://github.com/rust-lang/rust/pull/82202
768 [81855]: https://github.com/rust-lang/rust/pull/81855
769 [81766]: https://github.com/rust-lang/rust/pull/81766
770 [81744]: https://github.com/rust-lang/rust/pull/81744
771 [81611]: https://github.com/rust-lang/rust/pull/81611
772 [81479]: https://github.com/rust-lang/rust/pull/81479
773 [81451]: https://github.com/rust-lang/rust/pull/81451
774 [81356]: https://github.com/rust-lang/rust/pull/81356
775 [80962]: https://github.com/rust-lang/rust/pull/80962
776 [80553]: https://github.com/rust-lang/rust/pull/80553
777 [80527]: https://github.com/rust-lang/rust/pull/80527
778 [79519]: https://github.com/rust-lang/rust/pull/79519
779 [79423]: https://github.com/rust-lang/rust/pull/79423
780 [79208]: https://github.com/rust-lang/rust/pull/79208
781 [78429]: https://github.com/rust-lang/rust/pull/78429
782 [82733]: https://github.com/rust-lang/rust/pull/82733
783 [82594]: https://github.com/rust-lang/rust/pull/82594
784 [79078]: https://github.com/rust-lang/rust/pull/79078
785 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
786 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
787 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
788 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
789 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
790 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
791 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
792 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
793 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
794 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
795 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
796 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
797 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
798 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
799 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
800 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
801 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
802 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
803 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
804 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
805 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
806 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
807
808 Version 1.51.0 (2021-03-25)
809 ============================
810
811 Language
812 --------
813 - [You can now parameterize items such as functions, traits, and `struct`s by constant
814   values in addition to by types and lifetimes.][79135] Also known as "const generics"
815   E.g. you can now write the following. Note: Only values of primitive integers,
816   `bool`, or `char` types are currently permitted.
817   ```rust
818   struct GenericArray<T, const LENGTH: usize> {
819       inner: [T; LENGTH]
820   }
821
822   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
823       const fn last(&self) -> Option<&T> {
824           if LENGTH == 0 {
825               None
826           } else {
827               Some(&self.inner[LENGTH - 1])
828           }
829       }
830   }
831   ```
832
833
834 Compiler
835 --------
836
837 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
838   This option controls whether debug information is split across multiple files
839   or packed into a single file. **Note** This option is unstable on other platforms.
840 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
841   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
842 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
843 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
844
845 \* Refer to Rust's [platform support page][platform-support-doc] for more
846 information on Rust's tiered platform support.
847
848 Libraries
849 ---------
850
851 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
852 - [`str` now implements `AsMut<str>`.][80279]
853 - [`u64` and `u128` now implement `From<char>`.][79502]
854 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
855 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
856 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
857 - [`io::Empty` now implements `io::Seek`.][78044]
858 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
859   `T: ?Sized` types.][80764]
860 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
861
862
863 Stabilized APIs
864 ---------------
865
866 - [`Arc::decrement_strong_count`]
867 - [`Arc::increment_strong_count`]
868 - [`Once::call_once_force`]
869 - [`Peekable::next_if_eq`]
870 - [`Peekable::next_if`]
871 - [`Seek::stream_position`]
872 - [`array::IntoIter`]
873 - [`panic::panic_any`]
874 - [`ptr::addr_of!`]
875 - [`ptr::addr_of_mut!`]
876 - [`slice::fill_with`]
877 - [`slice::split_inclusive_mut`]
878 - [`slice::split_inclusive`]
879 - [`slice::strip_prefix`]
880 - [`slice::strip_suffix`]
881 - [`str::split_inclusive`]
882 - [`sync::OnceState`]
883 - [`task::Wake`]
884 - [`VecDeque::range`]
885 - [`VecDeque::range_mut`]
886
887 Cargo
888 -----
889 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
890   codegen option.][cargo/9112]
891 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
892   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
893   to avoid unifying features of dependencies where that unification could be unwanted.
894   Such as using the same dependency with a `std` feature in a build scripts and
895   proc-macros, while using the `no-std` feature in the final binary. See the
896   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
897
898 Rustdoc
899 -------
900
901 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
902 - [You can now provide a `--default-theme` flag which sets the default theme to use for
903   documentation.][79642]
904
905 Various improvements to intra-doc links:
906
907 - [You can link to non-path primitives such as `slice`.][80181]
908 - [You can link to associated items.][74489]
909 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
910
911 Misc
912 ----
913 - [You can now pass `--include-ignored` to tests (e.g. with
914   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
915
916 Compatibility Notes
917 -------------------
918
919 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
920 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
921   could fail.][80579]
922 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
923   for the distributed artifacts.][81521]
924     - `armv5te-unknown-linux-gnueabi`
925     - `sparc64-unknown-linux-gnu`
926     - `thumbv7neon-unknown-linux-gnueabihf`
927     - `armv7-unknown-linux-gnueabi`
928     - `x86_64-unknown-linux-gnux32`
929 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
930
931 Internal Only
932 -------------
933
934 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
935
936 [79135]: https://github.com/rust-lang/rust/pull/79135
937 [74489]: https://github.com/rust-lang/rust/pull/74489
938 [76934]: https://github.com/rust-lang/rust/pull/76934
939 [79570]: https://github.com/rust-lang/rust/pull/79570
940 [80181]: https://github.com/rust-lang/rust/pull/80181
941 [79642]: https://github.com/rust-lang/rust/pull/79642
942 [80945]: https://github.com/rust-lang/rust/pull/80945
943 [80279]: https://github.com/rust-lang/rust/pull/80279
944 [80053]: https://github.com/rust-lang/rust/pull/80053
945 [79502]: https://github.com/rust-lang/rust/pull/79502
946 [75180]: https://github.com/rust-lang/rust/pull/75180
947 [79135]: https://github.com/rust-lang/rust/pull/79135
948 [81521]: https://github.com/rust-lang/rust/pull/81521
949 [80968]: https://github.com/rust-lang/rust/pull/80968
950 [80959]: https://github.com/rust-lang/rust/pull/80959
951 [80718]: https://github.com/rust-lang/rust/pull/80718
952 [80653]: https://github.com/rust-lang/rust/pull/80653
953 [80579]: https://github.com/rust-lang/rust/pull/80579
954 [79998]: https://github.com/rust-lang/rust/pull/79998
955 [78044]: https://github.com/rust-lang/rust/pull/78044
956 [81455]: https://github.com/rust-lang/rust/pull/81455
957 [80764]: https://github.com/rust-lang/rust/pull/80764
958 [80749]: https://github.com/rust-lang/rust/pull/80749
959 [80662]: https://github.com/rust-lang/rust/pull/80662
960 [79134]: https://github.com/rust-lang/rust/pull/79134
961 [80966]: https://github.com/rust-lang/rust/pull/80966
962 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
963 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
964 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
965 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
966 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
967 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
968 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
969 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
970 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
971 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
972 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
973 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
974 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
975 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
976 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
977 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
978 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
979 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
980 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
981 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
982 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
983 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
984 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
985
986 Version 1.50.0 (2021-02-11)
987 ============================
988
989 Language
990 -----------------------
991 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
992   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
993 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
994
995 Compiler
996 -----------------------
997 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
998 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
999 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1000 - [Dropped support for all cloudabi targets.][78439]
1001
1002 \* Refer to Rust's [platform support page][platform-support-doc] for more
1003 information on Rust's tiered platform support.
1004
1005 Libraries
1006 -----------------------
1007
1008 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1009 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1010 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1011   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1012   up the same amount of space as `File`.
1013
1014 Stabilized APIs
1015 ---------------
1016
1017 - [`bool::then`]
1018 - [`btree_map::Entry::or_insert_with_key`]
1019 - [`f32::clamp`]
1020 - [`f64::clamp`]
1021 - [`hash_map::Entry::or_insert_with_key`]
1022 - [`Ord::clamp`]
1023 - [`RefCell::take`]
1024 - [`slice::fill`]
1025 - [`UnsafeCell::get_mut`]
1026
1027 The following previously stable methods are now `const`.
1028
1029 - [`IpAddr::is_ipv4`]
1030 - [`IpAddr::is_ipv6`]
1031 - [`IpAddr::is_unspecified`]
1032 - [`IpAddr::is_loopback`]
1033 - [`IpAddr::is_multicast`]
1034 - [`Ipv4Addr::octets`]
1035 - [`Ipv4Addr::is_loopback`]
1036 - [`Ipv4Addr::is_private`]
1037 - [`Ipv4Addr::is_link_local`]
1038 - [`Ipv4Addr::is_multicast`]
1039 - [`Ipv4Addr::is_broadcast`]
1040 - [`Ipv4Addr::is_documentation`]
1041 - [`Ipv4Addr::to_ipv6_compatible`]
1042 - [`Ipv4Addr::to_ipv6_mapped`]
1043 - [`Ipv6Addr::segments`]
1044 - [`Ipv6Addr::is_unspecified`]
1045 - [`Ipv6Addr::is_loopback`]
1046 - [`Ipv6Addr::is_multicast`]
1047 - [`Ipv6Addr::to_ipv4`]
1048 - [`Layout::size`]
1049 - [`Layout::align`]
1050 - [`Layout::from_size_align`]
1051 - `pow` for all integer types.
1052 - `checked_pow` for all integer types.
1053 - `saturating_pow` for all integer types.
1054 - `wrapping_pow` for all integer types.
1055 - `next_power_of_two` for all unsigned integer types.
1056 - `checked_next_power_of_two` for all unsigned integer types.
1057
1058 Cargo
1059 -----------------------
1060
1061 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1062   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1063 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1064   contents of that directory for changes.][cargo/8973]
1065 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1066
1067 Misc
1068 ----
1069
1070 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1071 - [Running tests will now print the total time taken to execute.][75752]
1072
1073 Compatibility Notes
1074 -------------------
1075
1076 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1077   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1078 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1079   unhygenic `macro_rules!` macros.][79472]
1080 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1081   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1082 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1083 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1084   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1085 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1086
1087 [74989]: https://github.com/rust-lang/rust/pull/74989
1088 [79261]: https://github.com/rust-lang/rust/pull/79261
1089 [79896]: https://github.com/rust-lang/rust/pull/79896
1090 [79484]: https://github.com/rust-lang/rust/pull/79484
1091 [79472]: https://github.com/rust-lang/rust/pull/79472
1092 [79270]: https://github.com/rust-lang/rust/pull/79270
1093 [79003]: https://github.com/rust-lang/rust/pull/79003
1094 [78864]: https://github.com/rust-lang/rust/pull/78864
1095 [78636]: https://github.com/rust-lang/rust/pull/78636
1096 [78439]: https://github.com/rust-lang/rust/pull/78439
1097 [78343]: https://github.com/rust-lang/rust/pull/78343
1098 [78296]: https://github.com/rust-lang/rust/pull/78296
1099 [78068]: https://github.com/rust-lang/rust/pull/78068
1100 [75752]: https://github.com/rust-lang/rust/pull/75752
1101 [74699]: https://github.com/rust-lang/rust/pull/74699
1102 [78142]: https://github.com/rust-lang/rust/pull/78142
1103 [77484]: https://github.com/rust-lang/rust/pull/77484
1104 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1105 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1106 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1107 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1108 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1109 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1110 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1111 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1112 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1113 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1114 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1115 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1116 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1117 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1118 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1119 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1120 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1121 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1122 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1123 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1124 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1125 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1126 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1127 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1128 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1129 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1130 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1131 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1132 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1133 [`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
1134 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1135 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1136 [`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
1137 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1138
1139
1140 Version 1.49.0 (2020-12-31)
1141 ============================
1142
1143 Language
1144 -----------------------
1145
1146 - [Unions can now implement `Drop`, and you can now have a field in a union
1147   with `ManuallyDrop<T>`.][77547]
1148 - [You can now cast uninhabited enums to integers.][76199]
1149 - [You can now bind by reference and by move in patterns.][76119] This
1150   allows you to selectively borrow individual components of a type. E.g.
1151   ```rust
1152   #[derive(Debug)]
1153   struct Person {
1154       name: String,
1155       age: u8,
1156   }
1157
1158   let person = Person {
1159       name: String::from("Alice"),
1160       age: 20,
1161   };
1162
1163   // `name` is moved out of person, but `age` is referenced.
1164   let Person { name, ref age } = person;
1165   println!("{} {}", name, age);
1166   ```
1167
1168 Compiler
1169 -----------------------
1170
1171 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1172 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1173 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1174 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1175 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1176 - [Output from threads spawned in tests is now captured.][78227]
1177 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1178
1179 \* Refer to Rust's [platform support page][platform-support-doc] for more
1180 information on Rust's tiered platform support.
1181
1182 Libraries
1183 -----------------------
1184
1185 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1186 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1187
1188 Stabilized APIs
1189 ---------------
1190
1191 - [`slice::select_nth_unstable`]
1192 - [`slice::select_nth_unstable_by`]
1193 - [`slice::select_nth_unstable_by_key`]
1194
1195 The following previously stable methods are now `const`.
1196
1197 - [`Poll::is_ready`]
1198 - [`Poll::is_pending`]
1199
1200 Cargo
1201 -----------------------
1202 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1203 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1204 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1205   variable will be set if the crate being built is one the user selected to build, either
1206   with `-p` or through defaults.
1207 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1208
1209
1210 Compatibility Notes
1211 -------------------
1212
1213 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1214 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1215 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1216   Previously such invalid or unused attributes could be ignored.
1217 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1218   read [this post about the changes][rustdoc-ws-post] for more details.
1219 - [Trait bounds are no longer inferred for associated types.][79904]
1220
1221 Internal Only
1222 -------------
1223 These changes provide no direct user facing benefits, but represent significant
1224 improvements to the internals and overall performance of rustc and
1225 related tools.
1226
1227 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1228   Local Storage model.][78201]
1229 - [Calculate visibilities once in resolve.][78077]
1230 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1231 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1232
1233
1234 [75991]: https://github.com/rust-lang/rust/pull/75991
1235 [78951]: https://github.com/rust-lang/rust/pull/78951
1236 [78848]: https://github.com/rust-lang/rust/pull/78848
1237 [78746]: https://github.com/rust-lang/rust/pull/78746
1238 [78376]: https://github.com/rust-lang/rust/pull/78376
1239 [78228]: https://github.com/rust-lang/rust/pull/78228
1240 [78227]: https://github.com/rust-lang/rust/pull/78227
1241 [78201]: https://github.com/rust-lang/rust/pull/78201
1242 [78109]: https://github.com/rust-lang/rust/pull/78109
1243 [78077]: https://github.com/rust-lang/rust/pull/78077
1244 [77997]: https://github.com/rust-lang/rust/pull/77997
1245 [77703]: https://github.com/rust-lang/rust/pull/77703
1246 [77547]: https://github.com/rust-lang/rust/pull/77547
1247 [77015]: https://github.com/rust-lang/rust/pull/77015
1248 [76199]: https://github.com/rust-lang/rust/pull/76199
1249 [76119]: https://github.com/rust-lang/rust/pull/76119
1250 [75914]: https://github.com/rust-lang/rust/pull/75914
1251 [79004]: https://github.com/rust-lang/rust/pull/79004
1252 [78676]: https://github.com/rust-lang/rust/pull/78676
1253 [79904]: https://github.com/rust-lang/rust/issues/79904
1254 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1255 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1256 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1257 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1258 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1259 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1260 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1261 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1262 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1263 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1264 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1265
1266 Version 1.48.0 (2020-11-19)
1267 ==========================
1268
1269 Language
1270 --------
1271
1272 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1273   is still rejected *semantically*, but can now be parsed by procedural macros.
1274
1275 Compiler
1276 --------
1277 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1278   `rustc` whether to link its own C runtime and libraries or to rely on a external
1279   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1280 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1281   Note: If you're using cargo you must explicitly pass the `--target` flag.
1282 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1283
1284 \* Refer to Rust's [platform support page][platform-support-doc] for more
1285 information on Rust's tiered platform support.
1286
1287 Libraries
1288 ---------
1289 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1290   and `&Stderr`.][76275]
1291 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1292 - [The `matches!` macro now supports having a trailing comma.][74880]
1293 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1294 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1295
1296 Stabilized APIs
1297 ---------------
1298 - [`slice::as_ptr_range`]
1299 - [`slice::as_mut_ptr_range`]
1300 - [`VecDeque::make_contiguous`]
1301 - [`future::pending`]
1302 - [`future::ready`]
1303
1304 The following previously stable methods are now `const fn`'s:
1305
1306 - [`Option::is_some`]
1307 - [`Option::is_none`]
1308 - [`Option::as_ref`]
1309 - [`Result::is_ok`]
1310 - [`Result::is_err`]
1311 - [`Result::as_ref`]
1312 - [`Ordering::reverse`]
1313 - [`Ordering::then`]
1314
1315 Cargo
1316 -----
1317
1318 Rustdoc
1319 -------
1320 - [You can now link to items in `rustdoc` using the intra-doc link
1321   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1322   a link to `std::future`'s documentation. See ["Linking to items by
1323   name"][intradoc-links] for more information.
1324 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1325   when searching through `rustdoc`'s UI.][75740]
1326
1327 Compatibility Notes
1328 -------------------
1329 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1330   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1331   promoted to `'static` lifetime any more inside `const fn`s.
1332 - [Associated type bindings on trait objects are now verified to meet the bounds
1333   declared on the trait when checking that they implement the trait.][27675]
1334 - [When trait bounds on associated types or opaque types are ambiguous, the
1335   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1336 - [Fixed recursive nonterminals not being expanded in macros during
1337   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1338   correctly handling recursive nonterminal tokens.
1339 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1340 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1341   in places where they have no effect.][73461]
1342 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1343   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1344 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1345   disallow zero-initialization.][71274]
1346 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1347 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1348   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1349   see the [`catch_unwind`] documentation for further information.
1350
1351
1352
1353 Internal Only
1354 -------------
1355 These changes provide no direct user facing benefits, but represent significant
1356 improvements to the internals and overall performance of rustc and
1357 related tools.
1358
1359 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1360   You can continue building with `make` by setting `ninja=false` in
1361   your `config.toml`.
1362 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1363 - [Made `ensure_sufficient_stack()` non-generic][76680]
1364
1365 [78143]: https://github.com/rust-lang/rust/issues/78143
1366 [76680]: https://github.com/rust-lang/rust/pull/76680/
1367 [76030]: https://github.com/rust-lang/rust/pull/76030/
1368 [70212]: https://github.com/rust-lang/rust/pull/70212/
1369 [27675]: https://github.com/rust-lang/rust/issues/27675/
1370 [54121]: https://github.com/rust-lang/rust/issues/54121/
1371 [71274]: https://github.com/rust-lang/rust/pull/71274/
1372 [77386]: https://github.com/rust-lang/rust/pull/77386/
1373 [77153]: https://github.com/rust-lang/rust/pull/77153/
1374 [77055]: https://github.com/rust-lang/rust/pull/77055/
1375 [76275]: https://github.com/rust-lang/rust/pull/76275/
1376 [76310]: https://github.com/rust-lang/rust/pull/76310/
1377 [76420]: https://github.com/rust-lang/rust/pull/76420/
1378 [76158]: https://github.com/rust-lang/rust/pull/76158/
1379 [75857]: https://github.com/rust-lang/rust/pull/75857/
1380 [75585]: https://github.com/rust-lang/rust/pull/75585/
1381 [75740]: https://github.com/rust-lang/rust/pull/75740/
1382 [75502]: https://github.com/rust-lang/rust/pull/75502/
1383 [74880]: https://github.com/rust-lang/rust/pull/74880/
1384 [74922]: https://github.com/rust-lang/rust/pull/74922/
1385 [74430]: https://github.com/rust-lang/rust/pull/74430/
1386 [74194]: https://github.com/rust-lang/rust/pull/74194/
1387 [73461]: https://github.com/rust-lang/rust/pull/73461/
1388 [73166]: https://github.com/rust-lang/rust/pull/73166/
1389 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1390 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1391 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1392 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1393 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1394 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1395 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1396 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1397 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1398 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1399 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1400 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1401 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1402 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1403 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1404
1405
1406 Version 1.47.0 (2020-10-08)
1407 ==========================
1408
1409 Language
1410 --------
1411 - [Closures will now warn when not used.][74869]
1412
1413 Compiler
1414 --------
1415 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1416   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1417   platforms.
1418 - [Upgraded to LLVM 11.][73526]
1419 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1420 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1421 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1422
1423 \* Refer to Rust's [platform support page][platform-support-doc] for more
1424 information on Rust's tiered platform support.
1425
1426 Libraries
1427 ---------
1428 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1429 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1430   those of length less than 33.][74060]
1431 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1432 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1433   `PartialEq`, and `PartialOrd`.][73583]
1434
1435 Stabilized APIs
1436 ---------------
1437 - [`Ident::new_raw`]
1438 - [`Range::is_empty`]
1439 - [`RangeInclusive::is_empty`]
1440 - [`Result::as_deref`]
1441 - [`Result::as_deref_mut`]
1442 - [`Vec::leak`]
1443 - [`pointer::offset_from`]
1444 - [`f32::TAU`]
1445 - [`f64::TAU`]
1446
1447 The following previously stable APIs have now been made const.
1448
1449 - [The `new` method for all `NonZero` integers.][73858]
1450 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1451   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1452   methods for all integers.][73858]
1453 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1454   signed integers.][73858]
1455 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1456   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1457   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1458   `is_ascii_control` methods for `char` and `u8`.][73858]
1459
1460 Cargo
1461 -----
1462 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1463   You can override this by setting the following in your `Cargo.toml`.
1464   ```toml
1465   [profile.release.build-override]
1466   opt-level = 3
1467   ```
1468 - [`cargo-help` will now display man pages for commands rather just the
1469   `--help` text.][cargo/8456]
1470 - [`cargo-metadata` now emits a `test` field indicating if a target has
1471   tests enabled.][cargo/8478]
1472 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1473 - [`cargo-publish` will now use an alternative registry by default if it's the
1474   only registry specified in `package.publish`.][cargo/8571]
1475
1476 Misc
1477 ----
1478 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1479   type based search.][75366]
1480 - [Added the Ayu theme to rustdoc.][71237]
1481
1482 Compatibility Notes
1483 -------------------
1484 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1485 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1486 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1487   help to preserve more span information.][73084] These changes may cause
1488   compiliation errors if your macro was unhygenic or didn't correctly handle
1489   `Delimiter::None`.
1490 - [Moved support for the CloudABI target to tier 3.][75568]
1491 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1492 - [Added the `rustc-docs` component.][75560] This allows you to install
1493   and read the documentation for the compiler internal APIs. (Currently only
1494   available for `x86_64-unknown-linux-gnu`.)
1495
1496 Internal Only
1497 --------
1498
1499 - [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.
1500
1501 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1502 [75048]: https://github.com/rust-lang/rust/pull/75048/
1503 [74163]: https://github.com/rust-lang/rust/pull/74163/
1504 [71237]: https://github.com/rust-lang/rust/pull/71237/
1505 [74869]: https://github.com/rust-lang/rust/pull/74869/
1506 [73858]: https://github.com/rust-lang/rust/pull/73858/
1507 [75716]: https://github.com/rust-lang/rust/pull/75716/
1508 [75908]: https://github.com/rust-lang/rust/pull/75908/
1509 [75516]: https://github.com/rust-lang/rust/pull/75516/
1510 [75560]: https://github.com/rust-lang/rust/pull/75560/
1511 [75568]: https://github.com/rust-lang/rust/pull/75568/
1512 [75366]: https://github.com/rust-lang/rust/pull/75366/
1513 [75204]: https://github.com/rust-lang/rust/pull/75204/
1514 [74650]: https://github.com/rust-lang/rust/pull/74650/
1515 [74419]: https://github.com/rust-lang/rust/pull/74419/
1516 [73964]: https://github.com/rust-lang/rust/pull/73964/
1517 [74021]: https://github.com/rust-lang/rust/pull/74021/
1518 [74060]: https://github.com/rust-lang/rust/pull/74060/
1519 [73893]: https://github.com/rust-lang/rust/pull/73893/
1520 [73526]: https://github.com/rust-lang/rust/pull/73526/
1521 [73583]: https://github.com/rust-lang/rust/pull/73583/
1522 [73084]: https://github.com/rust-lang/rust/pull/73084/
1523 [73197]: https://github.com/rust-lang/rust/pull/73197/
1524 [72488]: https://github.com/rust-lang/rust/pull/72488/
1525 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1526 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1527 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1528 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1529 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1530 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1531 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1532 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1533 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1534 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1535 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1536 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1537 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1538 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1539 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1540
1541
1542 Version 1.46.0 (2020-08-27)
1543 ==========================
1544
1545 Language
1546 --------
1547 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1548 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1549   const functions.][73862]
1550 - [The `#[track_caller]` attribute can now be added to functions to use the
1551   function's caller's location information for panic messages.][72445]
1552 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1553   `x.0.0` over `(x.0).0`.
1554 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1555   You currently can't use `mem::transmute` in constant functions.
1556
1557 Compiler
1558 --------
1559 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1560 - [Enabled static "Position Independent Executables" by default
1561   for `x86_64-unknown-linux-musl`.][70740]
1562
1563 Libraries
1564 ---------
1565 - [`mem::forget` is now a `const fn`.][73887]
1566 - [`String` now implements `From<char>`.][73466]
1567 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1568   integer types.][73032]
1569 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1570 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1571   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1572 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1573 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1574 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1575
1576 Stabilized APIs
1577 ---------------
1578 - [`Option::zip`]
1579 - [`vec::Drain::as_slice`]
1580
1581 Cargo
1582 -----
1583 Added a number of new environment variables that are now available when
1584 compiling your crate.
1585
1586 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1587   the specific binary being compiled and the name of the crate.
1588 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1589 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1590
1591 Compatibility Notes
1592 -------------------
1593 - [The target configuration option `abi_blacklist` has been renamed
1594   to `unsupported_abis`.][74150] The old name will still continue to work.
1595 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1596   This was previously accepted but will become a hard error in a future release.
1597 - [Rustc will fail to compile if you have a struct with
1598   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1599   allowed on `enum`s.
1600 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1601   ensure that spans have the correct information, and may cause breakage if you
1602   were relying on receiving spans with dummy information.
1603 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1604   a legacy installer that was replaced by a MSI installer a few years ago but
1605   was still being built.
1606 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1607 - [Rustc will no longer accept overlapping trait implementations that only
1608   differ in how the lifetime was bound.][72493]
1609 - [Rustc now correctly relates the lifetime of an existential associated
1610   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1611   you to pass a shorter lifetime than expected.
1612 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1613   The library will need to be installed for `rustc` to work, even though we
1614   expect it to be already available on most systems.
1615 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1616   under QEMU.][74820]
1617 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1618   exact output returned by rustc's pretty printing is an unstable
1619   implementation detail: we recommend any macro relying on it to switch to a
1620   more robust parsing system.
1621
1622 [75453]: https://github.com/rust-lang/rust/issues/75453/
1623 [74820]: https://github.com/rust-lang/rust/issues/74820/
1624 [74420]: https://github.com/rust-lang/rust/issues/74420/
1625 [74109]: https://github.com/rust-lang/rust/pull/74109/
1626 [74150]: https://github.com/rust-lang/rust/pull/74150/
1627 [73862]: https://github.com/rust-lang/rust/pull/73862/
1628 [73887]: https://github.com/rust-lang/rust/pull/73887/
1629 [73466]: https://github.com/rust-lang/rust/pull/73466/
1630 [73516]: https://github.com/rust-lang/rust/pull/73516/
1631 [73293]: https://github.com/rust-lang/rust/pull/73293/
1632 [73007]: https://github.com/rust-lang/rust/pull/73007/
1633 [73032]: https://github.com/rust-lang/rust/pull/73032/
1634 [72920]: https://github.com/rust-lang/rust/pull/72920/
1635 [72569]: https://github.com/rust-lang/rust/pull/72569/
1636 [72583]: https://github.com/rust-lang/rust/pull/72583/
1637 [72584]: https://github.com/rust-lang/rust/pull/72584/
1638 [72717]: https://github.com/rust-lang/rust/pull/72717/
1639 [72437]: https://github.com/rust-lang/rust/pull/72437/
1640 [72445]: https://github.com/rust-lang/rust/pull/72445/
1641 [72486]: https://github.com/rust-lang/rust/pull/72486/
1642 [72493]: https://github.com/rust-lang/rust/pull/72493/
1643 [72331]: https://github.com/rust-lang/rust/pull/72331/
1644 [71896]: https://github.com/rust-lang/rust/pull/71896/
1645 [71660]: https://github.com/rust-lang/rust/pull/71660/
1646 [71322]: https://github.com/rust-lang/rust/pull/71322/
1647 [70740]: https://github.com/rust-lang/rust/pull/70740/
1648 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1649 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1650 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1651 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1652 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1653
1654
1655 Version 1.45.2 (2020-08-03)
1656 ==========================
1657
1658 * [Fix bindings in tuple struct patterns][74954]
1659 * [Fix track_caller integration with trait objects][74784]
1660
1661 [74954]: https://github.com/rust-lang/rust/issues/74954
1662 [74784]: https://github.com/rust-lang/rust/issues/74784
1663
1664
1665 Version 1.45.1 (2020-07-30)
1666 ==========================
1667
1668 * [Fix const propagation with references.][73613]
1669 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1670 * [Avoid spurious implicit region bound.][74509]
1671 * [Install clippy on x.py install][74457]
1672
1673 [73613]: https://github.com/rust-lang/rust/pull/73613
1674 [73078]: https://github.com/rust-lang/rust/issues/73078
1675 [74509]: https://github.com/rust-lang/rust/pull/74509
1676 [74457]: https://github.com/rust-lang/rust/pull/74457
1677
1678
1679 Version 1.45.0 (2020-07-16)
1680 ==========================
1681
1682 Language
1683 --------
1684 - [Out of range float to int conversions using `as` has been defined as a saturating
1685   conversion.][71269] This was previously undefined behaviour, but you can use the
1686    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1687    may be desirable in rare performance sensitive situations.
1688 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1689   using `u64`.][70705]
1690 - [Function like procedural macros can now be used in expression, pattern, and  statement
1691   positions.][68717] This means you can now use a function-like procedural macro
1692   anywhere you can use a declarative (`macro_rules!`) macro.
1693
1694 Compiler
1695 --------
1696 - [You can now override individual target features through the `target-feature`
1697   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1698   equivalent to `-C target-feature=+avx2,+fma`.
1699 - [Added the `force-unwind-tables` flag.][69984] This option allows
1700   rustc to always generate unwind tables regardless of panic strategy.
1701 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1702   to include LLVM bitcode into generated `rlib`s (this is on by default).
1703 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1704 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1705 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1706 - [Upgraded to LLVM 10.][67759]
1707
1708 \* Refer to Rust's [platform support page][platform-support-doc] for more
1709 information on Rust's tiered platform support.
1710
1711
1712 Libraries
1713 ---------
1714 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1715   and `Ord`.][72239]
1716 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1717 - [You can now use `char` with
1718   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1719   a range of codepoints.][72413] E.g.
1720   you can now write the following;
1721   ```rust
1722   for ch in 'a'..='z' {
1723       print!("{}", ch);
1724   }
1725   println!();
1726   // Prints "abcdefghijklmnopqrstuvwxyz"
1727   ```
1728 - [`OsString` now implements `FromStr`.][71662]
1729 - [The `saturating_neg` method has been added to all signed integer primitive
1730   types, and the `saturating_abs` method has been added for all integer
1731   primitive types.][71886]
1732 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1733   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1734   or `Path`.][71447]
1735 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1736 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1737   integer types.][69813]
1738 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1739   integer types.][72324]
1740 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1741
1742 Stabilized APIs
1743 ---------------
1744 - [`Arc::as_ptr`]
1745 - [`BTreeMap::remove_entry`]
1746 - [`Rc::as_ptr`]
1747 - [`rc::Weak::as_ptr`]
1748 - [`rc::Weak::from_raw`]
1749 - [`rc::Weak::into_raw`]
1750 - [`str::strip_prefix`]
1751 - [`str::strip_suffix`]
1752 - [`sync::Weak::as_ptr`]
1753 - [`sync::Weak::from_raw`]
1754 - [`sync::Weak::into_raw`]
1755 - [`char::UNICODE_VERSION`]
1756 - [`Span::resolved_at`]
1757 - [`Span::located_at`]
1758 - [`Span::mixed_site`]
1759 - [`unix::process::CommandExt::arg0`]
1760
1761 Cargo
1762 -----
1763
1764 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1765   time.][cargo/8066]
1766
1767 Misc
1768 ----
1769 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1770   `~~outdated information~~` becomes "~~outdated information~~".
1771 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1772
1773 Compatibility Notes
1774 -------------------
1775 - [Trying to self initialize a static value (that is creating a value using
1776   itself) is unsound and now causes a compile error.][71140]
1777 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1778   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1779 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1780   previously undocumented and not intended for public use. Rustdoc still provides
1781   a non-zero exit code on errors.
1782 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1783   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1784   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1785   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1786   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1787
1788 Internals Only
1789 --------------
1790 - [Make clippy a git subtree instead of a git submodule][70655]
1791 - [Unify the undo log of all snapshot types][69464]
1792
1793 [71848]: https://github.com/rust-lang/rust/issues/71848/
1794 [73420]: https://github.com/rust-lang/rust/issues/73420/
1795 [72324]: https://github.com/rust-lang/rust/pull/72324/
1796 [71843]: https://github.com/rust-lang/rust/pull/71843/
1797 [71886]: https://github.com/rust-lang/rust/pull/71886/
1798 [72234]: https://github.com/rust-lang/rust/pull/72234/
1799 [72239]: https://github.com/rust-lang/rust/pull/72239/
1800 [72397]: https://github.com/rust-lang/rust/pull/72397/
1801 [72413]: https://github.com/rust-lang/rust/pull/72413/
1802 [72014]: https://github.com/rust-lang/rust/pull/72014/
1803 [72062]: https://github.com/rust-lang/rust/pull/72062/
1804 [72094]: https://github.com/rust-lang/rust/pull/72094/
1805 [72133]: https://github.com/rust-lang/rust/pull/72133/
1806 [67759]: https://github.com/rust-lang/rust/pull/67759/
1807 [71900]: https://github.com/rust-lang/rust/pull/71900/
1808 [71928]: https://github.com/rust-lang/rust/pull/71928/
1809 [71662]: https://github.com/rust-lang/rust/pull/71662/
1810 [71716]: https://github.com/rust-lang/rust/pull/71716/
1811 [71447]: https://github.com/rust-lang/rust/pull/71447/
1812 [71269]: https://github.com/rust-lang/rust/pull/71269/
1813 [71095]: https://github.com/rust-lang/rust/pull/71095/
1814 [71140]: https://github.com/rust-lang/rust/pull/71140/
1815 [70655]: https://github.com/rust-lang/rust/pull/70655/
1816 [70705]: https://github.com/rust-lang/rust/pull/70705/
1817 [69984]: https://github.com/rust-lang/rust/pull/69984/
1818 [69813]: https://github.com/rust-lang/rust/pull/69813/
1819 [69464]: https://github.com/rust-lang/rust/pull/69464/
1820 [68717]: https://github.com/rust-lang/rust/pull/68717/
1821 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1822 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1823 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1824 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1825 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1826 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1827 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1828 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1829 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1830 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1831 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1832 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1833 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1834 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1835 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1836 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1837 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1838
1839
1840 Version 1.44.1 (2020-06-18)
1841 ===========================
1842
1843 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1844 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1845 * [Fix crashes when finding backtrace on macOS.][71397]
1846 * [Clippy applies lint levels into different files.][clippy/5356]
1847
1848 [71397]: https://github.com/rust-lang/rust/issues/71397
1849 [73078]: https://github.com/rust-lang/rust/issues/73078
1850 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1851 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1852
1853
1854 Version 1.44.0 (2020-06-04)
1855 ==========================
1856
1857 Language
1858 --------
1859 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1860 - [Added the `unused_braces` lint.][70081]
1861
1862 **Syntax-only changes**
1863
1864 - [Expansion-driven outline module parsing][69838]
1865 ```rust
1866 #[cfg(FALSE)]
1867 mod foo {
1868     mod bar {
1869         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1870     }
1871 }
1872 ```
1873
1874 These are still rejected semantically, so you will likely receive an error but
1875 these changes can be seen and parsed by macros and conditional compilation.
1876
1877 Compiler
1878 --------
1879 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1880   Additionally when in incremental mode rustc defaults to 256 codegen units.
1881 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1882   a panic is thrown.][67502]
1883 - [Added tier 3\* support for the `aarch64-unknown-none` and
1884   `aarch64-unknown-none-softfloat` targets.][68334]
1885 - [Added tier 3 support for `arm64-apple-tvos` and
1886   `x86_64-apple-tvos` targets.][68191]
1887
1888
1889 Libraries
1890 ---------
1891 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1892   `vec![]` to be able to be used in `const` contexts.
1893 - [`convert::Infallible` now implements `Hash`.][70281]
1894 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1895   a `&mut OsStr`.][70048]
1896 - [Unicode 13 is now supported.][69929]
1897 - [`String` now implements `From<&mut str>`.][69661]
1898 - [`IoSlice` now implements `Copy`.][69403]
1899 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1900 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1901 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1902   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1903   integer types.][69373]
1904
1905 Stabilized APIs
1906 ---------------
1907 - [`PathBuf::with_capacity`]
1908 - [`PathBuf::capacity`]
1909 - [`PathBuf::clear`]
1910 - [`PathBuf::reserve`]
1911 - [`PathBuf::reserve_exact`]
1912 - [`PathBuf::shrink_to_fit`]
1913 - [`f32::to_int_unchecked`]
1914 - [`f64::to_int_unchecked`]
1915 - [`Layout::align_to`]
1916 - [`Layout::pad_to_align`]
1917 - [`Layout::array`]
1918 - [`Layout::extend`]
1919
1920 Cargo
1921 -----
1922 - [Added the `cargo tree` command which will print a tree graph of
1923   your dependencies.][cargo/8062] E.g.
1924   ```
1925     mdbook v0.3.2 (/Users/src/rust/mdbook)
1926   ├── ammonia v3.0.0
1927   │   ├── html5ever v0.24.0
1928   │   │   ├── log v0.4.8
1929   │   │   │   └── cfg-if v0.1.9
1930   │   │   ├── mac v0.1.1
1931   │   │   └── markup5ever v0.9.0
1932   │   │       ├── log v0.4.8 (*)
1933   │   │       ├── phf v0.7.24
1934   │   │       │   └── phf_shared v0.7.24
1935   │   │       │       ├── siphasher v0.2.3
1936   │   │       │       └── unicase v1.4.2
1937   │   │       │           [build-dependencies]
1938   │   │       │           └── version_check v0.1.5
1939   ...
1940   ```
1941   You can also display dependencies on multiple versions of the same crate with
1942   `cargo tree -d` (short for `cargo tree --duplicates`).
1943
1944 Misc
1945 ----
1946 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1947   the version in the sidebar.][69494]
1948
1949 Compatibility Notes
1950 -------------------
1951 - [Rustc now correctly generates static libraries on Windows GNU targets with
1952   the `.a` extension, rather than the previous `.lib`.][70937]
1953 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1954 - [The `file_name` property in JSON output of macro errors now points the actual
1955   source file rather than the previous format of `<NAME macros>`.][70969]
1956   **Note:** this may not point to a file that actually exists on the user's system.
1957 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1958 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1959   not allow zero initialization such as `NonZeroU8`.][66059] This was
1960   previously a warning.
1961 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1962   operator has been defined as a saturating operation.][71269] This was previously
1963   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1964   continue using the current behaviour, which may be desirable in rare performance
1965   sensitive situations.
1966
1967 Internal Only
1968 -------------
1969 These changes provide no direct user facing benefits, but represent significant
1970 improvements to the internals and overall performance of rustc and
1971 related tools.
1972
1973 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1974 - [Replace big JS dict with JSON parsing.][71250]
1975
1976 [69373]: https://github.com/rust-lang/rust/pull/69373/
1977 [66059]: https://github.com/rust-lang/rust/pull/66059/
1978 [68191]: https://github.com/rust-lang/rust/pull/68191/
1979 [68899]: https://github.com/rust-lang/rust/pull/68899/
1980 [71147]: https://github.com/rust-lang/rust/pull/71147/
1981 [71250]: https://github.com/rust-lang/rust/pull/71250/
1982 [70937]: https://github.com/rust-lang/rust/pull/70937/
1983 [70969]: https://github.com/rust-lang/rust/pull/70969/
1984 [70632]: https://github.com/rust-lang/rust/pull/70632/
1985 [70281]: https://github.com/rust-lang/rust/pull/70281/
1986 [70345]: https://github.com/rust-lang/rust/pull/70345/
1987 [70048]: https://github.com/rust-lang/rust/pull/70048/
1988 [70081]: https://github.com/rust-lang/rust/pull/70081/
1989 [70156]: https://github.com/rust-lang/rust/pull/70156/
1990 [71269]: https://github.com/rust-lang/rust/pull/71269/
1991 [69838]: https://github.com/rust-lang/rust/pull/69838/
1992 [69929]: https://github.com/rust-lang/rust/pull/69929/
1993 [69661]: https://github.com/rust-lang/rust/pull/69661/
1994 [69778]: https://github.com/rust-lang/rust/pull/69778/
1995 [69494]: https://github.com/rust-lang/rust/pull/69494/
1996 [69403]: https://github.com/rust-lang/rust/pull/69403/
1997 [69033]: https://github.com/rust-lang/rust/pull/69033/
1998 [68692]: https://github.com/rust-lang/rust/pull/68692/
1999 [68334]: https://github.com/rust-lang/rust/pull/68334/
2000 [67502]: https://github.com/rust-lang/rust/pull/67502/
2001 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2002 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2003 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2004 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2005 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2006 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2007 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2008 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2009 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2010 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2011 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2012 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2013 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2014
2015
2016 Version 1.43.1 (2020-05-07)
2017 ===========================
2018
2019 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2020 * [Fixed the stabilization of AVX-512 features.][71473]
2021 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2022
2023 [71430]: https://github.com/rust-lang/rust/pull/71430
2024 [71473]: https://github.com/rust-lang/rust/issues/71473
2025 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2026
2027
2028 Version 1.43.0 (2020-04-23)
2029 ==========================
2030
2031 Language
2032 --------
2033 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2034   the type inferred correctly.][68129]
2035 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2036
2037 **Syntax only changes**
2038 - [Allow `type Foo: Ord` syntactically.][69361]
2039 - [Fuse associated and extern items up to defaultness.][69194]
2040 - [Syntactically allow `self` in all `fn` contexts.][68764]
2041 - [Merge `fn` syntax + cleanup item parsing.][68728]
2042 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2043   For example, you may now write:
2044   ```rust
2045   macro_rules! mac_trait {
2046       ($i:item) => {
2047           trait T { $i }
2048       }
2049   }
2050   mac_trait! {
2051       fn foo() {}
2052   }
2053   ```
2054
2055 These are still rejected *semantically*, so you will likely receive an error but
2056 these changes can be seen and parsed by macros and
2057 conditional compilation.
2058
2059
2060 Compiler
2061 --------
2062 - [You can now pass multiple lint flags to rustc to override the previous
2063   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2064   everything in the `unused` lint group except `unused-variables` which
2065   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2066   everything in the `unused` lint group **including** `unused-variables` since
2067   the allow flag is specified before the deny flag (and therefore overridden).
2068 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2069   if they are available on `windows-gnu`.][67429]
2070 - [rustc now buffers errors/warnings printed in JSON.][69227]
2071
2072 Libraries
2073 ---------
2074 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2075   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2076   respectively.][69538] **Note** These conversions are only available when `N`
2077   is `0..=32`.
2078 - [You can now use associated constants on floats and integers directly, rather
2079   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2080   `f32::NAN` with no imports.
2081 - [`u8::is_ascii` is now `const`.][68984]
2082 - [`String` now implements `AsMut<str>`.][68742]
2083 - [Added the `primitive` module to `std` and `core`.][67637] This module
2084   reexports Rust's primitive types. This is mainly useful in macros
2085   where you want avoid these types being shadowed.
2086 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2087 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2088
2089 Stabilized APIs
2090 ---------------
2091 - [`Once::is_completed`]
2092 - [`f32::LOG10_2`]
2093 - [`f32::LOG2_10`]
2094 - [`f64::LOG10_2`]
2095 - [`f64::LOG2_10`]
2096 - [`iter::once_with`]
2097
2098 Cargo
2099 -----
2100 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2101   your environment.][cargo/7823]
2102 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2103   executable path when running integration tests or benchmarks.][cargo/7697]
2104   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2105   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2106
2107 Misc
2108 ----
2109 - [Certain checks in the `const_err` lint were deemed unrelated to const
2110   evaluation][69185], and have been moved to the `unconditional_panic` and
2111   `arithmetic_overflow` lints.
2112
2113 Compatibility Notes
2114 -------------------
2115
2116 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2117   has been a warning since 1.36.0.
2118 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2119   led to some instances being accepted, and now correctly emits a hard error.
2120
2121 [69340]: https://github.com/rust-lang/rust/pull/69340
2122
2123 Internal Only
2124 -------------
2125 These changes provide no direct user facing benefits, but represent significant
2126 improvements to the internals and overall performance of `rustc` and
2127 related tools.
2128
2129 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2130 - [Improved how rustc generates drop code.][67332]
2131 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2132 - [traits: preallocate 2 Vecs of known initial size][69022]
2133 - [Avoid exponential behaviour when relating types][68772]
2134 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2135 - [Improve performance of coherence checks][68966]
2136 - [Deduplicate types in the generator witness][68672]
2137 - [Invert control in struct_lint_level.][68725]
2138
2139 [67332]: https://github.com/rust-lang/rust/pull/67332/
2140 [67429]: https://github.com/rust-lang/rust/pull/67429/
2141 [67637]: https://github.com/rust-lang/rust/pull/67637/
2142 [67642]: https://github.com/rust-lang/rust/pull/67642/
2143 [67878]: https://github.com/rust-lang/rust/pull/67878/
2144 [67885]: https://github.com/rust-lang/rust/pull/67885/
2145 [68129]: https://github.com/rust-lang/rust/pull/68129/
2146 [68672]: https://github.com/rust-lang/rust/pull/68672/
2147 [68725]: https://github.com/rust-lang/rust/pull/68725/
2148 [68728]: https://github.com/rust-lang/rust/pull/68728/
2149 [68738]: https://github.com/rust-lang/rust/pull/68738/
2150 [68742]: https://github.com/rust-lang/rust/pull/68742/
2151 [68764]: https://github.com/rust-lang/rust/pull/68764/
2152 [68772]: https://github.com/rust-lang/rust/pull/68772/
2153 [68943]: https://github.com/rust-lang/rust/pull/68943/
2154 [68952]: https://github.com/rust-lang/rust/pull/68952/
2155 [68966]: https://github.com/rust-lang/rust/pull/68966/
2156 [68984]: https://github.com/rust-lang/rust/pull/68984/
2157 [69022]: https://github.com/rust-lang/rust/pull/69022/
2158 [69185]: https://github.com/rust-lang/rust/pull/69185/
2159 [69194]: https://github.com/rust-lang/rust/pull/69194/
2160 [69201]: https://github.com/rust-lang/rust/pull/69201/
2161 [69227]: https://github.com/rust-lang/rust/pull/69227/
2162 [69548]: https://github.com/rust-lang/rust/pull/69548/
2163 [69256]: https://github.com/rust-lang/rust/pull/69256/
2164 [69361]: https://github.com/rust-lang/rust/pull/69361/
2165 [69366]: https://github.com/rust-lang/rust/pull/69366/
2166 [69538]: https://github.com/rust-lang/rust/pull/69538/
2167 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2168 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2169 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2170 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2171 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2172 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2173 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2174 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2175
2176
2177 Version 1.42.0 (2020-03-12)
2178 ==========================
2179
2180 Language
2181 --------
2182 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2183   ```rust
2184   fn foo(words: &[&str]) {
2185       match words {
2186           ["Hello", "World", "!", ..] => println!("Hello World!"),
2187           ["Foo", "Bar", ..] => println!("Baz"),
2188           rest => println!("{:?}", rest),
2189       }
2190   }
2191   ```
2192 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2193   that you can create an enum that has the exact layout and ABI of the type
2194   it contains.
2195 - [You can now use outer attribute procedural macros on inline modules.][64273]
2196 - [There are some *syntax-only* changes:][67131]
2197    - `default` is syntactically allowed before items in `trait` definitions.
2198    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2199      leave out their bodies in favor of `;`.
2200    - Bounds on associated types in `impl`s are now syntactically allowed
2201      (e.g. `type Foo: Ord;`).
2202    - `...` (the C-variadic type) may occur syntactically directly as the type of
2203       any function parameter.
2204
2205   These are still rejected *semantically*, so you will likely receive an error
2206   but these changes can be seen and parsed by procedural macros and
2207   conditional compilation.
2208
2209 Compiler
2210 --------
2211 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2212 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2213 - [`Option::{expect,unwrap}` and
2214    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2215    pointing to the location where they were called, rather than
2216    `core`'s internals. ][67887]
2217
2218 \* Refer to Rust's [platform support page][platform-support-doc] for more
2219 information on Rust's tiered platform support.
2220
2221 Libraries
2222 ---------
2223 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2224 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2225    to implement `Sized`.][67935]
2226 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2227 - [`Layout::new` is now `const`.][66254]
2228 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2229
2230
2231 Stabilized APIs
2232 ---------------
2233 - [`CondVar::wait_while`]
2234 - [`CondVar::wait_timeout_while`]
2235 - [`DebugMap::key`]
2236 - [`DebugMap::value`]
2237 - [`ManuallyDrop::take`]
2238 - [`matches!`]
2239 - [`ptr::slice_from_raw_parts_mut`]
2240 - [`ptr::slice_from_raw_parts`]
2241
2242 Cargo
2243 -----
2244 - [You no longer need to include `extern crate proc_macro;` to be able to
2245   `use proc_macro;` in the `2018` edition.][cargo/7700]
2246
2247 Compatibility Notes
2248 -------------------
2249 - [`Error::description` has been deprecated, and its use will now produce a
2250   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2251
2252 [68253]: https://github.com/rust-lang/rust/pull/68253/
2253 [68348]: https://github.com/rust-lang/rust/pull/68348/
2254 [67935]: https://github.com/rust-lang/rust/pull/67935/
2255 [68339]: https://github.com/rust-lang/rust/pull/68339/
2256 [68122]: https://github.com/rust-lang/rust/pull/68122/
2257 [64273]: https://github.com/rust-lang/rust/pull/64273/
2258 [67712]: https://github.com/rust-lang/rust/pull/67712/
2259 [67887]: https://github.com/rust-lang/rust/pull/67887/
2260 [67131]: https://github.com/rust-lang/rust/pull/67131/
2261 [67233]: https://github.com/rust-lang/rust/pull/67233/
2262 [66899]: https://github.com/rust-lang/rust/pull/66899/
2263 [66919]: https://github.com/rust-lang/rust/pull/66919/
2264 [66254]: https://github.com/rust-lang/rust/pull/66254/
2265 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2266 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2267 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2268 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2269 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2270 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2271 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2272 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2273 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2274
2275
2276 Version 1.41.1 (2020-02-27)
2277 ===========================
2278
2279 * [Always check types of static items][69145]
2280 * [Always check lifetime bounds of `Copy` impls][69145]
2281 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2282
2283 [69225]: https://github.com/rust-lang/rust/issues/69225
2284 [69145]: https://github.com/rust-lang/rust/pull/69145
2285
2286
2287 Version 1.41.0 (2020-01-30)
2288 ===========================
2289
2290 Language
2291 --------
2292
2293 - [You can now pass type parameters to foreign items when implementing
2294   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2295 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2296   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2297   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2298 - [You can now use any valid identifier in a `format_args` macro.][66847]
2299   Previously identifiers starting with an underscore were not allowed.
2300 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2301   enum variants.][66183] These are still rejected semantically, but
2302   can be seen and parsed by procedural macros and conditional compilation.
2303
2304 Compiler
2305 --------
2306
2307 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2308 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2309 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2310 - [You can now pass an arguments file passing the `@path` syntax
2311   to rustc.][66172] Note that the format differs somewhat from what is
2312   found in other tooling; please see [the documentation][argfile-docs] for
2313   more information.
2314 - [You can now provide `--extern` flag without a path, indicating that it is
2315   available from the search path or specified with an `-L` flag.][64882]
2316
2317 \* Refer to Rust's [platform support page][platform-support-doc] for more
2318 information on Rust's tiered platform support.
2319
2320 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2321
2322 Libraries
2323 ---------
2324
2325 - [The `core::panic` module is now stable.][66771] It was already stable
2326   through `std`.
2327 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2328   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2329 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2330
2331 Stabilized APIs
2332 ---------------
2333
2334 - [`Result::map_or`]
2335 - [`Result::map_or_else`]
2336 - [`std::rc::Weak::weak_count`]
2337 - [`std::rc::Weak::strong_count`]
2338 - [`std::sync::Weak::weak_count`]
2339 - [`std::sync::Weak::strong_count`]
2340
2341 Cargo
2342 -----
2343
2344 - [Cargo will now document all the private items for binary crates
2345   by default.][cargo/7593]
2346 - [`cargo-install` will now reinstall the package if it detects that it is out
2347   of date.][cargo/7560]
2348 - [Cargo.lock now uses a more git friendly format that should help to reduce
2349   merge conflicts.][cargo/7579]
2350 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2351   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2352   optimisation level to `2` for debug builds. You can also use
2353   `[profile.<profile>.build-override]` to override build scripts and
2354   their dependencies.
2355
2356 Misc
2357 ----
2358
2359 - [You can now specify `edition` in documentation code blocks to compile the block
2360   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2361   should be compiled the 2018 edition of Rust.
2362 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2363   current theme with `--check-theme`.][54733]
2364 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2365
2366 Compatibility Notes
2367 -------------------
2368
2369 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2370   Apple targets.][apple-32bit-drop] This means that the source code is still
2371   available to build, but the targets are no longer being tested and release
2372   binaries for those platforms will no longer be distributed by the Rust project.
2373   Please refer to the linked blog post for more information.
2374
2375 [54733]: https://github.com/rust-lang/rust/pull/54733/
2376 [61351]: https://github.com/rust-lang/rust/pull/61351/
2377 [67255]: https://github.com/rust-lang/rust/pull/67255/
2378 [66661]: https://github.com/rust-lang/rust/pull/66661/
2379 [66771]: https://github.com/rust-lang/rust/pull/66771/
2380 [66847]: https://github.com/rust-lang/rust/pull/66847/
2381 [66238]: https://github.com/rust-lang/rust/pull/66238/
2382 [66277]: https://github.com/rust-lang/rust/pull/66277/
2383 [66325]: https://github.com/rust-lang/rust/pull/66325/
2384 [66172]: https://github.com/rust-lang/rust/pull/66172/
2385 [66183]: https://github.com/rust-lang/rust/pull/66183/
2386 [65879]: https://github.com/rust-lang/rust/pull/65879/
2387 [65013]: https://github.com/rust-lang/rust/pull/65013/
2388 [64882]: https://github.com/rust-lang/rust/pull/64882/
2389 [64325]: https://github.com/rust-lang/rust/pull/64325/
2390 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2391 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2392 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2393 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2394 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2395 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2396 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2397 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2398 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2399 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2400 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2401
2402 Version 1.40.0 (2019-12-19)
2403 ===========================
2404
2405 Language
2406 --------
2407 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2408   `const` contexts.][65188] e.g.
2409
2410   ```rust
2411   pub struct Point(i32, i32);
2412
2413   const ORIGIN: Point = {
2414       let constructor = Point;
2415
2416       constructor(0, 0)
2417   };
2418   ```
2419
2420 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2421   indicate that there may be variants or fields added in the future.][64639]
2422   For example this requires adding a wild-card branch (`_ => {}`) to any match
2423   statements on a non-exhaustive `enum`. [(RFC 2008)]
2424 - [You can now use function-like procedural macros in `extern` blocks and in
2425   type positions.][63931] e.g. `type Generated = macro!();`
2426 - [Function-like and attribute procedural macros can now emit
2427   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2428 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2429   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2430   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2431
2432 Compiler
2433 --------
2434 - [Added tier 3 support\* for the
2435   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2436 - [Added tier 3 support for the
2437   `aarch64-unknown-none-softfloat` target.][64589]
2438 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2439   `mips64el-unknown-linux-muslabi64` targets.][65843]
2440
2441 \* Refer to Rust's [platform support page][platform-support-doc] for more
2442   information on Rust's tiered platform support.
2443
2444 Libraries
2445 ---------
2446 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2447
2448 Stabilized APIs
2449 ---------------
2450 - [`BTreeMap::get_key_value`]
2451 - [`HashMap::get_key_value`]
2452 - [`Option::as_deref_mut`]
2453 - [`Option::as_deref`]
2454 - [`Option::flatten`]
2455 - [`UdpSocket::peer_addr`]
2456 - [`f32::to_be_bytes`]
2457 - [`f32::to_le_bytes`]
2458 - [`f32::to_ne_bytes`]
2459 - [`f64::to_be_bytes`]
2460 - [`f64::to_le_bytes`]
2461 - [`f64::to_ne_bytes`]
2462 - [`f32::from_be_bytes`]
2463 - [`f32::from_le_bytes`]
2464 - [`f32::from_ne_bytes`]
2465 - [`f64::from_be_bytes`]
2466 - [`f64::from_le_bytes`]
2467 - [`f64::from_ne_bytes`]
2468 - [`mem::take`]
2469 - [`slice::repeat`]
2470 - [`todo!`]
2471
2472 Cargo
2473 -----
2474 - [Cargo will now always display warnings, rather than only on
2475   fresh builds.][cargo/7450]
2476 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2477   now produce an error.][cargo/7507] Previously these flags were ignored.
2478 - [You can now publish `dev-dependencies` without including
2479   a `version`.][cargo/7333]
2480
2481 Misc
2482 ----
2483 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2484   when running documentation tests with `rustdoc`.][63803]
2485
2486 Compatibility Notes
2487 -------------------
2488 - [As previously announced, any previous NLL warnings in the 2015 edition are
2489   now hard errors.][64221]
2490 - [The `include!` macro will now warn if it failed to include the
2491   entire file.][64284] The `include!` macro unintentionally only includes the
2492   first _expression_ in a file, and this can be unintuitive. This will become
2493   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2494 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2495   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2496   or `extern` blocks now correctly emits a hard error.
2497
2498 [65294]: https://github.com/rust-lang/rust/pull/65294/
2499 [66103]: https://github.com/rust-lang/rust/pull/66103/
2500 [65843]: https://github.com/rust-lang/rust/pull/65843/
2501 [65188]: https://github.com/rust-lang/rust/pull/65188/
2502 [65092]: https://github.com/rust-lang/rust/pull/65092/
2503 [64589]: https://github.com/rust-lang/rust/pull/64589/
2504 [64639]: https://github.com/rust-lang/rust/pull/64639/
2505 [64221]: https://github.com/rust-lang/rust/pull/64221/
2506 [64284]: https://github.com/rust-lang/rust/pull/64284/
2507 [63931]: https://github.com/rust-lang/rust/pull/63931/
2508 [64035]: https://github.com/rust-lang/rust/pull/64035/
2509 [63674]: https://github.com/rust-lang/rust/pull/63674/
2510 [63803]: https://github.com/rust-lang/rust/pull/63803/
2511 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2512 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2513 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2514 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2515 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2516 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2517 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2518 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2519 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2520 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2521 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2522 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2523 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2524 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2525 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2526 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2527 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2528 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2529 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2530 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2531 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2532 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2533 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2534 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2535 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2536 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2537
2538
2539 Version 1.39.0 (2019-11-07)
2540 ===========================
2541
2542 Language
2543 --------
2544 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2545   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2546 - [You can now use certain attributes on function, closure, and function pointer
2547   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2548   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2549   attributes applied to items. e.g.
2550   ```rust
2551   fn len(
2552       #[cfg(windows)] slice: &[u16],
2553       #[cfg(not(windows))] slice: &[u8],
2554   ) -> usize {
2555       slice.len()
2556   }
2557   ```
2558 - [You can now take shared references to bind-by-move patterns in the `if` guards
2559   of `match` arms.][63118] e.g.
2560   ```rust
2561   fn main() {
2562       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2563
2564       match array {
2565           nums
2566   //      ---- `nums` is bound by move.
2567               if nums.iter().sum::<u8>() == 10
2568   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2569           => {
2570               drop(nums);
2571   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2572           }
2573           _ => unreachable!(),
2574       }
2575   }
2576   ```
2577
2578
2579
2580 Compiler
2581 --------
2582 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2583 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2584 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2585   **Note** Cargo currently doesn't use this feature. Refer to
2586   [cargo#7315][cargo/7315] to track this feature's progress.
2587 - [You can now pass `--show-output` argument to test binaries to print the
2588   output of successful tests.][62600]
2589
2590
2591 \* Refer to Rust's [platform support page][platform-support-doc] for more
2592 information on Rust's tiered platform support.
2593
2594 Libraries
2595 ---------
2596 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2597 - [`LinkedList::new` is now a `const` function.][63684]
2598 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2599 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2600   now `const`.][63786]
2601
2602 Stabilized APIs
2603 ---------------
2604 - [`Pin::into_inner`]
2605 - [`Instant::checked_duration_since`]
2606 - [`Instant::saturating_duration_since`]
2607
2608 Cargo
2609 -----
2610 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2611 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2612   `--all` is now deprecated.
2613
2614 Misc
2615 ----
2616 - [You can now pass `-Clinker` to rustdoc to control the linker used
2617   for compiling doctests.][63834]
2618
2619 Compatibility Notes
2620 -------------------
2621 - [Code that was previously accepted by the old borrow checker, but rejected by
2622   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2623   previously a warning, and will also become a hard error in the Rust 2015
2624   edition in the 1.40.0 release.
2625 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2626   run tests.][63827] This should improve performance when running a large
2627   amount of doctests.
2628 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2629   recommended to use the `?` operator instead.
2630 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2631   returned `0.0`.
2632
2633 [62600]: https://github.com/rust-lang/rust/pull/62600/
2634 [62672]: https://github.com/rust-lang/rust/pull/62672/
2635 [63118]: https://github.com/rust-lang/rust/pull/63118/
2636 [63209]: https://github.com/rust-lang/rust/pull/63209/
2637 [63402]: https://github.com/rust-lang/rust/pull/63402/
2638 [63565]: https://github.com/rust-lang/rust/pull/63565/
2639 [63595]: https://github.com/rust-lang/rust/pull/63595/
2640 [63684]: https://github.com/rust-lang/rust/pull/63684/
2641 [63698]: https://github.com/rust-lang/rust/pull/63698/
2642 [63770]: https://github.com/rust-lang/rust/pull/63770/
2643 [63786]: https://github.com/rust-lang/rust/pull/63786/
2644 [63827]: https://github.com/rust-lang/rust/pull/63827/
2645 [63834]: https://github.com/rust-lang/rust/pull/63834/
2646 [63927]: https://github.com/rust-lang/rust/pull/63927/
2647 [63933]: https://github.com/rust-lang/rust/pull/63933/
2648 [63934]: https://github.com/rust-lang/rust/pull/63934/
2649 [63938]: https://github.com/rust-lang/rust/pull/63938/
2650 [63940]: https://github.com/rust-lang/rust/pull/63940/
2651 [63941]: https://github.com/rust-lang/rust/pull/63941/
2652 [63945]: https://github.com/rust-lang/rust/pull/63945/
2653 [64010]: https://github.com/rust-lang/rust/pull/64010/
2654 [64028]: https://github.com/rust-lang/rust/pull/64028/
2655 [64334]: https://github.com/rust-lang/rust/pull/64334/
2656 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2657 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2658 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2659 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2660 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2661 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2662
2663 Version 1.38.0 (2019-09-26)
2664 ==========================
2665
2666 Language
2667 --------
2668 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2669 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2670
2671 Compiler
2672 --------
2673 - [Added pipelined compilation support to `rustc`.][62766] This will
2674   improve compilation times in some cases. For further information please refer
2675   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2676 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2677   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2678   `x86_64-uwp-windows-msvc` targets.][60260]
2679 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2680   `armv7-unknown-linux-musleabi` targets.][63107]
2681 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2682 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2683 - [Upgraded to LLVM 9.][62592]
2684
2685 \* Refer to Rust's [platform support page][platform-support-doc] for more
2686 information on Rust's tiered platform support.
2687
2688 Libraries
2689 ---------
2690 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2691 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2692   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2693   is available at `std::clone::Clone`). This also makes all built-in macros
2694   available in `std`/`core` root. e.g. `std::include_bytes!`.
2695 - [`str::Chars` now implements `Debug`.][63000]
2696 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2697 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2698 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2699 - [Added euclidean remainder and division operations (`div_euclid`,
2700   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2701   `overflowing`, and `wrapping` versions are available for all
2702   integer primitives.
2703 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2704   `PartialEq`.][61491]
2705 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2706
2707 Stabilized APIs
2708 ---------------
2709 - [`<*const T>::cast`]
2710 - [`<*mut T>::cast`]
2711 - [`Duration::as_secs_f32`]
2712 - [`Duration::as_secs_f64`]
2713 - [`Duration::div_f32`]
2714 - [`Duration::div_f64`]
2715 - [`Duration::from_secs_f32`]
2716 - [`Duration::from_secs_f64`]
2717 - [`Duration::mul_f32`]
2718 - [`Duration::mul_f64`]
2719 - [`any::type_name`]
2720
2721 Cargo
2722 -----
2723 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2724 - [You can now pass the `--features` option multiple times to enable
2725   multiple features.][cargo/7084]
2726
2727 Rustdoc
2728 -------
2729
2730 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2731
2732 Misc
2733 ----
2734 - [`rustc` will now warn about some incorrect uses of
2735   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2736
2737 Compatibility Notes
2738 -------------------
2739 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2740   1.38.0.
2741 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2742   issues][62896] with certain crates such as libc.
2743
2744 [60260]: https://github.com/rust-lang/rust/pull/60260/
2745 [61457]: https://github.com/rust-lang/rust/pull/61457/
2746 [61491]: https://github.com/rust-lang/rust/pull/61491/
2747 [61884]: https://github.com/rust-lang/rust/pull/61884/
2748 [61953]: https://github.com/rust-lang/rust/pull/61953/
2749 [62042]: https://github.com/rust-lang/rust/pull/62042/
2750 [62528]: https://github.com/rust-lang/rust/pull/62528/
2751 [62583]: https://github.com/rust-lang/rust/pull/62583/
2752 [62735]: https://github.com/rust-lang/rust/pull/62735/
2753 [62766]: https://github.com/rust-lang/rust/pull/62766/
2754 [62784]: https://github.com/rust-lang/rust/pull/62784/
2755 [62592]: https://github.com/rust-lang/rust/pull/62592/
2756 [62785]: https://github.com/rust-lang/rust/issues/62785/
2757 [62814]: https://github.com/rust-lang/rust/pull/62814/
2758 [62896]: https://github.com/rust-lang/rust/issues/62896/
2759 [63000]: https://github.com/rust-lang/rust/pull/63000/
2760 [63056]: https://github.com/rust-lang/rust/pull/63056/
2761 [63107]: https://github.com/rust-lang/rust/pull/63107/
2762 [63346]: https://github.com/rust-lang/rust/pull/63346/
2763 [63421]: https://github.com/rust-lang/rust/pull/63421/
2764 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2765 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2766 [63048]: https://github.com/rust-lang/rust/pull/63048
2767 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2768 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2769 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2770 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2771 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2772 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2773 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2774 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2775 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2776 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2777 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2778 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2779 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2780
2781 Version 1.37.0 (2019-08-15)
2782 ==========================
2783
2784 Language
2785 --------
2786 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2787   [`Box`][62228], or an [array][62235] and unused.
2788 - [You can now use the `cfg` and `cfg_attr` attributes on
2789   generic parameters.][61547]
2790 - [You can now use enum variants through type alias.][61682] e.g. You can
2791   write the following:
2792   ```rust
2793   type MyOption = Option<u8>;
2794
2795   fn increment_or_zero(x: MyOption) -> u8 {
2796       match x {
2797           MyOption::Some(y) => y + 1,
2798           MyOption::None => 0,
2799       }
2800   }
2801   ```
2802 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2803   `const _: u32 = 5;`.
2804 - [You can now use `#[repr(align(X)]` on enums.][61229]
2805 - [The  `?` Kleene macro operator is now available in the
2806   2015 edition.][60932]
2807
2808 Compiler
2809 --------
2810 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2811   and `-C profile-use` flags.][61268] For more information on how to use profile
2812   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2813 - [The `rust-lldb` wrapper script should now work again.][61827]
2814
2815 Libraries
2816 ---------
2817 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2818
2819 Stabilized APIs
2820 ---------------
2821 - [`BufReader::buffer`]
2822 - [`BufWriter::buffer`]
2823 - [`Cell::from_mut`]
2824 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2825 - [`DoubleEndedIterator::nth_back`]
2826 - [`Option::xor`]
2827 - [`Wrapping::reverse_bits`]
2828 - [`i128::reverse_bits`]
2829 - [`i16::reverse_bits`]
2830 - [`i32::reverse_bits`]
2831 - [`i64::reverse_bits`]
2832 - [`i8::reverse_bits`]
2833 - [`isize::reverse_bits`]
2834 - [`slice::copy_within`]
2835 - [`u128::reverse_bits`]
2836 - [`u16::reverse_bits`]
2837 - [`u32::reverse_bits`]
2838 - [`u64::reverse_bits`]
2839 - [`u8::reverse_bits`]
2840 - [`usize::reverse_bits`]
2841
2842 Cargo
2843 -----
2844 - [`Cargo.lock` files are now included by default when publishing executable crates
2845   with executables.][cargo/7026]
2846 - [You can now specify `default-run="foo"` in `[package]` to specify the
2847   default executable to use for `cargo run`.][cargo/7056]
2848
2849 Misc
2850 ----
2851
2852 Compatibility Notes
2853 -------------------
2854 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2855   Please transition your code to using the `..=` syntax for inclusive
2856   ranges instead.
2857 - [Using a trait object without the `dyn` will now warn by default.][61203]
2858   Please transition your code to use `dyn Trait` for trait objects instead.
2859
2860 [62228]: https://github.com/rust-lang/rust/pull/62228/
2861 [62235]: https://github.com/rust-lang/rust/pull/62235/
2862 [61802]: https://github.com/rust-lang/rust/pull/61802/
2863 [61827]: https://github.com/rust-lang/rust/pull/61827/
2864 [61547]: https://github.com/rust-lang/rust/pull/61547/
2865 [61682]: https://github.com/rust-lang/rust/pull/61682/
2866 [61268]: https://github.com/rust-lang/rust/pull/61268/
2867 [61342]: https://github.com/rust-lang/rust/pull/61342/
2868 [61347]: https://github.com/rust-lang/rust/pull/61347/
2869 [61100]: https://github.com/rust-lang/rust/pull/61100/
2870 [61203]: https://github.com/rust-lang/rust/pull/61203/
2871 [61229]: https://github.com/rust-lang/rust/pull/61229/
2872 [60932]: https://github.com/rust-lang/rust/pull/60932/
2873 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2874 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2875 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2876 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2877 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2878 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2879 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2880 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2881 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2882 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2883 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2884 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2885 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2886 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2887 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2888 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2889 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2890 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2891 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2892 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2893 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2894 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2895 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2896 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2897
2898
2899 Version 1.36.0 (2019-07-04)
2900 ==========================
2901
2902 Language
2903 --------
2904 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2905 - [The order of traits in trait objects no longer affects the semantics of that
2906   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2907   `dyn fmt::Debug + Send`, where this was previously not the case.
2908
2909 Libraries
2910 ---------
2911 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2912 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2913 - [`mem::needs_drop` is now available as a const fn.][60364]
2914 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2915 - [`String` now implements `BorrowMut<str>`.][60404]
2916 - [`io::Cursor` now implements `Default`.][60234]
2917 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2918 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2919   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2920   environment has access to heap memory allocation.
2921 - [`String` now implements `From<&String>`.][59825]
2922 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2923   return a tuple of each argument when there is multiple arguments.
2924 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2925   not used.][59648]
2926
2927 Stabilized APIs
2928 ---------------
2929 - [`VecDeque::rotate_left`]
2930 - [`VecDeque::rotate_right`]
2931 - [`Iterator::copied`]
2932 - [`io::IoSlice`]
2933 - [`io::IoSliceMut`]
2934 - [`Read::read_vectored`]
2935 - [`Write::write_vectored`]
2936 - [`str::as_mut_ptr`]
2937 - [`mem::MaybeUninit`]
2938 - [`pointer::align_offset`]
2939 - [`future::Future`]
2940 - [`task::Context`]
2941 - [`task::RawWaker`]
2942 - [`task::RawWakerVTable`]
2943 - [`task::Waker`]
2944 - [`task::Poll`]
2945
2946 Cargo
2947 -----
2948 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2949 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2950
2951 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2952
2953 Clippy
2954 ------
2955 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2956
2957 Misc
2958 ----
2959
2960 Compatibility Notes
2961 -------------------
2962 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2963   longer recommended, and will be deprecated in 1.39.0.
2964
2965 [60318]: https://github.com/rust-lang/rust/pull/60318/
2966 [60364]: https://github.com/rust-lang/rust/pull/60364/
2967 [60370]: https://github.com/rust-lang/rust/pull/60370/
2968 [60404]: https://github.com/rust-lang/rust/pull/60404/
2969 [60234]: https://github.com/rust-lang/rust/pull/60234/
2970 [60244]: https://github.com/rust-lang/rust/pull/60244/
2971 [58623]: https://github.com/rust-lang/rust/pull/58623/
2972 [59648]: https://github.com/rust-lang/rust/pull/59648/
2973 [59675]: https://github.com/rust-lang/rust/pull/59675/
2974 [59825]: https://github.com/rust-lang/rust/pull/59825/
2975 [59826]: https://github.com/rust-lang/rust/pull/59826/
2976 [59445]: https://github.com/rust-lang/rust/pull/59445/
2977 [59114]: https://github.com/rust-lang/rust/pull/59114/
2978 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2979 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2980 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2981 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2982 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2983 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2984 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2985 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2986 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2987 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2988 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2989 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2990 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2991 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2992 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2993 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2994 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2995 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2996 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2997 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2998
2999
3000 Version 1.35.0 (2019-05-23)
3001 ==========================
3002
3003 Language
3004 --------
3005 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3006   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3007 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3008   ```rust
3009   unsafe fn call_unsafe(func: unsafe fn()) {
3010       func()
3011   }
3012
3013   pub fn main() {
3014       unsafe { call_unsafe(|| {}); }
3015   }
3016   ```
3017
3018
3019 Compiler
3020 --------
3021 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3022   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3023 - [Added the `wasm32-unknown-wasi` target.][59464]
3024
3025
3026 Libraries
3027 ---------
3028 - [`Thread` will now show its ID in `Debug` output.][59460]
3029 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3030 - [`alloc::System` now implements `Default`.][59451]
3031 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3032   last field.][59076]
3033 - [`char::{ToLowercase, ToUppercase}` now
3034   implement `ExactSizeIterator`.][58778]
3035 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3036 - [Removed the `Read` trait bounds
3037   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3038 - [You can now call the `dbg!` macro without any parameters to print the file
3039   and line where it is called.][57847]
3040 - [In place ASCII case conversions are now up to 4× faster.][59283]
3041   e.g. `str::make_ascii_lowercase`
3042 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3043   and `Send`.][58369]
3044
3045 Stabilized APIs
3046 ---------------
3047 - [`f32::copysign`]
3048 - [`f64::copysign`]
3049 - [`RefCell::replace_with`]
3050 - [`RefCell::map_split`]
3051 - [`ptr::hash`]
3052 - [`Range::contains`]
3053 - [`RangeFrom::contains`]
3054 - [`RangeTo::contains`]
3055 - [`RangeInclusive::contains`]
3056 - [`RangeToInclusive::contains`]
3057 - [`Option::copied`]
3058
3059 Cargo
3060 -----
3061 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3062   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3063   platform specific.
3064
3065 Misc
3066 ----
3067 - [The Rust toolchain is now available natively for musl based distros.][58575]
3068
3069 [59460]: https://github.com/rust-lang/rust/pull/59460/
3070 [59464]: https://github.com/rust-lang/rust/pull/59464/
3071 [59500]: https://github.com/rust-lang/rust/pull/59500/
3072 [59512]: https://github.com/rust-lang/rust/pull/59512/
3073 [59580]: https://github.com/rust-lang/rust/pull/59580/
3074 [59283]: https://github.com/rust-lang/rust/pull/59283/
3075 [59451]: https://github.com/rust-lang/rust/pull/59451/
3076 [59076]: https://github.com/rust-lang/rust/pull/59076/
3077 [58778]: https://github.com/rust-lang/rust/pull/58778/
3078 [58717]: https://github.com/rust-lang/rust/pull/58717/
3079 [58369]: https://github.com/rust-lang/rust/pull/58369/
3080 [58423]: https://github.com/rust-lang/rust/pull/58423/
3081 [58080]: https://github.com/rust-lang/rust/pull/58080/
3082 [57847]: https://github.com/rust-lang/rust/pull/57847/
3083 [58575]: https://github.com/rust-lang/rust/pull/58575
3084 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3085 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3086 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3087 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3088 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3089 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3090 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3091 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3092 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3093 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3094 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3095 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3096
3097 Version 1.34.2 (2019-05-14)
3098 ===========================
3099
3100 * [Destabilize the `Error::type_id` function due to a security
3101    vulnerability][60785] ([CVE-2019-12083])
3102
3103 [60785]: https://github.com/rust-lang/rust/pull/60785
3104 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3105
3106 Version 1.34.1 (2019-04-25)
3107 ===========================
3108
3109 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3110 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3111 * [Fix Clippy panic when checking some macros][clippy/3805]
3112
3113 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3114 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3115 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3116
3117 Version 1.34.0 (2019-04-11)
3118 ==========================
3119
3120 Language
3121 --------
3122 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3123   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3124   but had no effect.
3125 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3126   `#[attr{}]` procedural macros.][57367]
3127 - [You can now write `extern crate self as foo;`][57407] to import your
3128   crate's root into the extern prelude.
3129
3130
3131 Compiler
3132 --------
3133 - [You can now target `riscv64imac-unknown-none-elf` and
3134   `riscv64gc-unknown-none-elf`.][58406]
3135 - [You can now enable linker plugin LTO optimisations with
3136   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3137   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3138   boundaries.
3139 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3140
3141
3142 Libraries
3143 ---------
3144 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3145   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3146   the `Hash` trait to create an iterator.
3147 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3148   methods.][58421] Most notably you no longer require the `Ord` trait to create
3149   an iterator.
3150 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3151   for all numeric types.][58044]
3152 - [Indexing a `str` is now generic over all types that
3153   implement `SliceIndex<str>`.][57604]
3154 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3155   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3156   produce a warning if their returning type is unused.
3157 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3158   `overflowing_pow` are now available for all numeric types.][57873] These are
3159   equivalent to methods such as `wrapping_add` for the `pow` operation.
3160
3161
3162 Stabilized APIs
3163 ---------------
3164
3165 #### std & core
3166 * [`Any::type_id`]
3167 * [`Error::type_id`]
3168 * [`atomic::AtomicI16`]
3169 * [`atomic::AtomicI32`]
3170 * [`atomic::AtomicI64`]
3171 * [`atomic::AtomicI8`]
3172 * [`atomic::AtomicU16`]
3173 * [`atomic::AtomicU32`]
3174 * [`atomic::AtomicU64`]
3175 * [`atomic::AtomicU8`]
3176 * [`convert::Infallible`]
3177 * [`convert::TryFrom`]
3178 * [`convert::TryInto`]
3179 * [`iter::from_fn`]
3180 * [`iter::successors`]
3181 * [`num::NonZeroI128`]
3182 * [`num::NonZeroI16`]
3183 * [`num::NonZeroI32`]
3184 * [`num::NonZeroI64`]
3185 * [`num::NonZeroI8`]
3186 * [`num::NonZeroIsize`]
3187 * [`slice::sort_by_cached_key`]
3188 * [`str::escape_debug`]
3189 * [`str::escape_default`]
3190 * [`str::escape_unicode`]
3191 * [`str::split_ascii_whitespace`]
3192
3193 #### std
3194 * [`Instant::checked_add`]
3195 * [`Instant::checked_sub`]
3196 * [`SystemTime::checked_add`]
3197 * [`SystemTime::checked_sub`]
3198
3199 Cargo
3200 -----
3201 - [You can now use alternative registries to crates.io.][cargo/6654]
3202
3203 Misc
3204 ----
3205 - [You can now use the `?` operator in your documentation tests without manually
3206   adding `fn main() -> Result<(), _> {}`.][56470]
3207
3208 Compatibility Notes
3209 -------------------
3210 - [`Command::before_exec` is being replaced by the unsafe method
3211   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3212 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3213   can now use `const` functions in `static` variables.
3214
3215 [58370]: https://github.com/rust-lang/rust/pull/58370/
3216 [58406]: https://github.com/rust-lang/rust/pull/58406/
3217 [58421]: https://github.com/rust-lang/rust/pull/58421/
3218 [58166]: https://github.com/rust-lang/rust/pull/58166/
3219 [58044]: https://github.com/rust-lang/rust/pull/58044/
3220 [58057]: https://github.com/rust-lang/rust/pull/58057/
3221 [58059]: https://github.com/rust-lang/rust/pull/58059/
3222 [57809]: https://github.com/rust-lang/rust/pull/57809/
3223 [57873]: https://github.com/rust-lang/rust/pull/57873/
3224 [57604]: https://github.com/rust-lang/rust/pull/57604/
3225 [57367]: https://github.com/rust-lang/rust/pull/57367/
3226 [57407]: https://github.com/rust-lang/rust/pull/57407/
3227 [57425]: https://github.com/rust-lang/rust/pull/57425/
3228 [57106]: https://github.com/rust-lang/rust/pull/57106/
3229 [56470]: https://github.com/rust-lang/rust/pull/56470/
3230 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3231 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3232 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3233 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3234 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3235 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3236 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3237 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3238 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3239 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3240 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3241 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3242 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3243 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3244 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3245 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3246 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3247 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3248 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3249 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3250 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3251 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3252 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3253 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3254 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3255 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3256 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3257 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3258 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3259 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3260 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3261
3262
3263 Version 1.33.0 (2019-02-28)
3264 ==========================
3265
3266 Language
3267 --------
3268 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3269   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3270 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3271   E.g. You can have match statement on a `u8` that covers `0..=255` and
3272   you would no longer be required to have a `_ => unreachable!()` case.
3273 - [You can now have multiple patterns in `if let` and `while let`
3274   expressions.][57532] You can do this with the same syntax as a `match`
3275   expression. E.g.
3276   ```rust
3277   enum Creature {
3278       Crab(String),
3279       Lobster(String),
3280       Person(String),
3281   }
3282
3283   fn main() {
3284       let state = Creature::Crab("Ferris");
3285
3286       if let Creature::Crab(name) | Creature::Person(name) = state {
3287           println!("This creature's name is: {}", name);
3288       }
3289   }
3290   ```
3291 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3292   this feature will by default produce a warning as this behaviour can be
3293   unintuitive. E.g. `if let _ = 5 {}`
3294 - [You can now use `let` bindings, assignments, expression statements,
3295   and irrefutable pattern destructuring in const functions.][57175]
3296 - [You can now call unsafe const functions.][57067] E.g.
3297   ```rust
3298   const unsafe fn foo() -> i32 { 5 }
3299   const fn bar() -> i32 {
3300       unsafe { foo() }
3301   }
3302   ```
3303 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3304   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3305 - [You can now specify a specific alignment with the `#[repr(packed)]`
3306   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3307   with an alignment of 2 bytes and a size of 6 bytes.
3308 - [You can now import an item from a module as an `_`.][56303] This allows you to
3309   import a trait's impls, and not have the name in the namespace. E.g.
3310   ```rust
3311   use std::io::Read as _;
3312
3313   // Allowed as there is only one `Read` in the module.
3314   pub trait Read {}
3315   ```
3316 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3317
3318 Compiler
3319 --------
3320 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3321   command line argument.][56351]
3322 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3323 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3324 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3325   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3326   information on Rust's platform support.
3327 - [Added support for the `thumbv7neon-linux-androideabi` and
3328   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3329 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3330
3331 Libraries
3332 ---------
3333 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3334   functions for all numeric types.][57566]
3335 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3336   are now `const` functions for all numeric types.][57105]
3337 - [The methods `is_positive` and `is_negative` are now `const` functions for
3338   all signed numeric types.][57105]
3339 - [The `get` method for all `NonZero` types is now `const`.][57167]
3340 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3341   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3342   numeric types.][57234]
3343 - [`Ipv4Addr::new` is now a `const` function][57234]
3344
3345 Stabilized APIs
3346 ---------------
3347 - [`unix::FileExt::read_exact_at`]
3348 - [`unix::FileExt::write_all_at`]
3349 - [`Option::transpose`]
3350 - [`Result::transpose`]
3351 - [`convert::identity`]
3352 - [`pin::Pin`]
3353 - [`marker::Unpin`]
3354 - [`marker::PhantomPinned`]
3355 - [`Vec::resize_with`]
3356 - [`VecDeque::resize_with`]
3357 - [`Duration::as_millis`]
3358 - [`Duration::as_micros`]
3359 - [`Duration::as_nanos`]
3360
3361
3362 Cargo
3363 -----
3364 - [You can now publish crates that require a feature flag to compile with
3365   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3366 - [Cargo should now rebuild a crate if a file was modified during the initial
3367   build.][cargo/6484]
3368
3369 Compatibility Notes
3370 -------------------
3371 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3372   are now deprecated in the standard library, and their usage will now produce a warning.
3373   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3374   methods instead.
3375 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3376   downcasting.
3377 - [Libtest no longer creates a new thread for each test when
3378   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3379
3380 [55982]: https://github.com/rust-lang/rust/pull/55982/
3381 [56243]: https://github.com/rust-lang/rust/pull/56243
3382 [56303]: https://github.com/rust-lang/rust/pull/56303/
3383 [56351]: https://github.com/rust-lang/rust/pull/56351/
3384 [56362]: https://github.com/rust-lang/rust/pull/56362
3385 [56642]: https://github.com/rust-lang/rust/pull/56642/
3386 [56769]: https://github.com/rust-lang/rust/pull/56769/
3387 [56805]: https://github.com/rust-lang/rust/pull/56805
3388 [56947]: https://github.com/rust-lang/rust/pull/56947/
3389 [57049]: https://github.com/rust-lang/rust/pull/57049/
3390 [57067]: https://github.com/rust-lang/rust/pull/57067/
3391 [57105]: https://github.com/rust-lang/rust/pull/57105
3392 [57130]: https://github.com/rust-lang/rust/pull/57130/
3393 [57167]: https://github.com/rust-lang/rust/pull/57167/
3394 [57175]: https://github.com/rust-lang/rust/pull/57175/
3395 [57234]: https://github.com/rust-lang/rust/pull/57234/
3396 [57332]: https://github.com/rust-lang/rust/pull/57332/
3397 [57465]: https://github.com/rust-lang/rust/pull/57465/
3398 [57532]: https://github.com/rust-lang/rust/pull/57532/
3399 [57535]: https://github.com/rust-lang/rust/pull/57535/
3400 [57566]: https://github.com/rust-lang/rust/pull/57566/
3401 [57615]: https://github.com/rust-lang/rust/pull/57615/
3402 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3403 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3404 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3405 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3406 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3407 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3408 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3409 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3410 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3411 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3412 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3413 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3414 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3415 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3416 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3417 [platform-support]: https://forge.rust-lang.org/platform-support.html
3418
3419 Version 1.32.0 (2019-01-17)
3420 ==========================
3421
3422 Language
3423 --------
3424 #### 2018 edition
3425 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3426   operator allows you to specify zero or one repetitions similar to the `*` and
3427   `+` operators.
3428 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3429   now always resolve to the item (`enum`, `struct`, etc.) available in the
3430   module if present, before resolving to a external crate or an item the prelude.][56759]
3431   E.g.
3432   ```rust
3433   enum Color { Red, Green, Blue }
3434
3435   use Color::*;
3436   ```
3437
3438 #### All editions
3439 - [You can now match against `PhantomData<T>` types.][55837]
3440 - [You can now match against literals in macros with the `literal`
3441   specifier.][56072] This will match against a literal of any type.
3442   E.g. `1`, `'A'`, `"Hello World"`
3443 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3444   ```rust
3445   struct Point(i32, i32);
3446
3447   impl Point {
3448       pub fn new(x: i32, y: i32) -> Self {
3449           Self(x, y)
3450       }
3451
3452       pub fn is_origin(&self) -> bool {
3453           match self {
3454               Self(0, 0) => true,
3455               _ => false,
3456           }
3457       }
3458   }
3459   ```
3460 - [Self can also now be used in type definitions.][56366] E.g.
3461   ```rust
3462   enum List<T>
3463   where
3464       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3465   {
3466       Nil,
3467       Cons(T, Box<Self>) // likewise here
3468   }
3469   ```
3470 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3471   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3472
3473 Compiler
3474 --------
3475 - [The default allocator has changed from jemalloc to the default allocator on
3476   your system.][55238] The compiler itself on Linux & macOS will still use
3477   jemalloc, but programs compiled with it will use the system allocator.
3478 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3479
3480 Libraries
3481 ---------
3482 - [`PathBuf` now implements `FromStr`.][55148]
3483 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3484 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3485   easily debug expressions in your rust program. E.g.
3486   ```rust
3487   let a = 2;
3488   let b = dbg!(a * 2) + 1;
3489   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3490   assert_eq!(b, 5);
3491   ```
3492
3493 The following APIs are now `const` functions and can be used in a
3494 `const` context.
3495
3496 - [`Cell::as_ptr`]
3497 - [`UnsafeCell::get`]
3498 - [`char::is_ascii`]
3499 - [`iter::empty`]
3500 - [`ManuallyDrop::new`]
3501 - [`ManuallyDrop::into_inner`]
3502 - [`RangeInclusive::start`]
3503 - [`RangeInclusive::end`]
3504 - [`NonNull::as_ptr`]
3505 - [`slice::as_ptr`]
3506 - [`str::as_ptr`]
3507 - [`Duration::as_secs`]
3508 - [`Duration::subsec_millis`]
3509 - [`Duration::subsec_micros`]
3510 - [`Duration::subsec_nanos`]
3511 - [`CStr::as_ptr`]
3512 - [`Ipv4Addr::is_unspecified`]
3513 - [`Ipv6Addr::new`]
3514 - [`Ipv6Addr::octets`]
3515
3516 Stabilized APIs
3517 ---------------
3518 - [`i8::to_be_bytes`]
3519 - [`i8::to_le_bytes`]
3520 - [`i8::to_ne_bytes`]
3521 - [`i8::from_be_bytes`]
3522 - [`i8::from_le_bytes`]
3523 - [`i8::from_ne_bytes`]
3524 - [`i16::to_be_bytes`]
3525 - [`i16::to_le_bytes`]
3526 - [`i16::to_ne_bytes`]
3527 - [`i16::from_be_bytes`]
3528 - [`i16::from_le_bytes`]
3529 - [`i16::from_ne_bytes`]
3530 - [`i32::to_be_bytes`]
3531 - [`i32::to_le_bytes`]
3532 - [`i32::to_ne_bytes`]
3533 - [`i32::from_be_bytes`]
3534 - [`i32::from_le_bytes`]
3535 - [`i32::from_ne_bytes`]
3536 - [`i64::to_be_bytes`]
3537 - [`i64::to_le_bytes`]
3538 - [`i64::to_ne_bytes`]
3539 - [`i64::from_be_bytes`]
3540 - [`i64::from_le_bytes`]
3541 - [`i64::from_ne_bytes`]
3542 - [`i128::to_be_bytes`]
3543 - [`i128::to_le_bytes`]
3544 - [`i128::to_ne_bytes`]
3545 - [`i128::from_be_bytes`]
3546 - [`i128::from_le_bytes`]
3547 - [`i128::from_ne_bytes`]
3548 - [`isize::to_be_bytes`]
3549 - [`isize::to_le_bytes`]
3550 - [`isize::to_ne_bytes`]
3551 - [`isize::from_be_bytes`]
3552 - [`isize::from_le_bytes`]
3553 - [`isize::from_ne_bytes`]
3554 - [`u8::to_be_bytes`]
3555 - [`u8::to_le_bytes`]
3556 - [`u8::to_ne_bytes`]
3557 - [`u8::from_be_bytes`]
3558 - [`u8::from_le_bytes`]
3559 - [`u8::from_ne_bytes`]
3560 - [`u16::to_be_bytes`]
3561 - [`u16::to_le_bytes`]
3562 - [`u16::to_ne_bytes`]
3563 - [`u16::from_be_bytes`]
3564 - [`u16::from_le_bytes`]
3565 - [`u16::from_ne_bytes`]
3566 - [`u32::to_be_bytes`]
3567 - [`u32::to_le_bytes`]
3568 - [`u32::to_ne_bytes`]
3569 - [`u32::from_be_bytes`]
3570 - [`u32::from_le_bytes`]
3571 - [`u32::from_ne_bytes`]
3572 - [`u64::to_be_bytes`]
3573 - [`u64::to_le_bytes`]
3574 - [`u64::to_ne_bytes`]
3575 - [`u64::from_be_bytes`]
3576 - [`u64::from_le_bytes`]
3577 - [`u64::from_ne_bytes`]
3578 - [`u128::to_be_bytes`]
3579 - [`u128::to_le_bytes`]
3580 - [`u128::to_ne_bytes`]
3581 - [`u128::from_be_bytes`]
3582 - [`u128::from_le_bytes`]
3583 - [`u128::from_ne_bytes`]
3584 - [`usize::to_be_bytes`]
3585 - [`usize::to_le_bytes`]
3586 - [`usize::to_ne_bytes`]
3587 - [`usize::from_be_bytes`]
3588 - [`usize::from_le_bytes`]
3589 - [`usize::from_ne_bytes`]
3590
3591 Cargo
3592 -----
3593 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3594 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3595
3596 Misc
3597 ----
3598 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3599
3600 Compatibility Notes
3601 -------------------
3602 - [The argument types for AVX's
3603   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3604   been changed from `*const` to `*mut` as the previous implementation
3605   was unsound.
3606
3607
3608 [55148]: https://github.com/rust-lang/rust/pull/55148/
3609 [55238]: https://github.com/rust-lang/rust/pull/55238/
3610 [55280]: https://github.com/rust-lang/rust/pull/55280/
3611 [55610]: https://github.com/rust-lang/rust/pull/55610/
3612 [55663]: https://github.com/rust-lang/rust/pull/55663/
3613 [55702]: https://github.com/rust-lang/rust/pull/55702/
3614 [55837]: https://github.com/rust-lang/rust/pull/55837/
3615 [55843]: https://github.com/rust-lang/rust/pull/55843/
3616 [56072]: https://github.com/rust-lang/rust/pull/56072/
3617 [56245]: https://github.com/rust-lang/rust/pull/56245/
3618 [56365]: https://github.com/rust-lang/rust/pull/56365/
3619 [56366]: https://github.com/rust-lang/rust/pull/56366/
3620 [56395]: https://github.com/rust-lang/rust/pull/56395/
3621 [56759]: https://github.com/rust-lang/rust/pull/56759/
3622 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3623 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3624 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3625 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3626 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3627 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3628 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3629 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3630 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3631 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3632 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3633 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3634 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3635 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3636 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3637 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3638 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3639 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3640 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3641 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3642 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3643 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3644 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3645 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3646 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3647 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3648 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3649 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3650 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3651 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3652 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3653 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3654 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3655 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3656 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3657 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3658 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3659 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3660 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3661 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3662 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3663 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3664 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3665 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3666 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3667 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3668 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3669 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3670 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3671 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3672 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3673 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3674 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3675 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3676 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3677 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3678 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3679 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3680 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3681 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3682 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3683 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3684 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3685 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3686 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3687 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3688 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3689 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3690 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3691 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3692 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3693 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3694 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3695 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3696 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3697 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3698 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3699 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3700 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3701 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3702 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3703 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3704 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3705 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3706 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3707 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3708 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3709 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3710 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3711 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3712 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3713 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3714 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3715
3716
3717 Version 1.31.1 (2018-12-20)
3718 ===========================
3719
3720 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3721 - [Fix broken go-to-definition in RLS][rls/1171]
3722 - [Fix infinite loop on hover in RLS][rls/1170]
3723
3724 [56562]: https://github.com/rust-lang/rust/pull/56562
3725 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3726 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3727
3728 Version 1.31.0 (2018-12-06)
3729 ==========================
3730
3731 Language
3732 --------
3733 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3734 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3735   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3736   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3737   in structs.
3738 - [You can now define and use `const` functions.][54835] These are currently
3739   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3740   [language reference][const-reference] for what exactly is available.
3741 - [You can now use tool lints, which allow you to scope lints from external
3742   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3743 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3744   a crate, not just in exported functions.][54451]
3745 - [You can now use parentheses in pattern matches.][54497]
3746
3747 Compiler
3748 --------
3749 - [Updated musl to 1.1.20][54430]
3750
3751 Libraries
3752 ---------
3753 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3754   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3755 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3756   into `Option<&mut T>` using the `From` trait.][53218]
3757 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3758
3759
3760 Stabilized APIs
3761 ---------------
3762 - [`slice::align_to`]
3763 - [`slice::align_to_mut`]
3764 - [`slice::chunks_exact`]
3765 - [`slice::chunks_exact_mut`]
3766 - [`slice::rchunks`]
3767 - [`slice::rchunks_mut`]
3768 - [`slice::rchunks_exact`]
3769 - [`slice::rchunks_exact_mut`]
3770 - [`Option::replace`]
3771
3772 Cargo
3773 -----
3774 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3775 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3776   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3777
3778 [52813]: https://github.com/rust-lang/rust/pull/52813/
3779 [53218]: https://github.com/rust-lang/rust/pull/53218/
3780 [53555]: https://github.com/rust-lang/rust/issues/53555/
3781 [54057]: https://github.com/rust-lang/rust/pull/54057/
3782 [54240]: https://github.com/rust-lang/rust/pull/54240/
3783 [54430]: https://github.com/rust-lang/rust/pull/54430/
3784 [54451]: https://github.com/rust-lang/rust/pull/54451/
3785 [54497]: https://github.com/rust-lang/rust/pull/54497/
3786 [54778]: https://github.com/rust-lang/rust/pull/54778/
3787 [54835]: https://github.com/rust-lang/rust/pull/54835/
3788 [54870]: https://github.com/rust-lang/rust/pull/54870/
3789 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3790 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3791 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3792 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3793 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3794 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3795 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3796 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3797 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3798 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3799 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3800 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3801 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3802 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3803
3804 Version 1.30.1 (2018-11-08)
3805 ===========================
3806
3807 - [Fixed overflow ICE in rustdoc][54199]
3808 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3809
3810 [54199]: https://github.com/rust-lang/rust/pull/54199
3811 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3812
3813 Version 1.30.0 (2018-10-25)
3814 ==========================
3815
3816 Language
3817 --------
3818 - [Procedural macros are now available.][52081] These kinds of macros allow for
3819   more powerful code generation. There is a [new chapter available][proc-macros]
3820   in the Rust Programming Language book that goes further in depth.
3821 - [You can now use keywords as identifiers using the raw identifiers
3822   syntax (`r#`),][53236] e.g. `let r#for = true;`
3823 - [Using anonymous parameters in traits is now deprecated with a warning and
3824   will be a hard error in the 2018 edition.][53272]
3825 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3826   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3827 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3828   Previously, using a external crate in a module without a use statement
3829   required `let json = ::serde_json::from_str(foo);` but can now be written
3830   as `let json = serde_json::from_str(foo);`.
3831 - [You can now apply the `#[used]` attribute to static items to prevent the
3832   compiler from optimising them away, even if they appear to be unused,][51363]
3833   e.g. `#[used] static FOO: u32 = 1;`
3834 - [You can now import and reexport macros from other crates with the `use`
3835   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3836   the root module of the crate. If your macro relies on calling other local
3837   macros, it is recommended to export with the
3838   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3839   those macros.
3840 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3841   using the `vis` specifier.][53370]
3842 - [Non-macro attributes now allow all forms of literals, not just
3843   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3844   write `#[attr(true)]`.
3845 - [You can now specify a function to handle a panic in the Rust runtime with the
3846   `#[panic_handler]` attribute.][51366]
3847
3848 Compiler
3849 --------
3850 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3851 - [Added the `aarch64-unknown-netbsd` target][53165]
3852 - [Upgraded to LLVM 8.][53611]
3853
3854 Libraries
3855 ---------
3856 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3857
3858 Stabilized APIs
3859 ---------------
3860 - [`Ipv4Addr::BROADCAST`]
3861 - [`Ipv4Addr::LOCALHOST`]
3862 - [`Ipv4Addr::UNSPECIFIED`]
3863 - [`Ipv6Addr::LOCALHOST`]
3864 - [`Ipv6Addr::UNSPECIFIED`]
3865 - [`Iterator::find_map`]
3866
3867   The following methods are replacement methods for `trim_left`, `trim_right`,
3868   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3869   in 1.33.0:
3870 - [`str::trim_end_matches`]
3871 - [`str::trim_end`]
3872 - [`str::trim_start_matches`]
3873 - [`str::trim_start`]
3874
3875 Cargo
3876 ----
3877 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3878 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3879   equivalent to calling `rustdoc --error-format=json`.
3880 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3881
3882 Misc
3883 ----
3884 - [`rustdoc` allows you to specify what edition to treat your code as with the
3885   `--edition` option.][54057]
3886 - [`rustdoc` now has the `--color` (specify whether to output color) and
3887   `--error-format` (specify error format, e.g. `json`) options.][53003]
3888 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3889   debug symbols.][53774]
3890 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3891   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3892
3893 [50911]: https://github.com/rust-lang/rust/pull/50911/
3894 [51363]: https://github.com/rust-lang/rust/pull/51363/
3895 [51366]: https://github.com/rust-lang/rust/pull/51366/
3896 [52081]: https://github.com/rust-lang/rust/pull/52081/
3897 [53003]: https://github.com/rust-lang/rust/pull/53003/
3898 [53033]: https://github.com/rust-lang/rust/pull/53033/
3899 [53044]: https://github.com/rust-lang/rust/pull/53044/
3900 [53165]: https://github.com/rust-lang/rust/pull/53165/
3901 [53611]: https://github.com/rust-lang/rust/pull/53611/
3902 [53213]: https://github.com/rust-lang/rust/pull/53213/
3903 [53236]: https://github.com/rust-lang/rust/pull/53236/
3904 [53272]: https://github.com/rust-lang/rust/pull/53272/
3905 [53370]: https://github.com/rust-lang/rust/pull/53370/
3906 [53459]: https://github.com/rust-lang/rust/pull/53459/
3907 [53774]: https://github.com/rust-lang/rust/pull/53774/
3908 [53822]: https://github.com/rust-lang/rust/pull/53822/
3909 [54057]: https://github.com/rust-lang/rust/pull/54057/
3910 [54146]: https://github.com/rust-lang/rust/pull/54146/
3911 [54404]: https://github.com/rust-lang/rust/pull/54404/
3912 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3913 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3914 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3915 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3916
3917 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3918 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3919 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3920 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3921 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3922 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3923 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3924 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3925 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3926 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3927
3928
3929 Version 1.29.2 (2018-10-11)
3930 ===========================
3931
3932 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3933 - The `rls-preview` component on the windows-gnu targets has been restored.
3934
3935 [54639]: https://github.com/rust-lang/rust/pull/54639
3936
3937
3938 Version 1.29.1 (2018-09-25)
3939 ===========================
3940
3941 Security Notes
3942 --------------
3943
3944 - The standard library's `str::repeat` function contained an out of bounds write
3945   caused by an integer overflow. This has been fixed by deterministically
3946   panicking when an overflow happens.
3947
3948   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3949   us.
3950
3951
3952 Version 1.29.0 (2018-09-13)
3953 ==========================
3954
3955 Compiler
3956 --------
3957 - [Bumped minimum LLVM version to 5.0.][51899]
3958 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3959 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3960 - [Upgraded to LLVM 7.][51966]
3961
3962 Libraries
3963 ---------
3964 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3965 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3966 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3967 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3968   for `&str`.][51178]
3969 - [`Cell<T>` now allows `T` to be unsized.][50494]
3970 - [`SocketAddr` is now stable on Redox.][52656]
3971
3972 Stabilized APIs
3973 ---------------
3974 - [`Arc::downcast`]
3975 - [`Iterator::flatten`]
3976 - [`Rc::downcast`]
3977
3978 Cargo
3979 -----
3980 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3981   `--locked` to disable this behavior.
3982 - [`cargo-install` will now allow you to cross compile an install
3983   using `--target`.][cargo/5614]
3984 - [Added the `cargo-fix` subcommand to automatically move project code from
3985   2015 edition to 2018.][cargo/5723]
3986 - [`cargo doc` can now optionally document private types using the
3987   `--document-private-items` flag.][cargo/5543]
3988
3989 Misc
3990 ----
3991 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3992   the specified level to that level.][52354] For example `--cap-lints warn`
3993   will demote `deny` and `forbid` lints to `warn`.
3994 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3995   fails and `101` if there is a panic.][52197]
3996 - [A preview of clippy has been made available through rustup.][51122]
3997   You can install the preview with `rustup component add clippy-preview`.
3998
3999 Compatibility Notes
4000 -------------------
4001 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4002   Use `str::get_unchecked(begin..end)` instead.
4003 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4004   Consider using the `home_dir` function from
4005   https://crates.io/crates/dirs instead.
4006 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4007 - [`cfg` attributes and `--cfg` command line flags are now more
4008   strictly validated.][53893]
4009
4010 [53893]: https://github.com/rust-lang/rust/pull/53893/
4011 [52861]: https://github.com/rust-lang/rust/pull/52861/
4012 [51966]: https://github.com/rust-lang/rust/pull/51966/
4013 [52656]: https://github.com/rust-lang/rust/pull/52656/
4014 [52239]: https://github.com/rust-lang/rust/pull/52239/
4015 [52330]: https://github.com/rust-lang/rust/pull/52330/
4016 [52354]: https://github.com/rust-lang/rust/pull/52354/
4017 [52402]: https://github.com/rust-lang/rust/pull/52402/
4018 [52103]: https://github.com/rust-lang/rust/pull/52103/
4019 [52197]: https://github.com/rust-lang/rust/pull/52197/
4020 [51807]: https://github.com/rust-lang/rust/pull/51807/
4021 [51899]: https://github.com/rust-lang/rust/pull/51899/
4022 [51912]: https://github.com/rust-lang/rust/pull/51912/
4023 [51511]: https://github.com/rust-lang/rust/pull/51511/
4024 [51619]: https://github.com/rust-lang/rust/pull/51619/
4025 [51656]: https://github.com/rust-lang/rust/pull/51656/
4026 [51178]: https://github.com/rust-lang/rust/pull/51178/
4027 [51122]: https://github.com/rust-lang/rust/pull/51122
4028 [50494]: https://github.com/rust-lang/rust/pull/50494/
4029 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4030 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4031 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4032 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4033 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4034 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4035 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4036
4037
4038 Version 1.28.0 (2018-08-02)
4039 ===========================
4040
4041 Language
4042 --------
4043 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4044   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4045   the inner type across Foreign Function Interface (FFI) boundaries.
4046 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4047   and can now be used as identifiers.][51196]
4048 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4049   stable.][51241] This will allow users to specify a global allocator for
4050   their program.
4051 - [Unit test functions marked with the `#[test]` attribute can now return
4052   `Result<(), E: Debug>` in addition to `()`.][51298]
4053 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4054   allows macros to easily target lifetimes.
4055
4056 Compiler
4057 --------
4058 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4059   prioritise making smaller binary sizes. `z` is the same as `s` with the
4060   exception that it does not vectorise loops, which typically results in an even
4061   smaller binary.
4062 - [The short error format is now stable.][49546] Specified with
4063   `--error-format=short` this option will provide a more compressed output of
4064   rust error messages.
4065 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4066 - [Reduced the number of allocations in the macro parser.][50855] This can
4067   improve compile times of macro heavy crates on average by 5%.
4068
4069 Libraries
4070 ---------
4071 - [Implemented `Default` for `&mut str`.][51306]
4072 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4073 - [Implemented `Extend` for `()`.][50234]
4074 - [The `Debug` implementation of `time::Duration` should now be more easily
4075   human readable.][50364] Previously a `Duration` of one second would printed as
4076   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4077 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4078   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4079   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4080   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4081   for `PathBuf`.][50170]
4082 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4083   and `Wrapping<i128>`.][50465]
4084 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4085   possible.][51050] This can provide up to a 40% speed increase.
4086 - [Improved error messages when using `format!`.][50610]
4087
4088 Stabilized APIs
4089 ---------------
4090 - [`Iterator::step_by`]
4091 - [`Path::ancestors`]
4092 - [`SystemTime::UNIX_EPOCH`]
4093 - [`alloc::GlobalAlloc`]
4094 - [`alloc::Layout`]
4095 - [`alloc::LayoutErr`]
4096 - [`alloc::System`]
4097 - [`alloc::alloc`]
4098 - [`alloc::alloc_zeroed`]
4099 - [`alloc::dealloc`]
4100 - [`alloc::realloc`]
4101 - [`alloc::handle_alloc_error`]
4102 - [`btree_map::Entry::or_default`]
4103 - [`fmt::Alignment`]
4104 - [`hash_map::Entry::or_default`]
4105 - [`iter::repeat_with`]
4106 - [`num::NonZeroUsize`]
4107 - [`num::NonZeroU128`]
4108 - [`num::NonZeroU16`]
4109 - [`num::NonZeroU32`]
4110 - [`num::NonZeroU64`]
4111 - [`num::NonZeroU8`]
4112 - [`ops::RangeBounds`]
4113 - [`slice::SliceIndex`]
4114 - [`slice::from_mut`]
4115 - [`slice::from_ref`]
4116 - [`{Any + Send + Sync}::downcast_mut`]
4117 - [`{Any + Send + Sync}::downcast_ref`]
4118 - [`{Any + Send + Sync}::is`]
4119
4120 Cargo
4121 -----
4122 - [Cargo will now no longer allow you to publish crates with build scripts that
4123   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4124   considered to be immutable.
4125
4126 Misc
4127 ----
4128 - [The `suggestion_applicability` field in `rustc`'s json output is now
4129   stable.][50486] This will allow dev tools to check whether a code suggestion
4130   would apply to them.
4131
4132 Compatibility Notes
4133 -------------------
4134 - [Rust will consider trait objects with duplicated constraints to be the same
4135   type as without the duplicated constraint.][51276] For example the below code will
4136   now fail to compile.
4137   ```rust
4138   trait Trait {}
4139
4140   impl Trait + Send {
4141       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4142   }
4143
4144   impl Trait + Send + Send {
4145       fn test(&self) { println!("two"); }
4146   }
4147   ```
4148
4149 [49546]: https://github.com/rust-lang/rust/pull/49546/
4150 [50143]: https://github.com/rust-lang/rust/pull/50143/
4151 [50170]: https://github.com/rust-lang/rust/pull/50170/
4152 [50234]: https://github.com/rust-lang/rust/pull/50234/
4153 [50265]: https://github.com/rust-lang/rust/pull/50265/
4154 [50364]: https://github.com/rust-lang/rust/pull/50364/
4155 [50385]: https://github.com/rust-lang/rust/pull/50385/
4156 [50465]: https://github.com/rust-lang/rust/pull/50465/
4157 [50486]: https://github.com/rust-lang/rust/pull/50486/
4158 [50554]: https://github.com/rust-lang/rust/pull/50554/
4159 [50610]: https://github.com/rust-lang/rust/pull/50610/
4160 [50855]: https://github.com/rust-lang/rust/pull/50855/
4161 [51050]: https://github.com/rust-lang/rust/pull/51050/
4162 [51196]: https://github.com/rust-lang/rust/pull/51196/
4163 [51200]: https://github.com/rust-lang/rust/pull/51200/
4164 [51241]: https://github.com/rust-lang/rust/pull/51241/
4165 [51276]: https://github.com/rust-lang/rust/pull/51276/
4166 [51298]: https://github.com/rust-lang/rust/pull/51298/
4167 [51306]: https://github.com/rust-lang/rust/pull/51306/
4168 [51562]: https://github.com/rust-lang/rust/pull/51562/
4169 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4170 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4171 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4172 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4173 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4174 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4175 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4176 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4177 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4178 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4179 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4180 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4181 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4182 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4183 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4184 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4185 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4186 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4187 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4188 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4189 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4190 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4191 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4192 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4193 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4194 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4195 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4196 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4197 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4198 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4199
4200 Version 1.27.2 (2018-07-20)
4201 ===========================
4202
4203 Compatibility Notes
4204 -------------------
4205
4206 - The borrow checker was fixed to avoid potential unsoundness when using
4207   match ergonomics: [#52213][52213].
4208
4209 [52213]: https://github.com/rust-lang/rust/issues/52213
4210
4211 Version 1.27.1 (2018-07-10)
4212 ===========================
4213
4214 Security Notes
4215 --------------
4216
4217 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4218   when running, which enabled executing code as some other user on a
4219   given machine. This release fixes that vulnerability; you can read
4220   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4221
4222   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4223
4224 Compatibility Notes
4225 -------------------
4226
4227 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4228   match ergonomics: [#51415][51415], [#49534][49534].
4229
4230 [51415]: https://github.com/rust-lang/rust/issues/51415
4231 [49534]: https://github.com/rust-lang/rust/issues/49534
4232 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4233 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4234
4235 Version 1.27.0 (2018-06-21)
4236 ==========================
4237
4238 Language
4239 --------
4240 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4241   be used as an identifier.
4242 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4243   bare `Trait` syntax, and should make it clearer when being used in tandem with
4244   `impl Trait` because it is equivalent to the following syntax:
4245   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4246   `Box<Trait> == Box<dyn Trait>`.
4247 - [Attributes on generic parameters such as types and lifetimes are
4248   now stable.][48851] e.g.
4249   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4250 - [The `#[must_use]` attribute can now also be used on functions as well as
4251   types.][48925] It provides a lint that by default warns users when the
4252   value returned by a function has not been used.
4253
4254 Compiler
4255 --------
4256 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4257
4258 Libraries
4259 ---------
4260 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4261   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4262   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4263   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4264   the `cfg` attribute.
4265 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4266   std are now available in core.][49896]
4267 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4268   to `Self`.][49630]
4269 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4270   that the operation isn't done in place.
4271 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4272   the `#[must_use]` attribute][49533] to warn about unused potentially
4273   expensive allocations.
4274
4275 Stabilized APIs
4276 ---------------
4277 - [`DoubleEndedIterator::rfind`]
4278 - [`DoubleEndedIterator::rfold`]
4279 - [`DoubleEndedIterator::try_rfold`]
4280 - [`Duration::from_micros`]
4281 - [`Duration::from_nanos`]
4282 - [`Duration::subsec_micros`]
4283 - [`Duration::subsec_millis`]
4284 - [`HashMap::remove_entry`]
4285 - [`Iterator::try_fold`]
4286 - [`Iterator::try_for_each`]
4287 - [`NonNull::cast`]
4288 - [`Option::filter`]
4289 - [`String::replace_range`]
4290 - [`Take::set_limit`]
4291 - [`hint::unreachable_unchecked`]
4292 - [`os::unix::process::parent_id`]
4293 - [`ptr::swap_nonoverlapping`]
4294 - [`slice::rsplit_mut`]
4295 - [`slice::rsplit`]
4296 - [`slice::swap_with_slice`]
4297
4298 Cargo
4299 -----
4300 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4301   `readme`, and `repository` fields.][cargo/5386]
4302 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4303 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4304   a different directory than `target` for placing compilation artifacts.
4305 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4306   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4307   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4308   where cargo would infer a binary, Cargo will produce a warning. You can
4309   disable this feature ahead of time by setting any of the following to false:
4310   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4311 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4312   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4313
4314 Misc
4315 ----
4316 - [Added “The Rustc book” into the official documentation.][49707]
4317   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4318 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4319
4320 Compatibility Notes
4321 -------------------
4322 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4323   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4324   compile, `"".is_empty()` will still compile.
4325 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4326   will only print the inner type.][48553] E.g.
4327   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4328   not `AtomicBool(true)`.
4329 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4330   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4331   alignment should cover all use cases.
4332 - The `.description()` method on the `std::error::Error` trait
4333   [has been soft-deprecated][50163]. It is no longer required to implement it.
4334
4335 [48553]: https://github.com/rust-lang/rust/pull/48553/
4336 [48851]: https://github.com/rust-lang/rust/pull/48851/
4337 [48925]: https://github.com/rust-lang/rust/pull/48925/
4338 [49533]: https://github.com/rust-lang/rust/pull/49533/
4339 [49623]: https://github.com/rust-lang/rust/pull/49623/
4340 [49630]: https://github.com/rust-lang/rust/pull/49630/
4341 [49664]: https://github.com/rust-lang/rust/pull/49664/
4342 [49699]: https://github.com/rust-lang/rust/pull/49699/
4343 [49707]: https://github.com/rust-lang/rust/pull/49707/
4344 [49719]: https://github.com/rust-lang/rust/pull/49719/
4345 [49896]: https://github.com/rust-lang/rust/pull/49896/
4346 [49968]: https://github.com/rust-lang/rust/pull/49968/
4347 [50163]: https://github.com/rust-lang/rust/pull/50163
4348 [50177]: https://github.com/rust-lang/rust/pull/50177/
4349 [50378]: https://github.com/rust-lang/rust/pull/50378/
4350 [50398]: https://github.com/rust-lang/rust/pull/50398/
4351 [50423]: https://github.com/rust-lang/rust/pull/50423/
4352 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4353 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4354 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4355 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4356 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4357 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4358 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4359 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4360 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4361 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4362 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4363 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4364 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4365 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4366 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4367 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4368 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4369 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4370 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4371 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4372 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4373 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4374 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4375 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4376 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4377 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4378 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4379 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4380 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4381 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4382
4383
4384 Version 1.26.2 (2018-06-05)
4385 ==========================
4386
4387 Compatibility Notes
4388 -------------------
4389
4390 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4391
4392 [51117]: https://github.com/rust-lang/rust/issues/51117
4393
4394
4395 Version 1.26.1 (2018-05-29)
4396 ==========================
4397
4398 Tools
4399 -----
4400
4401 - [RLS now works on Windows.][50646]
4402 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4403
4404
4405 Compatibility Notes
4406 --------
4407
4408 - [`fn main() -> impl Trait` no longer works for non-Termination
4409   trait.][50656]
4410   This reverts an accidental stabilization.
4411 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4412 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4413
4414 [50646]: https://github.com/rust-lang/rust/issues/50646
4415 [50656]: https://github.com/rust-lang/rust/pull/50656
4416 [50812]: https://github.com/rust-lang/rust/pull/50812
4417 [50950]: https://github.com/rust-lang/rust/issues/50950
4418 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4419
4420 Version 1.26.0 (2018-05-10)
4421 ==========================
4422
4423 Language
4424 --------
4425 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4426   implement either or both traits.][49299]
4427 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4428 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4429   lifetime can be elided.][49458]
4430 - [`impl Trait` is now stable allowing you to have abstract types in returns
4431    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4432   `fn open(path: impl AsRef<Path>)`.
4433 - [Pattern matching will now automatically apply dereferences.][49394]
4434 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4435 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4436 - [A lot of operations are now available in a const context.][46882] E.g. You
4437   can now index into constant arrays, reference and dereference into constants,
4438   and use tuple struct constructors.
4439 - [Fixed entry slice patterns are now stable.][48516] E.g.
4440   ```rust
4441   let points = [1, 2, 3, 4];
4442   match points {
4443       [1, 2, 3, 4] => println!("All points were sequential."),
4444       _ => println!("Not all points were sequential."),
4445   }
4446   ```
4447
4448
4449 Compiler
4450 --------
4451 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4452 - [Fixed exponential projection complexity on nested types.][48296]
4453   This can provide up to a ~12% reduction in compile times for certain crates.
4454 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4455   to remap path prefixes outputted by the compiler.
4456 - [Added `powerpc-unknown-netbsd` target.][48281]
4457
4458 Libraries
4459 ---------
4460 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4461 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4462   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4463 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4464 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4465 - [`ascii::escape_default` is now available in libcore.][48735]
4466 - [Trailing commas are now supported in std and core macros.][48056]
4467 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4468 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4469
4470 Stabilized APIs
4471 ---------------
4472 - [`*const T::add`]
4473 - [`*const T::copy_to_nonoverlapping`]
4474 - [`*const T::copy_to`]
4475 - [`*const T::read_unaligned`]
4476 - [`*const T::read_volatile`]
4477 - [`*const T::read`]
4478 - [`*const T::sub`]
4479 - [`*const T::wrapping_add`]
4480 - [`*const T::wrapping_sub`]
4481 - [`*mut T::add`]
4482 - [`*mut T::copy_to_nonoverlapping`]
4483 - [`*mut T::copy_to`]
4484 - [`*mut T::read_unaligned`]
4485 - [`*mut T::read_volatile`]
4486 - [`*mut T::read`]
4487 - [`*mut T::replace`]
4488 - [`*mut T::sub`]
4489 - [`*mut T::swap`]
4490 - [`*mut T::wrapping_add`]
4491 - [`*mut T::wrapping_sub`]
4492 - [`*mut T::write_bytes`]
4493 - [`*mut T::write_unaligned`]
4494 - [`*mut T::write_volatile`]
4495 - [`*mut T::write`]
4496 - [`Box::leak`]
4497 - [`FromUtf8Error::as_bytes`]
4498 - [`LocalKey::try_with`]
4499 - [`Option::cloned`]
4500 - [`btree_map::Entry::and_modify`]
4501 - [`fs::read_to_string`]
4502 - [`fs::read`]
4503 - [`fs::write`]
4504 - [`hash_map::Entry::and_modify`]
4505 - [`iter::FusedIterator`]
4506 - [`ops::RangeInclusive`]
4507 - [`ops::RangeToInclusive`]
4508 - [`process::id`]
4509 - [`slice::rotate_left`]
4510 - [`slice::rotate_right`]
4511 - [`String::retain`]
4512
4513
4514 Cargo
4515 -----
4516 - [Cargo will now output path to custom commands when `-v` is
4517   passed with `--list`][cargo/5041]
4518 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4519
4520 Misc
4521 ----
4522 - [The second edition of "The Rust Programming Language" book is now recommended
4523   over the first.][48404]
4524
4525 Compatibility Notes
4526 -------------------
4527
4528 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4529   syntax is now invalid.
4530   ```
4531   use std::ops::Fn as dyn;
4532   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4533   ```
4534 - [The result of dereferences are no longer promoted to `'static`.][47408]
4535   e.g.
4536   ```rust
4537   fn main() {
4538       const PAIR: &(i32, i32) = &(0, 1);
4539       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4540   }
4541   ```
4542 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4543 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4544   an error.][48235]
4545 - [Removed hoedown from rustdoc.][48274]
4546 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4547
4548 [46882]: https://github.com/rust-lang/rust/pull/46882
4549 [47379]: https://github.com/rust-lang/rust/pull/47379
4550 [47408]: https://github.com/rust-lang/rust/pull/47408
4551 [47813]: https://github.com/rust-lang/rust/pull/47813
4552 [48056]: https://github.com/rust-lang/rust/pull/48056
4553 [48125]: https://github.com/rust-lang/rust/pull/48125
4554 [48166]: https://github.com/rust-lang/rust/pull/48166
4555 [48235]: https://github.com/rust-lang/rust/pull/48235
4556 [48274]: https://github.com/rust-lang/rust/pull/48274
4557 [48281]: https://github.com/rust-lang/rust/pull/48281
4558 [48296]: https://github.com/rust-lang/rust/pull/48296
4559 [48326]: https://github.com/rust-lang/rust/pull/48326
4560 [48359]: https://github.com/rust-lang/rust/pull/48359
4561 [48404]: https://github.com/rust-lang/rust/pull/48404
4562 [48481]: https://github.com/rust-lang/rust/pull/48481
4563 [48516]: https://github.com/rust-lang/rust/pull/48516
4564 [48628]: https://github.com/rust-lang/rust/pull/48628
4565 [48629]: https://github.com/rust-lang/rust/pull/48629
4566 [48657]: https://github.com/rust-lang/rust/pull/48657
4567 [48735]: https://github.com/rust-lang/rust/pull/48735
4568 [48978]: https://github.com/rust-lang/rust/pull/48978
4569 [49101]: https://github.com/rust-lang/rust/pull/49101
4570 [49109]: https://github.com/rust-lang/rust/pull/49109
4571 [49121]: https://github.com/rust-lang/rust/pull/49121
4572 [49162]: https://github.com/rust-lang/rust/pull/49162
4573 [49184]: https://github.com/rust-lang/rust/pull/49184
4574 [49234]: https://github.com/rust-lang/rust/pull/49234
4575 [49255]: https://github.com/rust-lang/rust/pull/49255
4576 [49299]: https://github.com/rust-lang/rust/pull/49299
4577 [49305]: https://github.com/rust-lang/rust/pull/49305
4578 [49394]: https://github.com/rust-lang/rust/pull/49394
4579 [49458]: https://github.com/rust-lang/rust/pull/49458
4580 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4581 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4582 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4583 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4584 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4585 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4586 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4587 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4588 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4589 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4590 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4591 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4592 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4593 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4594 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4595 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4596 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4597 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4598 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4599 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4600 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4601 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4602 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4603 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4604 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4605 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4606 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4607 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4608 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4609 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4610 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4611 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4612 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4613 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4614 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4615 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4616 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4617 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4618 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4619 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4620 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4621 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4622
4623
4624 Version 1.25.0 (2018-03-29)
4625 ==========================
4626
4627 Language
4628 --------
4629 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4630 - [You can now use nested groups of imports.][47948]
4631   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4632 - [You can now have `|` at the start of a match arm.][47947] e.g.
4633 ```rust
4634 enum Foo { A, B, C }
4635
4636 fn main() {
4637     let x = Foo::A;
4638     match x {
4639         | Foo::A
4640         | Foo::B => println!("AB"),
4641         | Foo::C => println!("C"),
4642     }
4643 }
4644 ```
4645
4646 Compiler
4647 --------
4648 - [Upgraded to LLVM 6.][47828]
4649 - [Added `-C lto=val` option.][47521]
4650 - [Added `i586-unknown-linux-musl` target][47282]
4651
4652 Libraries
4653 ---------
4654 - [Impl Send for `process::Command` on Unix.][47760]
4655 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4656 - [`UnsafeCell::into_inner` is now safe.][47204]
4657 - [Implement libstd for CloudABI.][47268]
4658 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4659 - [Implement `AsRef<Path>` for Component][46985]
4660 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4661 - [Moved `Duration` to libcore.][46666]
4662
4663 Stabilized APIs
4664 ---------------
4665 - [`Location::column`]
4666 - [`ptr::NonNull`]
4667
4668 The following functions can now be used in a constant expression.
4669 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4670 - [`Duration::new`][47300]
4671 - [`Duration::from_secs`][47300]
4672 - [`Duration::from_millis`][47300]
4673
4674 Cargo
4675 -----
4676 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4677 - [`cargo new` now defaults to creating a binary crate, instead of a
4678   library crate.][cargo/5029]
4679
4680 Misc
4681 ----
4682 - [Rust by example is now shipped with new releases][46196]
4683
4684 Compatibility Notes
4685 -------------------
4686 - [Deprecated `net::lookup_host`.][47510]
4687 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4688 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4689   around indexing operations (see [#47349][47349]). This has been fixed (which also
4690   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4691 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4692
4693 [33903]: https://github.com/rust-lang/rust/pull/33903
4694 [47947]: https://github.com/rust-lang/rust/pull/47947
4695 [47948]: https://github.com/rust-lang/rust/pull/47948
4696 [47760]: https://github.com/rust-lang/rust/pull/47760
4697 [47790]: https://github.com/rust-lang/rust/pull/47790
4698 [47828]: https://github.com/rust-lang/rust/pull/47828
4699 [47398]: https://github.com/rust-lang/rust/pull/47398
4700 [47510]: https://github.com/rust-lang/rust/pull/47510
4701 [47521]: https://github.com/rust-lang/rust/pull/47521
4702 [47204]: https://github.com/rust-lang/rust/pull/47204
4703 [47251]: https://github.com/rust-lang/rust/pull/47251
4704 [47268]: https://github.com/rust-lang/rust/pull/47268
4705 [47282]: https://github.com/rust-lang/rust/pull/47282
4706 [47300]: https://github.com/rust-lang/rust/pull/47300
4707 [47349]: https://github.com/rust-lang/rust/pull/47349
4708 [46931]: https://github.com/rust-lang/rust/pull/46931
4709 [46985]: https://github.com/rust-lang/rust/pull/46985
4710 [47006]: https://github.com/rust-lang/rust/pull/47006
4711 [46830]: https://github.com/rust-lang/rust/pull/46830
4712 [46095]: https://github.com/rust-lang/rust/pull/46095
4713 [46666]: https://github.com/rust-lang/rust/pull/46666
4714 [46196]: https://github.com/rust-lang/rust/pull/46196
4715 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4716 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4717 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4718 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4719 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4720
4721
4722 Version 1.24.1 (2018-03-01)
4723 ==========================
4724
4725  - [Do not abort when unwinding through FFI][48251]
4726  - [Emit UTF-16 files for linker arguments on Windows][48318]
4727  - [Make the error index generator work again][48308]
4728  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4729
4730 [48251]: https://github.com/rust-lang/rust/issues/48251
4731 [48308]: https://github.com/rust-lang/rust/issues/48308
4732 [48318]: https://github.com/rust-lang/rust/issues/48318
4733 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4734
4735
4736 Version 1.24.0 (2018-02-15)
4737 ==========================
4738
4739 Language
4740 --------
4741 - [External `sysv64` ffi is now available.][46528]
4742   eg. `extern "sysv64" fn foo () {}`
4743
4744 Compiler
4745 --------
4746 - [rustc now uses 16 codegen units by default for release builds.][46910]
4747   For the fastest builds, utilize `codegen-units=1`.
4748 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4749 - [Add `aarch64-unknown-openbsd` support][46760]
4750
4751 Libraries
4752 ---------
4753 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4754   improvement in performance in the majority of cases.
4755 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4756   with Windows.][46798]
4757 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4758 - [impl `From<bool>` for `AtomicBool`][46293]
4759 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4760 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4761 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4762 - [float::from_bits now just uses transmute.][46012] This provides
4763   some optimisations from LLVM.
4764 - [Copied `AsciiExt` methods onto `char`][46077]
4765 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4766 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4767 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4768 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4769
4770 Stabilized APIs
4771 ---------------
4772 - [`RefCell::replace`]
4773 - [`RefCell::swap`]
4774 - [`atomic::spin_loop_hint`]
4775
4776 The following functions can now be used in a constant expression.
4777 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4778
4779 - [`AtomicBool::new`][46287]
4780 - [`AtomicUsize::new`][46287]
4781 - [`AtomicIsize::new`][46287]
4782 - [`AtomicPtr::new`][46287]
4783 - [`Cell::new`][46287]
4784 - [`{integer}::min_value`][46287]
4785 - [`{integer}::max_value`][46287]
4786 - [`mem::size_of`][46287]
4787 - [`mem::align_of`][46287]
4788 - [`ptr::null`][46287]
4789 - [`ptr::null_mut`][46287]
4790 - [`RefCell::new`][46287]
4791 - [`UnsafeCell::new`][46287]
4792
4793 Cargo
4794 -----
4795 - [Added a `workspace.default-members` config that
4796   overrides implied `--all` in virtual workspaces.][cargo/4743]
4797 - [Enable incremental by default on development builds.][cargo/4817] Also added
4798   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4799   per-project or global basis respectively.
4800
4801 Misc
4802 ----
4803
4804 Compatibility Notes
4805 -------------------
4806 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4807 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4808   in accordance with IETF RFC 4291 §2.2.
4809 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4810 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4811   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4812 - [Leading zeros in tuple struct members is now an error][47084]
4813 - [`column!()` macro is one-based instead of zero-based][46977]
4814 - [`fmt::Arguments` can no longer be shared across threads][45198]
4815 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4816 - [Cargo sets a different working directory for the compiler][cargo/4788]
4817
4818 [44884]: https://github.com/rust-lang/rust/pull/44884
4819 [45198]: https://github.com/rust-lang/rust/pull/45198
4820 [45506]: https://github.com/rust-lang/rust/pull/45506
4821 [45904]: https://github.com/rust-lang/rust/pull/45904
4822 [45990]: https://github.com/rust-lang/rust/pull/45990
4823 [46012]: https://github.com/rust-lang/rust/pull/46012
4824 [46077]: https://github.com/rust-lang/rust/pull/46077
4825 [46094]: https://github.com/rust-lang/rust/pull/46094
4826 [46284]: https://github.com/rust-lang/rust/pull/46284
4827 [46287]: https://github.com/rust-lang/rust/pull/46287
4828 [46293]: https://github.com/rust-lang/rust/pull/46293
4829 [46528]: https://github.com/rust-lang/rust/pull/46528
4830 [46671]: https://github.com/rust-lang/rust/pull/46671
4831 [46713]: https://github.com/rust-lang/rust/pull/46713
4832 [46735]: https://github.com/rust-lang/rust/pull/46735
4833 [46749]: https://github.com/rust-lang/rust/pull/46749
4834 [46760]: https://github.com/rust-lang/rust/pull/46760
4835 [46798]: https://github.com/rust-lang/rust/pull/46798
4836 [46828]: https://github.com/rust-lang/rust/pull/46828
4837 [46831]: https://github.com/rust-lang/rust/pull/46831
4838 [46833]: https://github.com/rust-lang/rust/pull/46833
4839 [46910]: https://github.com/rust-lang/rust/pull/46910
4840 [46977]: https://github.com/rust-lang/rust/pull/46977
4841 [47018]: https://github.com/rust-lang/rust/pull/47018
4842 [47080]: https://github.com/rust-lang/rust/pull/47080
4843 [47084]: https://github.com/rust-lang/rust/pull/47084
4844 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4845 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4846 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4847 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4848 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4849 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4850
4851
4852 Version 1.23.0 (2018-01-04)
4853 ==========================
4854
4855 Language
4856 --------
4857 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4858 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4859   Which should fix some confusing errors in some operations.
4860
4861 Compiler
4862 --------
4863 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4864   undefined behavior.][45920]
4865 - [rustc now suggests renaming import if names clash.][45660]
4866 - [Display errors/warnings correctly when there are zero-width or
4867   wide characters.][45711]
4868 - [rustc now avoids unnecessary copies of arguments that are
4869   simple bindings][45380] This should improve memory usage on average by 5-10%.
4870 - [Updated musl used to build musl rustc to 1.1.17][45393]
4871
4872 Libraries
4873 ---------
4874 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4875 - [Implement Hash for raw pointers to unsized types][45483]
4876 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4877 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4878 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4879 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4880   and `<*mut T>::as_mut`][44932]
4881 - [Optimized `Thread::{park, unpark}` implementation][45524]
4882 - [Improved `SliceExt::binary_search` performance.][45333]
4883 - [impl `FromIterator<()>` for `()`][45379]
4884 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4885   is now deprecated.
4886
4887 Stabilized APIs
4888 ---------------
4889
4890 Cargo
4891 -----
4892 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4893   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4894 - [Added unit test checking to `cargo check`][cargo/4592]
4895 - [Cargo now lets you install a specific version
4896   using `cargo install --version`][cargo/4637]
4897
4898 Misc
4899 ----
4900 - [Releases now ship with the Cargo book documentation.][45692]
4901 - [rustdoc now prints rendering warnings on every run.][45324]
4902
4903 Compatibility Notes
4904 -------------------
4905 - [Changes have been made to type equality to make it more correct,
4906   in rare cases this could break some code.][45853] [Tracking issue for
4907   further information][45852]
4908 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4909 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4910   Android 9, the minimum supported version is Android 14.
4911 - [Bumped the minimum LLVM to 3.9][45326]
4912
4913 [44042]: https://github.com/rust-lang/rust/pull/44042
4914 [44932]: https://github.com/rust-lang/rust/pull/44932
4915 [45267]: https://github.com/rust-lang/rust/pull/45267
4916 [45324]: https://github.com/rust-lang/rust/pull/45324
4917 [45326]: https://github.com/rust-lang/rust/pull/45326
4918 [45333]: https://github.com/rust-lang/rust/pull/45333
4919 [45379]: https://github.com/rust-lang/rust/pull/45379
4920 [45380]: https://github.com/rust-lang/rust/pull/45380
4921 [45393]: https://github.com/rust-lang/rust/pull/45393
4922 [45435]: https://github.com/rust-lang/rust/pull/45435
4923 [45483]: https://github.com/rust-lang/rust/pull/45483
4924 [45524]: https://github.com/rust-lang/rust/pull/45524
4925 [45571]: https://github.com/rust-lang/rust/pull/45571
4926 [45580]: https://github.com/rust-lang/rust/pull/45580
4927 [45610]: https://github.com/rust-lang/rust/pull/45610
4928 [45660]: https://github.com/rust-lang/rust/pull/45660
4929 [45692]: https://github.com/rust-lang/rust/pull/45692
4930 [45711]: https://github.com/rust-lang/rust/pull/45711
4931 [45772]: https://github.com/rust-lang/rust/pull/45772
4932 [45852]: https://github.com/rust-lang/rust/issues/45852
4933 [45853]: https://github.com/rust-lang/rust/pull/45853
4934 [45887]: https://github.com/rust-lang/rust/pull/45887
4935 [45920]: https://github.com/rust-lang/rust/pull/45920
4936 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4937 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4938 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4939
4940
4941 Version 1.22.1 (2017-11-22)
4942 ==========================
4943
4944 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4945
4946 [46183]: https://github.com/rust-lang/rust/pull/46183
4947
4948 Version 1.22.0 (2017-11-22)
4949 ==========================
4950
4951 Language
4952 --------
4953 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4954 - [Now accepts underscores in unicode escapes][43716]
4955 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4956 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4957
4958 Compiler
4959 --------
4960 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4961 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4962   This should decrease compile times for debug builds.
4963 - [strict memory alignment now enabled on ARMv6][45094]
4964 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4965
4966 Libraries
4967 ---------
4968 - [Allow atomic operations up to 32 bits
4969   on `armv5te_unknown_linux_gnueabi`][44978]
4970 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4971 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4972 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4973 - [Properly detect overflow in `Instant += Duration`.][44220]
4974 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4975 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4976 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4977
4978 Stabilized APIs
4979 ---------------
4980
4981 Cargo
4982 -----
4983 - [Cargo will now build multi file examples in subdirectories of the `examples`
4984   folder that have a `main.rs` file.][cargo/4496]
4985 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4986   the old format will continue to work and can be updated with `cargo update`.
4987 - [Now supports vendoring git repositories][cargo/3992]
4988
4989 Misc
4990 ----
4991 - [`libbacktrace` is now available on Apple platforms.][44251]
4992 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4993   This now lets you specify that a given code example will fail to compile.
4994
4995 Compatibility Notes
4996 -------------------
4997 - [The minimum Android version that rustc can build for has been bumped
4998   to `4.0` from `2.3`][45656]
4999 - [Allowing `T op= &T` for numeric types has broken some type
5000   inference cases][45480]
5001
5002
5003 [42526]: https://github.com/rust-lang/rust/pull/42526
5004 [43017]: https://github.com/rust-lang/rust/pull/43017
5005 [43716]: https://github.com/rust-lang/rust/pull/43716
5006 [43949]: https://github.com/rust-lang/rust/pull/43949
5007 [44015]: https://github.com/rust-lang/rust/pull/44015
5008 [44220]: https://github.com/rust-lang/rust/pull/44220
5009 [44251]: https://github.com/rust-lang/rust/pull/44251
5010 [44287]: https://github.com/rust-lang/rust/pull/44287
5011 [44303]: https://github.com/rust-lang/rust/pull/44303
5012 [44456]: https://github.com/rust-lang/rust/pull/44456
5013 [44466]: https://github.com/rust-lang/rust/pull/44466
5014 [44895]: https://github.com/rust-lang/rust/pull/44895
5015 [44966]: https://github.com/rust-lang/rust/pull/44966
5016 [44978]: https://github.com/rust-lang/rust/pull/44978
5017 [45041]: https://github.com/rust-lang/rust/pull/45041
5018 [45064]: https://github.com/rust-lang/rust/pull/45064
5019 [45075]: https://github.com/rust-lang/rust/pull/45075
5020 [45094]: https://github.com/rust-lang/rust/pull/45094
5021 [45095]: https://github.com/rust-lang/rust/pull/45095
5022 [45480]: https://github.com/rust-lang/rust/issues/45480
5023 [45656]: https://github.com/rust-lang/rust/pull/45656
5024 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5025 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5026 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5027
5028
5029
5030
5031
5032
5033 Version 1.21.0 (2017-10-12)
5034 ==========================
5035
5036 Language
5037 --------
5038 - [You can now use static references for literals.][43838]
5039   Example:
5040   ```rust
5041   fn main() {
5042       let x: &'static u32 = &0;
5043   }
5044   ```
5045 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5046   Example:
5047   ```rust
5048   my_macro!(Vec<i32>::new); // Always worked
5049   my_macro!(Vec::<i32>::new); // Now works
5050   ```
5051
5052 Compiler
5053 --------
5054 - [Upgraded jemalloc to 4.5.0][43911]
5055 - [Enabled unwinding panics on Redox][43917]
5056 - [Now runs LLVM in parallel during translation phase.][43506]
5057   This should reduce peak memory usage.
5058
5059 Libraries
5060 ---------
5061 - [Generate builtin impls for `Clone` for all arrays and tuples that
5062   are `T: Clone`][43690]
5063 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5064 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5065   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5066
5067 Stabilized APIs
5068 ---------------
5069
5070 [`std::mem::discriminant`]
5071
5072 Cargo
5073 -----
5074 - [You can now call `cargo install` with multiple package names][cargo/4216]
5075 - [Cargo commands inside a virtual workspace will now implicitly
5076   pass `--all`][cargo/4335]
5077 - [Added a `[patch]` section to `Cargo.toml` to handle
5078   prepublication dependencies][cargo/4123] [RFC 1969]
5079 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5080   like patterns][cargo/4270]
5081 - [Added the `--all-targets` option][cargo/4400]
5082 - [Using required dependencies as a feature is now deprecated and emits
5083   a warning][cargo/4364]
5084
5085
5086 Misc
5087 ----
5088 - [Cargo docs are moving][43916]
5089   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5090 - [The rustdoc book is now available][43863]
5091   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5092 - [Added a preview of RLS has been made available through rustup][44204]
5093   Install with `rustup component add rls-preview`
5094 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5095   Previously only showed `std::os::unix`.
5096
5097 Compatibility Notes
5098 -------------------
5099 - [Changes in method matching against higher-ranked types][43880] This may cause
5100   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5101 - [rustc's JSON error output's byte position start at top of file.][42973]
5102   Was previously relative to the rustc's internal `CodeMap` struct which
5103   required the unstable library `libsyntax` to correctly use.
5104 - [`unused_results` lint no longer ignores booleans][43728]
5105
5106 [42565]: https://github.com/rust-lang/rust/pull/42565
5107 [42973]: https://github.com/rust-lang/rust/pull/42973
5108 [43348]: https://github.com/rust-lang/rust/pull/43348
5109 [43459]: https://github.com/rust-lang/rust/pull/43459
5110 [43506]: https://github.com/rust-lang/rust/pull/43506
5111 [43540]: https://github.com/rust-lang/rust/pull/43540
5112 [43690]: https://github.com/rust-lang/rust/pull/43690
5113 [43728]: https://github.com/rust-lang/rust/pull/43728
5114 [43838]: https://github.com/rust-lang/rust/pull/43838
5115 [43863]: https://github.com/rust-lang/rust/pull/43863
5116 [43880]: https://github.com/rust-lang/rust/pull/43880
5117 [43911]: https://github.com/rust-lang/rust/pull/43911
5118 [43916]: https://github.com/rust-lang/rust/pull/43916
5119 [43917]: https://github.com/rust-lang/rust/pull/43917
5120 [44204]: https://github.com/rust-lang/rust/pull/44204
5121 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5122 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5123 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5124 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5125 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5126 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5127 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5128 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5129 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5130
5131 Version 1.20.0 (2017-08-31)
5132 ===========================
5133
5134 Language
5135 --------
5136 - [Associated constants are now stabilised.][42809]
5137 - [A lot of macro bugs are now fixed.][42913]
5138
5139 Compiler
5140 --------
5141
5142 - [Struct fields are now properly coerced to the expected field type.][42807]
5143 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5144   `wasm32-experimental-emscripten` target.
5145 - [Changed some of the error messages to be more helpful.][42033]
5146 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5147   it.][43170]
5148 - [rustc now reports the total number of errors on compilation failure][43015]
5149   previously this was only the number of errors in the pass that failed.
5150 - [Expansion in rustc has been sped up 29x.][42533]
5151 - [added `msp430-none-elf` target.][43099]
5152 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5153   applicable][43178]
5154 - [Fixes backtraces on Redox][43228]
5155 - [rustc now identifies different versions of same crate when absolute paths of
5156   different types match in an error message.][42826]
5157
5158 Libraries
5159 ---------
5160
5161
5162 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5163 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5164   tuples.][43011]
5165 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5166   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5167 - [Impl `Clone` for `DefaultHasher`.][42799]
5168 - [Impl `Sync` for `SyncSender`.][42397]
5169 - [Impl `FromStr` for `char`][42271]
5170 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5171   NaN.][42431]
5172 - [allow messages in the `unimplemented!()` macro.][42155]
5173   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5174 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5175 - [Upgrade to Unicode 10.0.0][42999]
5176 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5177 - [Skip the main thread's manual stack guard on Linux][43072]
5178 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5179 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5180   previously 2^15.
5181 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5182
5183 Stabilized APIs
5184 ---------------
5185
5186 - [`CStr::into_c_string`]
5187 - [`CString::as_c_str`]
5188 - [`CString::into_boxed_c_str`]
5189 - [`Chain::get_mut`]
5190 - [`Chain::get_ref`]
5191 - [`Chain::into_inner`]
5192 - [`Option::get_or_insert_with`]
5193 - [`Option::get_or_insert`]
5194 - [`OsStr::into_os_string`]
5195 - [`OsString::into_boxed_os_str`]
5196 - [`Take::get_mut`]
5197 - [`Take::get_ref`]
5198 - [`Utf8Error::error_len`]
5199 - [`char::EscapeDebug`]
5200 - [`char::escape_debug`]
5201 - [`compile_error!`]
5202 - [`f32::from_bits`]
5203 - [`f32::to_bits`]
5204 - [`f64::from_bits`]
5205 - [`f64::to_bits`]
5206 - [`mem::ManuallyDrop`]
5207 - [`slice::sort_unstable_by_key`]
5208 - [`slice::sort_unstable_by`]
5209 - [`slice::sort_unstable`]
5210 - [`str::from_boxed_utf8_unchecked`]
5211 - [`str::as_bytes_mut`]
5212 - [`str::as_bytes_mut`]
5213 - [`str::from_utf8_mut`]
5214 - [`str::from_utf8_unchecked_mut`]
5215 - [`str::get_mut`]
5216 - [`str::get_unchecked_mut`]
5217 - [`str::get_unchecked`]
5218 - [`str::get`]
5219 - [`str::into_boxed_bytes`]
5220
5221
5222 Cargo
5223 -----
5224 - [Cargo API token location moved from `~/.cargo/config` to
5225   `~/.cargo/credentials`.][cargo/3978]
5226 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5227   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5228   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5229 - [You can now specify version of a binary when installed through
5230   `cargo install` using `--vers`.][cargo/4229]
5231 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5232   failure.][cargo/4248]
5233 - [Changed the convention around which file is the crate root.][cargo/4259]
5234 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5235   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5236
5237 Compatibility Notes
5238 -------------------
5239
5240 - [Functions with `'static` in their return types will now not be as usable as
5241   if they were using lifetime parameters instead.][42417]
5242 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5243   takes the sign of NaN into account where previously didn't.][42430]
5244
5245 [42033]: https://github.com/rust-lang/rust/pull/42033
5246 [42155]: https://github.com/rust-lang/rust/pull/42155
5247 [42271]: https://github.com/rust-lang/rust/pull/42271
5248 [42397]: https://github.com/rust-lang/rust/pull/42397
5249 [42417]: https://github.com/rust-lang/rust/pull/42417
5250 [42430]: https://github.com/rust-lang/rust/pull/42430
5251 [42431]: https://github.com/rust-lang/rust/pull/42431
5252 [42533]: https://github.com/rust-lang/rust/pull/42533
5253 [42571]: https://github.com/rust-lang/rust/pull/42571
5254 [42613]: https://github.com/rust-lang/rust/pull/42613
5255 [42799]: https://github.com/rust-lang/rust/pull/42799
5256 [42807]: https://github.com/rust-lang/rust/pull/42807
5257 [42809]: https://github.com/rust-lang/rust/pull/42809
5258 [42822]: https://github.com/rust-lang/rust/pull/42822
5259 [42826]: https://github.com/rust-lang/rust/pull/42826
5260 [42854]: https://github.com/rust-lang/rust/pull/42854
5261 [42913]: https://github.com/rust-lang/rust/pull/42913
5262 [42999]: https://github.com/rust-lang/rust/pull/42999
5263 [43011]: https://github.com/rust-lang/rust/pull/43011
5264 [43015]: https://github.com/rust-lang/rust/pull/43015
5265 [43072]: https://github.com/rust-lang/rust/pull/43072
5266 [43077]: https://github.com/rust-lang/rust/pull/43077
5267 [43097]: https://github.com/rust-lang/rust/pull/43097
5268 [43099]: https://github.com/rust-lang/rust/pull/43099
5269 [43170]: https://github.com/rust-lang/rust/pull/43170
5270 [43178]: https://github.com/rust-lang/rust/pull/43178
5271 [43185]: https://github.com/rust-lang/rust/pull/43185
5272 [43228]: https://github.com/rust-lang/rust/pull/43228
5273 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5274 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5275 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5276 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5277 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5278 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5279 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5280 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5281 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5282 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5283 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5284 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5285 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5286 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5287 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5288 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5289 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5290 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5291 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5292 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5293 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5294 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5295 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5296 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5297 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5298 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5299 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5300 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5301 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5302 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5303 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5304 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5305 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5306 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5307 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5308 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5309 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5310 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5311 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5312
5313
5314 Version 1.19.0 (2017-07-20)
5315 ===========================
5316
5317 Language
5318 --------
5319
5320 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5321   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5322 - [Macro recursion limit increased to 1024 from 64.][41676]
5323 - [Added lint for detecting unused macros.][41907]
5324 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5325   For example: `let x = loop { break 7; };`
5326 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5327   contain `Copy` types and cannot have a `Drop` implementation.
5328   Example: `union Foo { bar: u8, baz: usize }`
5329 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5330   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5331
5332 Compiler
5333 --------
5334
5335 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5336 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5337   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5338   you should use `--target armv7-linux-androideabi`.
5339 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5340 - [Minor optimisation of string operations.][42037]
5341 - [Compiler error message is now `aborting due to previous error(s)` instead of
5342   `aborting due to N previous errors`][42150] This was previously inaccurate and
5343   would only count certain kinds of errors.
5344 - [The compiler now supports Visual Studio 2017][42225]
5345 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5346 - [Added a lot][42264] of [new error codes][42302]
5347 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5348   libraries with C Run-time Libraries(CRT) to be statically linked.
5349 - [Fixed various ARM codegen bugs][42740]
5350
5351 Libraries
5352 ---------
5353
5354 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5355   `Extend<Cow<'a, str>>`][41449]
5356 - [`Vec` now implements `From<&mut [T]>`][41530]
5357 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5358 - [`SplitWhitespace` now implements `Clone`][41659]
5359 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5360   1.5x faster][41764]
5361 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5362   macros, but for printing to stderr.
5363
5364 Stabilized APIs
5365 ---------------
5366
5367 - [`OsString::shrink_to_fit`]
5368 - [`cmp::Reverse`]
5369 - [`Command::envs`]
5370 - [`thread::ThreadId`]
5371
5372 Cargo
5373 -----
5374
5375 - [Build scripts can now add environment variables to the environment
5376   the crate is being compiled in.
5377   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5378 - [Subcommands now replace the current process rather than spawning a new
5379   child process][cargo/3970]
5380 - [Workspace members can now accept glob file patterns][cargo/3979]
5381 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5382   the members in a given workspace.][cargo/3988]
5383 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5384 - [Target directory path is now in the cargo metadata][cargo/4022]
5385 - [Cargo no longer checks out a local working directory for the
5386   crates.io index][cargo/4026] This should provide smaller file size for the
5387   registry, and improve cloning times, especially on Windows machines.
5388 - [Added an `--exclude` option for excluding certain packages when using the
5389   `--all` option][cargo/4031]
5390 - [Cargo will now automatically retry when receiving a 5xx error
5391   from crates.io][cargo/4032]
5392 - [The `--features` option now accepts multiple comma or space
5393   delimited values.][cargo/4084]
5394 - [Added support for custom target specific runners][cargo/3954]
5395
5396 Misc
5397 ----
5398
5399 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5400   Windows Debugger.
5401 - [Rust will now release XZ compressed packages][rust-installer/57]
5402 - [rustup will now prefer to download rust packages with
5403   XZ compression][rustup/1100] over GZip packages.
5404 - [Added the ability to escape `#` in rust documentation][41785] By adding
5405   additional `#`'s ie. `##` is now `#`
5406
5407 Compatibility Notes
5408 -------------------
5409
5410 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5411 - [`-Z` flags are now no longer allowed to be used on the stable
5412   compiler.][41751] This has been a warning for a year previous to this.
5413 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5414   longer works][42844]. Users should migrate to the built-in `check`
5415   command, which has been available since 1.16.
5416 - [Ending a float literal with `._` is now a hard error.
5417   Example: `42._` .][41946]
5418 - [Any use of a private `extern crate` outside of its module is now a
5419   hard error.][36886] This was previously a warning.
5420 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5421   relative while the `::` prefix makes a path absolute, but was ignored and the
5422   path was relative regardless.
5423 - [Floating point constants in match patterns is now a hard error][36890]
5424   This was previously a warning.
5425 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5426   match patterns is now a hard error][36891] This was previously a warning.
5427 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5428   a warning.
5429 - [From the pound escape, lines consisting of multiple `#`s are
5430   now visible][41785]
5431 - [It is an error to re-export private enum variants][42460]. This is
5432   known to break a number of crates that depend on an older version of
5433   mustache.
5434 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5435   to use it to find the linker, and the build will fail where it did
5436   not previously][42607]
5437
5438 [36886]: https://github.com/rust-lang/rust/issues/36886
5439 [36888]: https://github.com/rust-lang/rust/issues/36888
5440 [36890]: https://github.com/rust-lang/rust/issues/36890
5441 [36891]: https://github.com/rust-lang/rust/issues/36891
5442 [36892]: https://github.com/rust-lang/rust/issues/36892
5443 [37406]: https://github.com/rust-lang/rust/issues/37406
5444 [39983]: https://github.com/rust-lang/rust/pull/39983
5445 [41145]: https://github.com/rust-lang/rust/pull/41145
5446 [41192]: https://github.com/rust-lang/rust/pull/41192
5447 [41258]: https://github.com/rust-lang/rust/pull/41258
5448 [41370]: https://github.com/rust-lang/rust/pull/41370
5449 [41449]: https://github.com/rust-lang/rust/pull/41449
5450 [41530]: https://github.com/rust-lang/rust/pull/41530
5451 [41624]: https://github.com/rust-lang/rust/pull/41624
5452 [41656]: https://github.com/rust-lang/rust/pull/41656
5453 [41659]: https://github.com/rust-lang/rust/pull/41659
5454 [41676]: https://github.com/rust-lang/rust/pull/41676
5455 [41751]: https://github.com/rust-lang/rust/pull/41751
5456 [41764]: https://github.com/rust-lang/rust/pull/41764
5457 [41785]: https://github.com/rust-lang/rust/pull/41785
5458 [41873]: https://github.com/rust-lang/rust/pull/41873
5459 [41907]: https://github.com/rust-lang/rust/pull/41907
5460 [41946]: https://github.com/rust-lang/rust/pull/41946
5461 [42016]: https://github.com/rust-lang/rust/pull/42016
5462 [42037]: https://github.com/rust-lang/rust/pull/42037
5463 [42068]: https://github.com/rust-lang/rust/pull/42068
5464 [42150]: https://github.com/rust-lang/rust/pull/42150
5465 [42162]: https://github.com/rust-lang/rust/pull/42162
5466 [42225]: https://github.com/rust-lang/rust/pull/42225
5467 [42264]: https://github.com/rust-lang/rust/pull/42264
5468 [42302]: https://github.com/rust-lang/rust/pull/42302
5469 [42460]: https://github.com/rust-lang/rust/issues/42460
5470 [42607]: https://github.com/rust-lang/rust/issues/42607
5471 [42740]: https://github.com/rust-lang/rust/pull/42740
5472 [42844]: https://github.com/rust-lang/rust/issues/42844
5473 [42948]: https://github.com/rust-lang/rust/pull/42948
5474 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5475 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5476 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5477 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5478 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5479 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5480 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5481 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5482 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5483 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5484 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5485 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5486 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5487 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5488 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5489 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5490 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5491 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5492 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5493 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5494 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5495 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5496
5497
5498 Version 1.18.0 (2017-06-08)
5499 ===========================
5500
5501 Language
5502 --------
5503
5504 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5505   make the item visible to just that module tree. Also accepts the keyword
5506   `crate` to make something public to the whole crate but not users of the
5507   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5508 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5509   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5510 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5511   types like `Write + Send`, trailing `+` are now supported in trait objects,
5512   and better error reporting for trait objects starting with `?Sized`.
5513 - [0e+10 is now a valid floating point literal][40589]
5514 - [Now warns if you bind a lifetime parameter to 'static][40734]
5515 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5516   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5517   representation in some cases.][40377]
5518
5519 Compiler
5520 --------
5521
5522 - [rustc can now emit mir with `--emit mir`][39891]
5523 - [Improved LLVM IR for trivial functions][40367]
5524 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5525 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5526   opportunities found through profiling
5527 - [Improved backtrace formatting when panicking][38165]
5528
5529 Libraries
5530 ---------
5531
5532 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5533   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5534   iteration or reallocation.
5535 - [Simplified HashMap Bucket interface][40561] provides performance
5536   improvements for iterating and cloning.
5537 - [Specialize Vec::from_elem to use calloc][40409]
5538 - [Fixed Race condition in fs::create_dir_all][39799]
5539 - [No longer caching stdio on Windows][40516]
5540 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5541   2.50%~ faster and in one case now 12.50% faster.
5542 - [Optimized `AtomicBool::fetch_nand`][41143]
5543
5544 Stabilized APIs
5545 ---------------
5546
5547 - [`Child::try_wait`]
5548 - [`HashMap::retain`]
5549 - [`HashSet::retain`]
5550 - [`PeekMut::pop`]
5551 - [`TcpStream::peek`]
5552 - [`UdpSocket::peek`]
5553 - [`UdpSocket::peek_from`]
5554
5555 Cargo
5556 -----
5557
5558 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5559   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5560 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5561 - [Added Android build support][cargo/3885]
5562 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5563   of a certain type, for example `cargo build --bins` will build all
5564   binaries.
5565 - [Added support for haiku][cargo/3952]
5566
5567 Misc
5568 ----
5569
5570 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5571 - [Added rust-windbg script for better debugging on Windows][39983]
5572 - [Rust now uses the official cross compiler for NetBSD][40612]
5573 - [rustdoc now accepts `#` at the start of files][40828]
5574 - [Fixed jemalloc support for musl][41168]
5575
5576 Compatibility Notes
5577 -------------------
5578
5579 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5580   always placed after the sign if it exists and before the digits. With the `#`
5581   flag the zeroes are placed after the prefix and before the digits.
5582 - [Due to the struct field optimisation][40377], using `transmute` on structs
5583   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5584   always been undefined behavior, but is now more likely to break in practice.
5585 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5586   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5587   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5588 - [Overlapping inherent `impl`s are now a hard error][40728]
5589 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5590 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5591   `out.asm` and `out.ll` instead of only one of the filetypes.
5592 - [ calling a function that returns `Self` will no longer work][41805] when
5593   the size of `Self` cannot be statically determined.
5594 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5595   this has caused a few regressions namely:
5596
5597   - Changed the link order of local static/dynamic libraries (respecting the
5598     order on given rather than having the compiler reorder).
5599   - Changed how MinGW is linked, native code linked to dynamic libraries
5600     may require manually linking to the gcc support library (for the native
5601     code itself)
5602
5603 [38165]: https://github.com/rust-lang/rust/pull/38165
5604 [39799]: https://github.com/rust-lang/rust/pull/39799
5605 [39891]: https://github.com/rust-lang/rust/pull/39891
5606 [39983]: https://github.com/rust-lang/rust/pull/39983
5607 [40043]: https://github.com/rust-lang/rust/pull/40043
5608 [40241]: https://github.com/rust-lang/rust/pull/40241
5609 [40338]: https://github.com/rust-lang/rust/pull/40338
5610 [40367]: https://github.com/rust-lang/rust/pull/40367
5611 [40377]: https://github.com/rust-lang/rust/pull/40377
5612 [40409]: https://github.com/rust-lang/rust/pull/40409
5613 [40516]: https://github.com/rust-lang/rust/pull/40516
5614 [40556]: https://github.com/rust-lang/rust/pull/40556
5615 [40561]: https://github.com/rust-lang/rust/pull/40561
5616 [40589]: https://github.com/rust-lang/rust/pull/40589
5617 [40612]: https://github.com/rust-lang/rust/pull/40612
5618 [40723]: https://github.com/rust-lang/rust/pull/40723
5619 [40728]: https://github.com/rust-lang/rust/pull/40728
5620 [40731]: https://github.com/rust-lang/rust/pull/40731
5621 [40734]: https://github.com/rust-lang/rust/pull/40734
5622 [40805]: https://github.com/rust-lang/rust/pull/40805
5623 [40807]: https://github.com/rust-lang/rust/pull/40807
5624 [40828]: https://github.com/rust-lang/rust/pull/40828
5625 [40870]: https://github.com/rust-lang/rust/pull/40870
5626 [41085]: https://github.com/rust-lang/rust/pull/41085
5627 [41143]: https://github.com/rust-lang/rust/pull/41143
5628 [41168]: https://github.com/rust-lang/rust/pull/41168
5629 [41270]: https://github.com/rust-lang/rust/issues/41270
5630 [41469]: https://github.com/rust-lang/rust/pull/41469
5631 [41805]: https://github.com/rust-lang/rust/issues/41805
5632 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5633 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5634 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5635 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5636 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5637 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5638 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5639 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5640 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5641 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5642 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5643 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5644 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5645 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5646
5647
5648 Version 1.17.0 (2017-04-27)
5649 ===========================
5650
5651 Language
5652 --------
5653
5654 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5655 * [Fields of structs may be initialized without duplicating the field/variable
5656   names][39761]. [RFC 1682]
5657 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5658 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5659   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5660   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5661   `'b`. Soundness fix.
5662 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5663 * [Static variables may contain references to other statics][40027]
5664
5665 Compiler
5666 --------
5667
5668 * [Exit quickly on only `--emit dep-info`][40336]
5669 * [Make `-C relocation-model` more correctly determine whether the linker
5670   creates a position-independent executable][40245]
5671 * [Add `-C overflow-checks` to directly control whether integer overflow
5672   panics][40037]
5673 * [The rustc type checker now checks items on demand instead of in a single
5674   in-order pass][40008]. This is mostly an internal refactoring in support of
5675   future work, including incremental type checking, but also resolves [RFC
5676   1647], allowing `Self` to appear in `impl` `where` clauses.
5677 * [Optimize vtable loads][39995]
5678 * [Turn off vectorization for Emscripten targets][39990]
5679 * [Provide suggestions for unknown macros imported with `use`][39953]
5680 * [Fix ICEs in path resolution][39939]
5681 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5682 * [Add clearer error message using `&str + &str`][39116]
5683
5684 Stabilized APIs
5685 ---------------
5686
5687 * [`Arc::into_raw`]
5688 * [`Arc::from_raw`]
5689 * [`Arc::ptr_eq`]
5690 * [`Rc::into_raw`]
5691 * [`Rc::from_raw`]
5692 * [`Rc::ptr_eq`]
5693 * [`Ordering::then`]
5694 * [`Ordering::then_with`]
5695 * [`BTreeMap::range`]
5696 * [`BTreeMap::range_mut`]
5697 * [`collections::Bound`]
5698 * [`process::abort`]
5699 * [`ptr::read_unaligned`]
5700 * [`ptr::write_unaligned`]
5701 * [`Result::expect_err`]
5702 * [`Cell::swap`]
5703 * [`Cell::replace`]
5704 * [`Cell::into_inner`]
5705 * [`Cell::take`]
5706
5707 Libraries
5708 ---------
5709
5710 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5711 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5712 * [`String` implements `FromIterator<&char>`][40028]
5713 * `Box` [implements][40009] a number of new conversions:
5714   `From<Box<str>> for String`,
5715   `From<Box<[T]>> for Vec<T>`,
5716   `From<Box<CStr>> for CString`,
5717   `From<Box<OsStr>> for OsString`,
5718   `From<Box<Path>> for PathBuf`,
5719   `Into<Box<str>> for String`,
5720   `Into<Box<[T]>> for Vec<T>`,
5721   `Into<Box<CStr>> for CString`,
5722   `Into<Box<OsStr>> for OsString`,
5723   `Into<Box<Path>> for PathBuf`,
5724   `Default for Box<str>`,
5725   `Default for Box<CStr>`,
5726   `Default for Box<OsStr>`,
5727   `From<&CStr> for Box<CStr>`,
5728   `From<&OsStr> for Box<OsStr>`,
5729   `From<&Path> for Box<Path>`
5730 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5731 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5732 * [Slightly optimize `slice::sort`][39538]
5733 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5734 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5735   `Box<str>` implements `From<&str>`][39438]
5736 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5737   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5738 * [`format!` estimates the needed capacity before writing a string][39356]
5739 * [Support unprivileged symlink creation in Windows][38921]
5740 * [`PathBuf` implements `Default`][38764]
5741 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5742 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5743   and poor hash functions.
5744
5745 Cargo
5746 -----
5747
5748 * [Add `cargo check --all`][cargo/3731]
5749 * [Add an option to ignore SSL revocation checking][cargo/3699]
5750 * [Add `cargo run --package`][cargo/3691]
5751 * [Add `required_features`][cargo/3667]
5752 * [Assume `build.rs` is a build script][cargo/3664]
5753 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5754
5755 Misc
5756 ----
5757
5758 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5759   `rustbook`][39633]
5760 * [The "Unstable Book" documents nightly-only features][ubook]
5761 * [Improve the style of the sidebar in rustdoc output][40265]
5762 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5763 * [Fix MSP430 breakage due to `i128`][40257]
5764 * [Preliminary Solaris/SPARCv9 support][39903]
5765 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5766   run without installing the MSVC runtime.
5767 * [`rustdoc --test` includes file names in test names][39788]
5768 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5769   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5770 * [Initial support for `aarch64-unknown-freebsd`][39491]
5771 * [Initial support for `i686-unknown-netbsd`][39426]
5772 * [This release no longer includes the old makefile build system][39431]. Rust
5773   is built with a custom build system, written in Rust, and with Cargo.
5774 * [Add Debug implementations for libcollection structs][39002]
5775 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5776 * [`--test-threads=0` produces an error][38945]
5777 * [`rustup` installs documentation by default][40526]
5778 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5779   WinDbg and Visual Studio to improve the debugging experience.
5780
5781 Compatibility Notes
5782 -------------------
5783
5784 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5785   workaround, either use MSVC 2015 or run vcvars.bat.
5786 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5787   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5788   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5789   fix.
5790 * [`format!` and `Display::to_string` panic if an underlying formatting
5791   implementation returns an error][40117]. Previously the error was silently
5792   ignored. It is incorrect for `write_fmt` to return an error when writing
5793   to a string.
5794 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5795   crates were marked stable and could be accessed from the stable toolchain.
5796 * [Rust git source no longer includes vendored crates][39728]. Those that need
5797   to build with vendored crates should build from release tarballs.
5798 * [Fix inert attributes from `proc_macro_derives`][39572]
5799 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5800   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5801   build system.
5802 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5803   existing code generally ignores the type of dead-code unless a type-hint is
5804   provided; this can cause surprising inference interactions particularly around
5805   defaulting. The new code uniformly ignores the result type of dead-code.
5806 * [Tuple-struct constructors with private fields are no longer visible][38932]
5807 * [Lifetime parameters that do not appear in the arguments are now considered
5808   early-bound][38897], resolving a soundness bug (#[32330]). The
5809   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5810   April of 2016.
5811 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5812 * [Make transmuting from fn item types to pointer-sized types a hard
5813   error][34198]
5814
5815 [27787]: https://github.com/rust-lang/rust/issues/27787
5816 [32330]: https://github.com/rust-lang/rust/issues/32330
5817 [34198]: https://github.com/rust-lang/rust/pull/34198
5818 [38161]: https://github.com/rust-lang/rust/pull/38161
5819 [38368]: https://github.com/rust-lang/rust/pull/38368
5820 [38584]: https://github.com/rust-lang/rust/issues/38584
5821 [38661]: https://github.com/rust-lang/rust/pull/38661
5822 [38764]: https://github.com/rust-lang/rust/pull/38764
5823 [38864]: https://github.com/rust-lang/rust/issues/38864
5824 [38897]: https://github.com/rust-lang/rust/pull/38897
5825 [38921]: https://github.com/rust-lang/rust/pull/38921
5826 [38932]: https://github.com/rust-lang/rust/pull/38932
5827 [38945]: https://github.com/rust-lang/rust/pull/38945
5828 [38981]: https://github.com/rust-lang/rust/pull/38981
5829 [39002]: https://github.com/rust-lang/rust/pull/39002
5830 [39116]: https://github.com/rust-lang/rust/pull/39116
5831 [39193]: https://github.com/rust-lang/rust/pull/39193
5832 [39265]: https://github.com/rust-lang/rust/pull/39265
5833 [39356]: https://github.com/rust-lang/rust/pull/39356
5834 [39372]: https://github.com/rust-lang/rust/pull/39372
5835 [39426]: https://github.com/rust-lang/rust/pull/39426
5836 [39431]: https://github.com/rust-lang/rust/pull/39431
5837 [39438]: https://github.com/rust-lang/rust/pull/39438
5838 [39440]: https://github.com/rust-lang/rust/pull/39440
5839 [39485]: https://github.com/rust-lang/rust/pull/39485
5840 [39491]: https://github.com/rust-lang/rust/pull/39491
5841 [39518]: https://github.com/rust-lang/rust/pull/39518
5842 [39538]: https://github.com/rust-lang/rust/pull/39538
5843 [39572]: https://github.com/rust-lang/rust/pull/39572
5844 [39633]: https://github.com/rust-lang/rust/pull/39633
5845 [39642]: https://github.com/rust-lang/rust/pull/39642
5846 [39728]: https://github.com/rust-lang/rust/pull/39728
5847 [39761]: https://github.com/rust-lang/rust/pull/39761
5848 [39788]: https://github.com/rust-lang/rust/pull/39788
5849 [39793]: https://github.com/rust-lang/rust/pull/39793
5850 [39837]: https://github.com/rust-lang/rust/pull/39837
5851 [39843]: https://github.com/rust-lang/rust/pull/39843
5852 [39851]: https://github.com/rust-lang/rust/pull/39851
5853 [39903]: https://github.com/rust-lang/rust/pull/39903
5854 [39939]: https://github.com/rust-lang/rust/pull/39939
5855 [39953]: https://github.com/rust-lang/rust/pull/39953
5856 [39960]: https://github.com/rust-lang/rust/pull/39960
5857 [39990]: https://github.com/rust-lang/rust/pull/39990
5858 [39995]: https://github.com/rust-lang/rust/pull/39995
5859 [40008]: https://github.com/rust-lang/rust/pull/40008
5860 [40009]: https://github.com/rust-lang/rust/pull/40009
5861 [40027]: https://github.com/rust-lang/rust/pull/40027
5862 [40028]: https://github.com/rust-lang/rust/pull/40028
5863 [40037]: https://github.com/rust-lang/rust/pull/40037
5864 [40117]: https://github.com/rust-lang/rust/pull/40117
5865 [40166]: https://github.com/rust-lang/rust/pull/40166
5866 [40245]: https://github.com/rust-lang/rust/pull/40245
5867 [40257]: https://github.com/rust-lang/rust/pull/40257
5868 [40261]: https://github.com/rust-lang/rust/pull/40261
5869 [40265]: https://github.com/rust-lang/rust/pull/40265
5870 [40319]: https://github.com/rust-lang/rust/pull/40319
5871 [40336]: https://github.com/rust-lang/rust/pull/40336
5872 [40526]: https://github.com/rust-lang/rust/pull/40526
5873 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5874 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5875 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5876 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5877 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5878 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5879 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5880 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5881 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5882 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5883 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5884 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5885 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5886 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5887 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5888 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5889 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5890 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5891 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5892 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5893 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5894 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5895 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5896 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5897 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5898 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5899 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5900 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5901 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5902 [mdbook]: https://crates.io/crates/mdbook
5903 [ubook]: https://doc.rust-lang.org/unstable-book/
5904
5905
5906 Version 1.16.0 (2017-03-16)
5907 ===========================
5908
5909 Language
5910 --------
5911
5912 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5913 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5914   match patterns][38069]
5915 * [Clean up semantics of `self` in an import list][38313]
5916 * [`Self` may appear in `impl` headers][38920]
5917 * [`Self` may appear in struct expressions][39282]
5918
5919 Compiler
5920 --------
5921
5922 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5923   a `.rmeta` file containing only crate metadata][38571]. This can be
5924   used by tools like the Rust Language Service to perform
5925   metadata-only builds.
5926 * [Levenshtein based typo suggestions now work in most places, while
5927   previously they worked only for fields and sometimes for local
5928   variables][38927]. Together with the overhaul of "no
5929   resolution"/"unexpected resolution" errors (#[38154]) they result in
5930   large and systematic improvement in resolution diagnostics.
5931 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5932   `U`][38670]
5933 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5934 * [`rustc` no longer attempts to provide "consider using an explicit
5935   lifetime" suggestions][37057]. They were inaccurate.
5936
5937 Stabilized APIs
5938 ---------------
5939
5940 * [`VecDeque::truncate`]
5941 * [`VecDeque::resize`]
5942 * [`String::insert_str`]
5943 * [`Duration::checked_add`]
5944 * [`Duration::checked_sub`]
5945 * [`Duration::checked_div`]
5946 * [`Duration::checked_mul`]
5947 * [`str::replacen`]
5948 * [`str::repeat`]
5949 * [`SocketAddr::is_ipv4`]
5950 * [`SocketAddr::is_ipv6`]
5951 * [`IpAddr::is_ipv4`]
5952 * [`IpAddr::is_ipv6`]
5953 * [`Vec::dedup_by`]
5954 * [`Vec::dedup_by_key`]
5955 * [`Result::unwrap_or_default`]
5956 * [`<*const T>::wrapping_offset`]
5957 * [`<*mut T>::wrapping_offset`]
5958 * `CommandExt::creation_flags`
5959 * [`File::set_permissions`]
5960 * [`String::split_off`]
5961
5962 Libraries
5963 ---------
5964
5965 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5966   their argument by `Borrow` parameter][37761]
5967 * [All public types in std implement `Debug`][38006]
5968 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5969 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5970 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5971   Windows][38274]
5972 * [std: Fix partial writes in `LineWriter`][38062]
5973 * [std: Clamp max read/write sizes on Unix][38062]
5974 * [Use more specific panic message for `&str` slicing errors][38066]
5975 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5976   functionality cannot be achieved in std currently.
5977 * [`writeln!`, like `println!`, now accepts a form with no string
5978   or formatting arguments, to just print a newline][38469]
5979 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5980 * [Reduce the size of static data in `std_unicode::tables`][38781]
5981 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5982   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5983   `Display`][38909]
5984 * [`Duration` implements `Sum`][38712]
5985 * [`String` implements `ToSocketAddrs`][39048]
5986
5987 Cargo
5988 -----
5989
5990 * [The `cargo check` command does a type check of a project without
5991   building it][cargo/3296]
5992 * [crates.io will display CI badges from Travis and AppVeyor, if
5993   specified in Cargo.toml][cargo/3546]
5994 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5995 * [Compilation profiles accept integer values for `debug`, in addition
5996   to `true` and `false`. These are passed to `rustc` as the value to
5997   `-C debuginfo`][cargo/3534]
5998 * [Implement `cargo --version --verbose`][cargo/3604]
5999 * [All builds now output 'dep-info' build dependencies compatible with
6000   make and ninja][cargo/3557]
6001 * [Build all workspace members with `build --all`][cargo/3511]
6002 * [Document all workspace members with `doc --all`][cargo/3515]
6003 * [Path deps outside workspace are not members][cargo/3443]
6004
6005 Misc
6006 ----
6007
6008 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6009   the path to the Rust implementation][38589]
6010 * [The `armv7-linux-androideabi` target no longer enables NEON
6011   extensions, per Google's ABI guide][38413]
6012 * [The stock standard library can be compiled for Redox OS][38401]
6013 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6014   available.
6015 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6016   builds available.
6017 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6018
6019 Compatibility Notes
6020 -------------------
6021
6022 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6023   match patterns][38069]
6024 * In this release, references to uninhabited types can not be
6025   pattern-matched. This was accidentally allowed in 1.15.
6026 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6027 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6028   Windows][38274]
6029 * [Clean up semantics of `self` in an import list][38313]
6030 * Reimplemented lifetime elision. This change was almost entirely compatible
6031   with existing code, but it did close a number of small bugs and loopholes,
6032   as well as being more accepting in some other [cases][41105].
6033
6034 [37057]: https://github.com/rust-lang/rust/pull/37057
6035 [37761]: https://github.com/rust-lang/rust/pull/37761
6036 [38006]: https://github.com/rust-lang/rust/pull/38006
6037 [38051]: https://github.com/rust-lang/rust/pull/38051
6038 [38062]: https://github.com/rust-lang/rust/pull/38062
6039 [38062]: https://github.com/rust-lang/rust/pull/38622
6040 [38066]: https://github.com/rust-lang/rust/pull/38066
6041 [38069]: https://github.com/rust-lang/rust/pull/38069
6042 [38131]: https://github.com/rust-lang/rust/pull/38131
6043 [38154]: https://github.com/rust-lang/rust/pull/38154
6044 [38274]: https://github.com/rust-lang/rust/pull/38274
6045 [38304]: https://github.com/rust-lang/rust/pull/38304
6046 [38313]: https://github.com/rust-lang/rust/pull/38313
6047 [38314]: https://github.com/rust-lang/rust/pull/38314
6048 [38327]: https://github.com/rust-lang/rust/pull/38327
6049 [38401]: https://github.com/rust-lang/rust/pull/38401
6050 [38413]: https://github.com/rust-lang/rust/pull/38413
6051 [38469]: https://github.com/rust-lang/rust/pull/38469
6052 [38559]: https://github.com/rust-lang/rust/pull/38559
6053 [38571]: https://github.com/rust-lang/rust/pull/38571
6054 [38580]: https://github.com/rust-lang/rust/pull/38580
6055 [38589]: https://github.com/rust-lang/rust/pull/38589
6056 [38670]: https://github.com/rust-lang/rust/pull/38670
6057 [38712]: https://github.com/rust-lang/rust/pull/38712
6058 [38726]: https://github.com/rust-lang/rust/pull/38726
6059 [38781]: https://github.com/rust-lang/rust/pull/38781
6060 [38798]: https://github.com/rust-lang/rust/pull/38798
6061 [38909]: https://github.com/rust-lang/rust/pull/38909
6062 [38920]: https://github.com/rust-lang/rust/pull/38920
6063 [38927]: https://github.com/rust-lang/rust/pull/38927
6064 [39048]: https://github.com/rust-lang/rust/pull/39048
6065 [39282]: https://github.com/rust-lang/rust/pull/39282
6066 [39379]: https://github.com/rust-lang/rust/pull/39379
6067 [41105]: https://github.com/rust-lang/rust/issues/41105
6068 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6069 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6070 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6071 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6072 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6073 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6074 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6075 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6076 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6077 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6078 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6079 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6080 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6081 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6082 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6083 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6084 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6085 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6086 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6087 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6088 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6089 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6090 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6091 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6092 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6093 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6094 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6095 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6096 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6097 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6098
6099
6100 Version 1.15.1 (2017-02-09)
6101 ===========================
6102
6103 * [Fix IntoIter::as_mut_slice's signature][39466]
6104 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6105
6106 [39466]: https://github.com/rust-lang/rust/pull/39466
6107 [39523]: https://github.com/rust-lang/rust/pull/39523
6108
6109
6110 Version 1.15.0 (2017-02-02)
6111 ===========================
6112
6113 Language
6114 --------
6115
6116 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6117   stable. This allows popular code-generating crates like Serde and Diesel to
6118   work ergonomically. [RFC 1681].
6119 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6120   with curly braces][36868]. Part of [RFC 1506].
6121 * [A number of minor changes to name resolution have been activated][37127].
6122   They add up to more consistent semantics, allowing for future evolution of
6123   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6124   details of what is different. The breaking changes here have been transitioned
6125   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6126 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6127   bounds][38279]
6128 * [`?Sized` can be used in `where` clauses][37791]
6129 * [There is now a limit on the size of monomorphized types and it can be
6130   modified with the `#![type_size_limit]` crate attribute, similarly to
6131   the `#![recursion_limit]` attribute][37789]
6132
6133 Compiler
6134 --------
6135
6136 * [On Windows, the compiler will apply dllimport attributes when linking to
6137   extern functions][37973]. Additional attributes and flags can control which
6138   library kind is linked and its name. [RFC 1717].
6139 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6140 * [The `--test` flag works with procedural macro crates][38107]
6141 * [Fix `extern "aapcs" fn` ABI][37814]
6142 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6143 * [The `format!` expander recognizes incorrect `printf` and shell-style
6144   formatting directives and suggests the correct format][37613].
6145 * [Only report one error for all unused imports in an import list][37456]
6146
6147 Compiler Performance
6148 --------------------
6149
6150 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6151 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6152 * [Don't clone in `UnificationTable::probe`][37848]
6153 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6154 * [Use small vectors in type walker][37760]
6155 * [Macro expansion performance was improved][37701]
6156 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6157 * [Replace FNV with a faster hash function][37229]
6158
6159 Stabilized APIs
6160 ---------------
6161
6162 * [`std::iter::Iterator::min_by`]
6163 * [`std::iter::Iterator::max_by`]
6164 * [`std::os::*::fs::FileExt`]
6165 * [`std::sync::atomic::Atomic*::get_mut`]
6166 * [`std::sync::atomic::Atomic*::into_inner`]
6167 * [`std::vec::IntoIter::as_slice`]
6168 * [`std::vec::IntoIter::as_mut_slice`]
6169 * [`std::sync::mpsc::Receiver::try_iter`]
6170 * [`std::os::unix::process::CommandExt::before_exec`]
6171 * [`std::rc::Rc::strong_count`]
6172 * [`std::rc::Rc::weak_count`]
6173 * [`std::sync::Arc::strong_count`]
6174 * [`std::sync::Arc::weak_count`]
6175 * [`std::char::encode_utf8`]
6176 * [`std::char::encode_utf16`]
6177 * [`std::cell::Ref::clone`]
6178 * [`std::io::Take::into_inner`]
6179
6180 Libraries
6181 ---------
6182
6183 * [The standard sorting algorithm has been rewritten for dramatic performance
6184   improvements][38192]. It is a hybrid merge sort, drawing influences from
6185   Timsort. Previously it was a naive merge sort.
6186 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6187 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6188   performance.
6189 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6190   and `char_indices().last()`][37882]
6191 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6192 * [Chinese characters display correctly in `fmt::Debug`][37855]
6193 * [Derive `Default` for `Duration`][37699]
6194 * [Support creation of anonymous pipes on WinXP/2k][37677]
6195 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6196 * [Don't pass overlapped handles to processes][38835]
6197
6198 Cargo
6199 -----
6200
6201 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6202   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6203   should instead check the variable at runtime with `std::env`. That the value
6204   was set at build time was a bug, and incorrect when cross-compiling. This
6205   change is known to cause breakage.
6206 * [Add `--all` flag to `cargo test`][cargo/3221]
6207 * [Compile statically against the MSVC CRT][cargo/3363]
6208 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6209 * [Link OpenSSL statically on OSX][cargo/3311]
6210 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6211 * [Test for bad path overrides with summaries][cargo/3336]
6212 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6213 * [Fix retrying crate downloads for network errors][cargo/3348]
6214 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6215 * [Emit more info on --message-format=json][cargo/3319]
6216 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6217 * [Don't ignore errors in workspace manifest][cargo/3409]
6218 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6219
6220 Tooling
6221 -------
6222
6223 * [Test runners (binaries built with `--test`) now support a `--list` argument
6224   that lists the tests it contains][38185]
6225 * [Test runners now support a `--exact` argument that makes the test filter
6226   match exactly, instead of matching only a substring of the test name][38181]
6227 * [rustdoc supports a `--playground-url` flag][37763]
6228 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6229
6230 Misc
6231 ----
6232
6233 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6234   continue to be used in this release by passing `--disable-rustbuild` to the
6235   configure script, but they will be deleted soon. Note that the new build
6236   system uses a different on-disk layout that will likely affect any scripts
6237   building Rust.
6238 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6239   releases.
6240 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6241 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6242   releases.
6243
6244 Compatibility Notes
6245 -------------------
6246
6247 * [A number of minor changes to name resolution have been activated][37127].
6248   They add up to more consistent semantics, allowing for future evolution of
6249   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6250   details of what is different. The breaking changes here have been transitioned
6251   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6252 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6253   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6254   should instead check the variable at runtime with `std::env`. That the value
6255   was set at build time was a bug, and incorrect when cross-compiling. This
6256   change is known to cause breakage.
6257 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6258   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6259   1.10 and is now an error by default. It will become a hard error in the near
6260   future.
6261 * [The semantics relating modules to file system directories are changing in
6262   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6263   lint, which is a warning in this release, and will become a hard error in the
6264   future.
6265 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6266 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6267   the underlying iterator][37834]
6268
6269 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6270 [33685]: https://github.com/rust-lang/rust/issues/33685
6271 [36868]: https://github.com/rust-lang/rust/pull/36868
6272 [37127]: https://github.com/rust-lang/rust/pull/37127
6273 [37229]: https://github.com/rust-lang/rust/pull/37229
6274 [37456]: https://github.com/rust-lang/rust/pull/37456
6275 [37527]: https://github.com/rust-lang/rust/pull/37527
6276 [37602]: https://github.com/rust-lang/rust/pull/37602
6277 [37613]: https://github.com/rust-lang/rust/pull/37613
6278 [37615]: https://github.com/rust-lang/rust/pull/37615
6279 [37636]: https://github.com/rust-lang/rust/pull/37636
6280 [37627]: https://github.com/rust-lang/rust/pull/37627
6281 [37642]: https://github.com/rust-lang/rust/pull/37642
6282 [37677]: https://github.com/rust-lang/rust/pull/37677
6283 [37699]: https://github.com/rust-lang/rust/pull/37699
6284 [37701]: https://github.com/rust-lang/rust/pull/37701
6285 [37705]: https://github.com/rust-lang/rust/pull/37705
6286 [37749]: https://github.com/rust-lang/rust/pull/37749
6287 [37760]: https://github.com/rust-lang/rust/pull/37760
6288 [37763]: https://github.com/rust-lang/rust/pull/37763
6289 [37764]: https://github.com/rust-lang/rust/pull/37764
6290 [37789]: https://github.com/rust-lang/rust/pull/37789
6291 [37791]: https://github.com/rust-lang/rust/pull/37791
6292 [37814]: https://github.com/rust-lang/rust/pull/37814
6293 [37817]: https://github.com/rust-lang/rust/pull/37817
6294 [37834]: https://github.com/rust-lang/rust/pull/37834
6295 [37848]: https://github.com/rust-lang/rust/pull/37848
6296 [37855]: https://github.com/rust-lang/rust/pull/37855
6297 [37882]: https://github.com/rust-lang/rust/pull/37882
6298 [37888]: https://github.com/rust-lang/rust/pull/37888
6299 [37973]: https://github.com/rust-lang/rust/pull/37973
6300 [37979]: https://github.com/rust-lang/rust/pull/37979
6301 [38086]: https://github.com/rust-lang/rust/pull/38086
6302 [38107]: https://github.com/rust-lang/rust/pull/38107
6303 [38117]: https://github.com/rust-lang/rust/pull/38117
6304 [38134]: https://github.com/rust-lang/rust/pull/38134
6305 [38146]: https://github.com/rust-lang/rust/pull/38146
6306 [38181]: https://github.com/rust-lang/rust/pull/38181
6307 [38182]: https://github.com/rust-lang/rust/pull/38182
6308 [38185]: https://github.com/rust-lang/rust/pull/38185
6309 [38192]: https://github.com/rust-lang/rust/pull/38192
6310 [38279]: https://github.com/rust-lang/rust/pull/38279
6311 [38835]: https://github.com/rust-lang/rust/pull/38835
6312 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6313 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6314 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6315 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6316 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6317 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6318 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6319 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6320 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6321 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6322 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6323 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6324 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6325 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6326 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6327 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6328 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6329 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6330 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6331 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6332 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6333 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6334 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6335 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6336 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6337 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6338 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6339 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6340 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6341 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6342 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6343 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6344 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6345 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6346 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6347 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6348 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6349 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6350
6351
6352 Version 1.14.0 (2016-12-22)
6353 ===========================
6354
6355 Language
6356 --------
6357
6358 * [`..` matches multiple tuple fields in enum variants, structs
6359   and tuples][36843]. [RFC 1492].
6360 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6361 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6362 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6363   dereferencing][36822]
6364
6365 Compiler
6366 --------
6367
6368 * [Mark enums with non-zero discriminant as non-zero][37224]
6369 * [Lower-case `static mut` names are linted like other
6370   statics and consts][37162]
6371 * [Fix ICE on some macros in const integer positions
6372    (e.g. `[u8; m!()]`)][36819]
6373 * [Improve error message and snippet for "did you mean `x`"][36798]
6374 * [Add a panic-strategy field to the target specification][36794]
6375 * [Include LLVM version in `--version --verbose`][37200]
6376
6377 Compile-time Optimizations
6378 --------------------------
6379
6380 * [Improve macro expansion performance][37569]
6381 * [Shrink `Expr_::ExprInlineAsm`][37445]
6382 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6383 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6384 * [Avoid more allocations when compiling html5ever][37373]
6385 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6386 * [Avoid some allocations in the macro parser][37318]
6387 * [Use a faster deflate setting][37298]
6388 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6389   during interning of slices][37270]
6390 * [Optimize `write_metadata`][37267]
6391 * [Don't process obligation forest cycles when stalled][37231]
6392 * [Avoid many `CrateConfig` clones][37161]
6393 * [Optimize `Substs::super_fold_with`][37108]
6394 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6395 * [Speed up `plug_leaks`][36917]
6396
6397 Libraries
6398 ---------
6399
6400 * [`println!()`, with no arguments, prints newline][36825].
6401   Previously, an empty string was required to achieve the same.
6402 * [`Wrapping` impls standard binary and unary operators, as well as
6403    the `Sum` and `Product` iterators][37356]
6404 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6405   Vec<T>`][37326]
6406 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6407   `VecDeque` iterators][37315]
6408 * [Improve `SipHasher` performance on small values][37312]
6409 * [Add Iterator trait TrustedLen to enable better FromIterator /
6410   Extend][37306]
6411 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6412 * [`ReadDir` implements `Debug`][37221]
6413 * [Implement `RefUnwindSafe` for atomic types][37178]
6414 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6415 * [Avoid allocations in `Decoder::read_str`][37064]
6416 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6417 * [Impl `Debug` for raw pointers to unsized data][36880]
6418 * [Don't reuse `HashMap` random seeds][37470]
6419 * [The internal memory layout of `HashMap` is more cache-friendly, for
6420   significant improvements in some operations][36692]
6421 * [`HashMap` uses less memory on 32-bit architectures][36595]
6422 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6423
6424 Cargo
6425 -----
6426
6427 * [Expose rustc cfg values to build scripts][cargo/3243]
6428 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6429 * [Fix passing --features when testing multiple packages][cargo/3280]
6430 * [Use a single profile set per workspace][cargo/3249]
6431 * [Load `replace` sections from lock files][cargo/3220]
6432 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6433
6434 Tooling
6435 -------
6436
6437 * [rustup is the recommended Rust installation method][1.14rustup]
6438 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6439   S390x. These are [tier 2] platforms and may have major defects. Follow the
6440   instructions on the website to install, or add the targets to an existing
6441   installation with `rustup target add`. The new target triples are:
6442   - `mips-unknown-linux-gnu`
6443   - `mipsel-unknown-linux-gnu`
6444   - `mips64-unknown-linux-gnuabi64`
6445   - `mips64el-unknown-linux-gnuabi64 `
6446   - `powerpc-unknown-linux-gnu`
6447   - `powerpc64-unknown-linux-gnu`
6448   - `powerpc64le-unknown-linux-gnu`
6449   - `s390x-unknown-linux-gnu `
6450 * This release includes target (std) builds for ARM Linux running MUSL
6451   libc. These are [tier 2] platforms and may have major defects. Add the
6452   following triples to an existing rustup installation with `rustup target add`:
6453   - `arm-unknown-linux-musleabi`
6454   - `arm-unknown-linux-musleabihf`
6455   - `armv7-unknown-linux-musleabihf`
6456 * This release includes [experimental support for WebAssembly][1.14wasm], via
6457   the `wasm32-unknown-emscripten` target. This target is known to have major
6458   defects. Please test, report, and fix.
6459 * rustup no longer installs documentation by default. Run `rustup
6460   component add rust-docs` to install.
6461 * [Fix line stepping in debugger][37310]
6462 * [Enable line number debuginfo in releases][37280]
6463
6464 Misc
6465 ----
6466
6467 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6468 * [Add support for Fuchsia OS][37313]
6469 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6470
6471 Compatibility Notes
6472 -------------------
6473
6474 * [A number of forward-compatibility lints used by the compiler
6475   to gradually introduce language changes have been converted
6476   to deny by default][36894]:
6477   - ["use of inaccessible extern crate erroneously allowed"][36886]
6478   - ["type parameter default erroneously allowed in invalid location"][36887]
6479   - ["detects super or self keywords at the beginning of global path"][36888]
6480   - ["two overlapping inherent impls define an item with the same name
6481     were erroneously allowed"][36889]
6482   - ["floating-point constants cannot be used in patterns"][36890]
6483   - ["constants of struct or enum type can only be used in a pattern if
6484      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6485   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6486 * [Prohibit patterns in trait methods without bodies][37378]
6487 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6488 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6489 * [The `$crate` macro variable is accepted in fewer locations][37213]
6490 * [Impls specifying extra region requirements beyond the trait
6491   they implement are rejected][37167]
6492 * [Enums may not be unsized][37111]. Unsized enums are intended to
6493   work but never have. For now they are forbidden.
6494 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6495
6496 [tier 2]: https://forge.rust-lang.org/platform-support.html
6497 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6498 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6499 [36430]: https://github.com/rust-lang/rust/pull/36430
6500 [36595]: https://github.com/rust-lang/rust/pull/36595
6501 [36595]: https://github.com/rust-lang/rust/pull/36595
6502 [36692]: https://github.com/rust-lang/rust/pull/36692
6503 [36767]: https://github.com/rust-lang/rust/pull/36767
6504 [36794]: https://github.com/rust-lang/rust/pull/36794
6505 [36798]: https://github.com/rust-lang/rust/pull/36798
6506 [36819]: https://github.com/rust-lang/rust/pull/36819
6507 [36822]: https://github.com/rust-lang/rust/pull/36822
6508 [36825]: https://github.com/rust-lang/rust/pull/36825
6509 [36843]: https://github.com/rust-lang/rust/pull/36843
6510 [36880]: https://github.com/rust-lang/rust/pull/36880
6511 [36886]: https://github.com/rust-lang/rust/issues/36886
6512 [36887]: https://github.com/rust-lang/rust/issues/36887
6513 [36888]: https://github.com/rust-lang/rust/issues/36888
6514 [36889]: https://github.com/rust-lang/rust/issues/36889
6515 [36890]: https://github.com/rust-lang/rust/issues/36890
6516 [36891]: https://github.com/rust-lang/rust/issues/36891
6517 [36892]: https://github.com/rust-lang/rust/issues/36892
6518 [36894]: https://github.com/rust-lang/rust/pull/36894
6519 [36917]: https://github.com/rust-lang/rust/pull/36917
6520 [36993]: https://github.com/rust-lang/rust/pull/36993
6521 [37037]: https://github.com/rust-lang/rust/pull/37037
6522 [37064]: https://github.com/rust-lang/rust/pull/37064
6523 [37094]: https://github.com/rust-lang/rust/pull/37094
6524 [37108]: https://github.com/rust-lang/rust/pull/37108
6525 [37111]: https://github.com/rust-lang/rust/pull/37111
6526 [37161]: https://github.com/rust-lang/rust/pull/37161
6527 [37162]: https://github.com/rust-lang/rust/pull/37162
6528 [37167]: https://github.com/rust-lang/rust/pull/37167
6529 [37178]: https://github.com/rust-lang/rust/pull/37178
6530 [37200]: https://github.com/rust-lang/rust/pull/37200
6531 [37213]: https://github.com/rust-lang/rust/pull/37213
6532 [37221]: https://github.com/rust-lang/rust/pull/37221
6533 [37224]: https://github.com/rust-lang/rust/pull/37224
6534 [37230]: https://github.com/rust-lang/rust/pull/37230
6535 [37231]: https://github.com/rust-lang/rust/pull/37231
6536 [37247]: https://github.com/rust-lang/rust/pull/37247
6537 [37267]: https://github.com/rust-lang/rust/pull/37267
6538 [37270]: https://github.com/rust-lang/rust/pull/37270
6539 [37273]: https://github.com/rust-lang/rust/pull/37273
6540 [37280]: https://github.com/rust-lang/rust/pull/37280
6541 [37298]: https://github.com/rust-lang/rust/pull/37298
6542 [37306]: https://github.com/rust-lang/rust/pull/37306
6543 [37310]: https://github.com/rust-lang/rust/pull/37310
6544 [37312]: https://github.com/rust-lang/rust/pull/37312
6545 [37313]: https://github.com/rust-lang/rust/pull/37313
6546 [37315]: https://github.com/rust-lang/rust/pull/37315
6547 [37318]: https://github.com/rust-lang/rust/pull/37318
6548 [37322]: https://github.com/rust-lang/rust/pull/37322
6549 [37326]: https://github.com/rust-lang/rust/pull/37326
6550 [37351]: https://github.com/rust-lang/rust/pull/37351
6551 [37356]: https://github.com/rust-lang/rust/pull/37356
6552 [37367]: https://github.com/rust-lang/rust/pull/37367
6553 [37373]: https://github.com/rust-lang/rust/pull/37373
6554 [37378]: https://github.com/rust-lang/rust/pull/37378
6555 [37389]: https://github.com/rust-lang/rust/pull/37389
6556 [37392]: https://github.com/rust-lang/rust/pull/37392
6557 [37427]: https://github.com/rust-lang/rust/pull/37427
6558 [37439]: https://github.com/rust-lang/rust/pull/37439
6559 [37445]: https://github.com/rust-lang/rust/pull/37445
6560 [37470]: https://github.com/rust-lang/rust/pull/37470
6561 [37569]: https://github.com/rust-lang/rust/pull/37569
6562 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6563 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6564 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6565 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6566 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6567 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6568 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6569
6570
6571 Version 1.13.0 (2016-11-10)
6572 ===========================
6573
6574 Language
6575 --------
6576
6577 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6578   errors, like the `try!` macro, described in [RFC 0243].
6579 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6580 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6581 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6582 * [Fix lifetime rules for 'if' conditions][36029]
6583 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6584
6585 Compiler
6586 --------
6587
6588 * [Add the `-C link-arg` argument][36574]
6589 * [Remove the old AST-based backend from rustc_trans][35764]
6590 * [Don't enable NEON by default on armv7 Linux][35814]
6591 * [Fix debug line number info for macro expansions][35238]
6592 * [Do not emit "class method" debuginfo for types that are not
6593   DICompositeType][36008]
6594 * [Warn about multiple conflicting #[repr] hints][34623]
6595 * [When sizing DST, don't double-count nested struct prefixes][36351]
6596 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6597 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6598 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6599 * [Expand macros without recursing to avoid stack overflows][36214]
6600
6601 Diagnostics
6602 -----------
6603
6604 * [Replace macro backtraces with labeled local uses][35702]
6605 * [Improve error message for misplaced doc comments][33922]
6606 * [Buffer unix and lock windows to prevent message interleaving][35975]
6607 * [Update lifetime errors to specifically note temporaries][36171]
6608 * [Special case a few colors for Windows][36178]
6609 * [Suggest `use self` when such an import resolves][36289]
6610 * [Be more specific when type parameter shadows primitive type][36338]
6611 * Many minor improvements
6612
6613 Compile-time Optimizations
6614 --------------------------
6615
6616 * [Compute and cache HIR hashes at beginning][35854]
6617 * [Don't hash types in loan paths][36004]
6618 * [Cache projections in trans][35761]
6619 * [Optimize the parser's last token handling][36527]
6620 * [Only instantiate #[inline] functions in codegen units referencing
6621   them][36524]. This leads to big improvements in cases where crates export
6622   define many inline functions without using them directly.
6623 * [Lazily allocate TypedArena's first chunk][36592]
6624 * [Don't allocate during default HashSet creation][36734]
6625
6626 Stabilized APIs
6627 ---------------
6628
6629 * [`checked_abs`]
6630 * [`wrapping_abs`]
6631 * [`overflowing_abs`]
6632 * [`RefCell::try_borrow`]
6633 * [`RefCell::try_borrow_mut`]
6634
6635 Libraries
6636 ---------
6637
6638 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6639 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6640   covariant][35354]
6641 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6642 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6643 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6644 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6645 * [Use arc4rand on FreeBSD][35884]
6646 * [memrchr: Correct aligned offset computation][35969]
6647 * [Improve Demangling of Rust Symbols][36059]
6648 * [Use monotonic time in condition variables][35048]
6649 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6650 * [Implement conversion traits for `char`][35755]
6651 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6652 * [Zero first byte of CString on drop][36264]
6653 * [Inherit overflow checks for sum and product][36372]
6654 * [Add missing Eq implementations][36423]
6655 * [Implement `Debug` for `DirEntry`][36631]
6656 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6657   `errno`][36754]
6658 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6659 * [Implement more traits for `std::io::ErrorKind`][35911]
6660 * [Optimize BinaryHeap bounds checking][36072]
6661 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6662   `extend_with_element`][36355]
6663 * [Fix overflow checking in unsigned pow()][34942]
6664
6665 Cargo
6666 -----
6667
6668 * This release includes security fixes to both curl and OpenSSL.
6669 * [Fix transitive doctests when panic=abort][cargo/3021]
6670 * [Add --all-features flag to cargo][cargo/3038]
6671 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6672 * [Don't parse the home directory more than once][cargo/3078]
6673 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6674 * [Update OpenSSL to 1.0.2j][cargo/3121]
6675 * [Add license and license_file to cargo metadata output][cargo/3110]
6676 * [Make crates-io registry URL optional in config; ignore all changes to
6677   source.crates-io][cargo/3089]
6678 * [Don't download dependencies from other platforms][cargo/3123]
6679 * [Build transitive dev-dependencies when needed][cargo/3125]
6680 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6681 * [Avoid updating registry when adding existing deps][cargo/3144]
6682 * [Warn about path overrides that won't work][cargo/3136]
6683 * [Use workspaces during `cargo install`][cargo/3146]
6684 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6685 * [Add --message-format flag][cargo/3000]
6686 * [Pass target environment for rustdoc][cargo/3205]
6687 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6688 * [Update curl and curl-sys][cargo/3241]
6689 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6690
6691 Tooling
6692 -------
6693
6694 * [rustdoc: Add the `--sysroot` argument][36586]
6695 * [rustdoc: Fix a couple of issues with the search results][35655]
6696 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6697 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6698 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6699
6700 Misc
6701 ----
6702
6703 * [Remove unmaintained style guide][35124]
6704 * [Add s390x support][36369]
6705 * [Initial work at Haiku OS support][36727]
6706 * [Add mips-uclibc targets][35734]
6707 * [Crate-ify compiler-rt into compiler-builtins][35021]
6708 * [Add rustc version info (git hash + date) to dist tarball][36213]
6709 * Many documentation improvements
6710
6711 Compatibility Notes
6712 -------------------
6713
6714 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6715 * [Deny (by default) transmuting from fn item types to pointer-sized
6716   types][34923]. Continuing the long transition to zero-sized fn items,
6717   per [RFC 401].
6718 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6719   Part of [RFC 1506].
6720 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6721 * [Fix lifetime rules for 'if' conditions][36029].
6722 * [Inherit overflow checks for sum and product][36372].
6723 * [Forbid user-defined macros named "macro_rules"][36730].
6724
6725 [33922]: https://github.com/rust-lang/rust/pull/33922
6726 [34623]: https://github.com/rust-lang/rust/pull/34623
6727 [34923]: https://github.com/rust-lang/rust/pull/34923
6728 [34942]: https://github.com/rust-lang/rust/pull/34942
6729 [34982]: https://github.com/rust-lang/rust/pull/34982
6730 [35021]: https://github.com/rust-lang/rust/pull/35021
6731 [35048]: https://github.com/rust-lang/rust/pull/35048
6732 [35074]: https://github.com/rust-lang/rust/pull/35074
6733 [35124]: https://github.com/rust-lang/rust/pull/35124
6734 [35234]: https://github.com/rust-lang/rust/pull/35234
6735 [35238]: https://github.com/rust-lang/rust/pull/35238
6736 [35354]: https://github.com/rust-lang/rust/pull/35354
6737 [35559]: https://github.com/rust-lang/rust/pull/35559
6738 [35585]: https://github.com/rust-lang/rust/pull/35585
6739 [35627]: https://github.com/rust-lang/rust/pull/35627
6740 [35655]: https://github.com/rust-lang/rust/pull/35655
6741 [35702]: https://github.com/rust-lang/rust/pull/35702
6742 [35707]: https://github.com/rust-lang/rust/pull/35707
6743 [35728]: https://github.com/rust-lang/rust/pull/35728
6744 [35734]: https://github.com/rust-lang/rust/pull/35734
6745 [35755]: https://github.com/rust-lang/rust/pull/35755
6746 [35761]: https://github.com/rust-lang/rust/pull/35761
6747 [35764]: https://github.com/rust-lang/rust/pull/35764
6748 [35814]: https://github.com/rust-lang/rust/pull/35814
6749 [35854]: https://github.com/rust-lang/rust/pull/35854
6750 [35871]: https://github.com/rust-lang/rust/pull/35871
6751 [35884]: https://github.com/rust-lang/rust/pull/35884
6752 [35911]: https://github.com/rust-lang/rust/pull/35911
6753 [35969]: https://github.com/rust-lang/rust/pull/35969
6754 [35975]: https://github.com/rust-lang/rust/pull/35975
6755 [36004]: https://github.com/rust-lang/rust/pull/36004
6756 [36008]: https://github.com/rust-lang/rust/pull/36008
6757 [36014]: https://github.com/rust-lang/rust/pull/36014
6758 [36029]: https://github.com/rust-lang/rust/pull/36029
6759 [36059]: https://github.com/rust-lang/rust/pull/36059
6760 [36072]: https://github.com/rust-lang/rust/pull/36072
6761 [36101]: https://github.com/rust-lang/rust/pull/36101
6762 [36104]: https://github.com/rust-lang/rust/pull/36104
6763 [36171]: https://github.com/rust-lang/rust/pull/36171
6764 [36173]: https://github.com/rust-lang/rust/pull/36173
6765 [36178]: https://github.com/rust-lang/rust/pull/36178
6766 [36213]: https://github.com/rust-lang/rust/pull/36213
6767 [36214]: https://github.com/rust-lang/rust/pull/36214
6768 [36264]: https://github.com/rust-lang/rust/pull/36264
6769 [36266]: https://github.com/rust-lang/rust/pull/36266
6770 [36289]: https://github.com/rust-lang/rust/pull/36289
6771 [36338]: https://github.com/rust-lang/rust/pull/36338
6772 [36351]: https://github.com/rust-lang/rust/pull/36351
6773 [36355]: https://github.com/rust-lang/rust/pull/36355
6774 [36369]: https://github.com/rust-lang/rust/pull/36369
6775 [36372]: https://github.com/rust-lang/rust/pull/36372
6776 [36423]: https://github.com/rust-lang/rust/pull/36423
6777 [36482]: https://github.com/rust-lang/rust/pull/36482
6778 [36505]: https://github.com/rust-lang/rust/pull/36505
6779 [36524]: https://github.com/rust-lang/rust/pull/36524
6780 [36527]: https://github.com/rust-lang/rust/pull/36527
6781 [36551]: https://github.com/rust-lang/rust/pull/36551
6782 [36574]: https://github.com/rust-lang/rust/pull/36574
6783 [36586]: https://github.com/rust-lang/rust/pull/36586
6784 [36592]: https://github.com/rust-lang/rust/pull/36592
6785 [36631]: https://github.com/rust-lang/rust/pull/36631
6786 [36639]: https://github.com/rust-lang/rust/pull/36639
6787 [36721]: https://github.com/rust-lang/rust/pull/36721
6788 [36727]: https://github.com/rust-lang/rust/pull/36727
6789 [36730]: https://github.com/rust-lang/rust/pull/36730
6790 [36734]: https://github.com/rust-lang/rust/pull/36734
6791 [36754]: https://github.com/rust-lang/rust/pull/36754
6792 [36995]: https://github.com/rust-lang/rust/pull/36995
6793 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6794 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6795 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6796 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6797 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6798 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6799 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6800 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6801 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6802 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6803 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6804 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6805 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6806 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6807 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6808 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6809 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6810 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6811 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6812 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6813 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6814 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6815 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6816 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6817 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6818 [rustup]: https://www.rustup.rs
6819 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6820 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6821 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6822 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6823 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6824 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6825 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6826
6827
6828 Version 1.12.1 (2016-10-20)
6829 ===========================
6830
6831 Regression Fixes
6832 ----------------
6833
6834 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6835 * [Confusion with double negation and booleans][36856]
6836 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6837 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6838 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6839 * [Corrupted memory after updated to 1.12][36936]
6840 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6841 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6842 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6843
6844 [36381]: https://github.com/rust-lang/rust/issues/36381
6845 [36856]: https://github.com/rust-lang/rust/issues/36856
6846 [36875]: https://github.com/rust-lang/rust/issues/36875
6847 [36924]: https://github.com/rust-lang/rust/issues/36924
6848 [36926]: https://github.com/rust-lang/rust/issues/36926
6849 [36936]: https://github.com/rust-lang/rust/issues/36936
6850 [37026]: https://github.com/rust-lang/rust/issues/37026
6851 [37112]: https://github.com/rust-lang/rust/issues/37112
6852 [37153]: https://github.com/rust-lang/rust/issues/37153
6853
6854
6855 Version 1.12.0 (2016-09-29)
6856 ===========================
6857
6858 Highlights
6859 ----------
6860
6861 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6862   This translation pass is far simpler than the previous AST->LLVM pass, and
6863   creates opportunities to perform new optimizations directly on the MIR. It
6864   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6865 * [`rustc` presents a new, more readable error format, along with
6866   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6867   Most common editors supporting Rust have been updated to work with it. It was
6868   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6869
6870 Compiler
6871 --------
6872
6873 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6874   This translation pass is far simpler than the previous AST->LLVM pass, and
6875   creates opportunities to perform new optimizations directly on the MIR. It
6876   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6877 * [Print the Rust target name, not the LLVM target name, with
6878   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6879 * [The computation of `TypeId` is correct in some cases where it was previously
6880   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6881 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6882 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6883   `--print relocation-models`, and `--print code-models` print the available
6884   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6885   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6886 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6887   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6888   These targets produce statically-linked binaries. There are no binary release
6889   builds yet though.
6890
6891 Diagnostics
6892 -----------
6893
6894 * [`rustc` presents a new, more readable error format, along with
6895   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6896   Most common editors supporting Rust have been updated to work with it. It was
6897   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6898 * [In error descriptions, references are now described in plain English,
6899   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6900 * [In error type descriptions, unknown numeric types are named `{integer}` or
6901   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6902 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6903
6904 Language
6905 --------
6906
6907 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6908 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6909 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6910   useful](https://github.com/rust-lang/rust/pull/34908)
6911 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6912   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6913 * [Semicolons are properly required as statement delimiters inside
6914   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6915 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6916
6917 Stabilized APIs
6918 ---------------
6919
6920 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6921 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6922 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6923 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6924 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6925 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6926 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6927 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6928 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6929 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6930   Both on Unix and Windows.
6931 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6932 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6933 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6934 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6935 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6936 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6937 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6938 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6939
6940 Libraries
6941 ---------
6942
6943 * [The `format!` macro and friends now allow a single argument to be formatted
6944   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6945 * [The lifetime bounds on `[T]::binary_search_by` and
6946   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6947 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6948 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6949 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6950 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6951 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6952 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6953 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6954 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6955   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6956 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6957   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6958 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6959 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6960   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6961 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6962 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6963 * [`mpsc::sync_channel` `Receiver`s return any available message before
6964   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6965 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6966 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6967
6968 Cargo
6969 -----
6970
6971 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6972 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6973 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6974 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6975 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6976 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6977 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6978 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6979 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6980 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6981 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6982 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6983 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6984 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6985 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6986 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6987
6988 Performance
6989 -----------
6990
6991 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6992 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6993
6994 Tooling
6995 -------
6996
6997 * [Test binaries now support a `--test-threads` argument to specify the number
6998   of threads used to run tests, and which acts the same as the
6999   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7000 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7001 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7002 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7003 * [Rust releases now come with source packages that can be installed by rustup
7004   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7005   The resulting source code can be used by tools and IDES, located in the
7006   sysroot under `lib/rustlib/src`.
7007
7008 Misc
7009 ----
7010
7011 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7012 * Many minor improvements to the documentation.
7013 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7014
7015 Compatibility Notes
7016 -------------------
7017
7018 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7019   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7020 * [When formatting strings, if "precision" is specified, the "fill",
7021   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7022 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7023
7024
7025 Version 1.11.0 (2016-08-18)
7026 ===========================
7027
7028 Language
7029 --------
7030
7031 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7032 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7033 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7034 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7035
7036 Stabilized APIs
7037 ---------------
7038
7039 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7040 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7041 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7042 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7043 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7044 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7045   (in libcore - previously stabilized in libstd)
7046 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7047   (in libcore - previously stabilized in libstd)
7048 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7049   (in libcore - previously stabilized in libstd)
7050 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7051   (in libcore - previously stabilized in libstd)
7052 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7053 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7054 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7055 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7056
7057 Libraries
7058 ---------
7059
7060 * [The `thread_local!` macro supports multiple definitions in a single
7061    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7062 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7063 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7064   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7065 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7066 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7067 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7068 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7069
7070 Cargo
7071 -----
7072
7073 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7074 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7075 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7076 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7077 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7078   and `-vv` prints warnings for all crates.
7079 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7080 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7081   This provides room for expansion by arbitrary tools.
7082 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7083 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7084 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7085 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7086 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7087 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7088 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7089
7090 Performance
7091 -----------
7092
7093 * [Caching projections speeds up type check dramatically for some
7094   workloads](https://github.com/rust-lang/rust/pull/33816)
7095 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7096   This hasher is faster, but is believed to provide sufficient
7097   protection from collision attacks.
7098 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7099
7100 Rustdoc
7101 -------
7102
7103 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7104 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7105 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7106 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7107 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7108
7109 Tooling
7110 -------
7111
7112 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7113 * [When emitting debug info, rustc emits frame pointers for closures,
7114   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7115 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7116 * Many more errors have been given error codes and extended
7117   explanations
7118 * API documentation continues to be improved, with many new examples
7119
7120 Misc
7121 ----
7122
7123 * [rustc no longer hangs when dependencies recursively re-export
7124   submodules](https://github.com/rust-lang/rust/pull/34542)
7125 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7126 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7127   rewritten](https://github.com/rust-lang/rust/pull/33895)
7128 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7129   No targets use this yet, but it works toward AVR support.
7130
7131 Compatibility Notes
7132 -------------------
7133
7134 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7135 * [The new follow-set rules that place restrictions on `macro_rules!`
7136   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7137   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7138   and has been a warning since 1.10.
7139 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7140   This causes breakage in some corner cases.
7141
7142
7143 Version 1.10.0 (2016-07-07)
7144 ===========================
7145
7146 Language
7147 --------
7148
7149 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7150   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7151 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7152 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7153 * [`panic!` can be converted to a runtime abort with the
7154   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7155   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7156 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7157   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7158   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7159   Note that Cargo does not yet directly support cdylibs.
7160
7161 Stabilized APIs
7162 ---------------
7163
7164 * `os::windows::fs::OpenOptionsExt::access_mode`
7165 * `os::windows::fs::OpenOptionsExt::share_mode`
7166 * `os::windows::fs::OpenOptionsExt::custom_flags`
7167 * `os::windows::fs::OpenOptionsExt::attributes`
7168 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7169 * `os::unix::fs::OpenOptionsExt::custom_flags`
7170 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7171 * `Default for sync::Weak`
7172 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7173 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7174 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7175 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7176 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7177 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7178 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7179 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7180 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7181 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7182 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7183 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7184 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7185 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7186 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7187 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7188 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7189 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7190 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7191 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7192 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7193 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7194 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7195 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7196 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7197 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7198 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7199 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7200 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7201 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7202 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7203 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7204 * Read/Write/RawFd impls for `UnixStream`
7205 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7206 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7207 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7208 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7209 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7210 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7211 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7212 * RawFd impls for `UnixListener`
7213 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7214 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7215 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7216 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7217 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7218 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7219 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7220 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7221 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7222 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7223 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7224 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7225 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7226 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7227 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7228 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7229 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7230 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7231 * RawFd impls for `UnixDatagram`
7232 * `{BTree,Hash}Map::values_mut`
7233 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7234
7235 Libraries
7236 ---------
7237
7238 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7239   The semantics of this minor method are subtle and probably not what
7240   most people want.
7241 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7242 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7243   will fall back to `/dev/urandom` temporarily to avoid blocking
7244   during early boot](https://github.com/rust-lang/rust/pull/33086).
7245 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7246 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7247 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7248 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7249 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7250 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7251   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7252
7253 Cargo
7254 -----
7255 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7256   This controls the runtime behavior of the `panic!` macro
7257   and can be either "unwind" (the default), or "abort".
7258   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7259 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7260 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7261 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7262   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7263 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7264 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7265 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7266   By default they are retried twice, which can be customized with the
7267   `net.retry` value in `.cargo/config`.
7268 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7269 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7270 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7271 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7272   Makes it possible to install multiple crates in parallel.
7273 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7274 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7275 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7276 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7277 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7278 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7279
7280 Performance
7281 -----------
7282
7283 * [rustc memory usage was reduced by refactoring the context used for
7284   type checking](https://github.com/rust-lang/rust/pull/33425).
7285 * [Speed up creation of `HashMap`s by caching the random keys used
7286   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7287 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7288 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7289 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7290   10x faster than the previous lookup tables.
7291 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7292
7293 Usability
7294 ---------
7295
7296 * Many incremental improvements to documentation and rustdoc.
7297 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7298 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7299 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7300 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7301 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7302 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7303 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7304
7305 Misc
7306 ----
7307
7308 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7309 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7310 * [`std` no longer prints backtraces on platforms where the running
7311   module must be loaded with `env::current_exe`, which can't be relied
7312   on](https://github.com/rust-lang/rust/pull/33554).
7313 * This release includes std binaries for the i586-unknown-linux-gnu,
7314   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7315   i586 target is for old x86 hardware without SSE2, and the armv7
7316   target is for Android running on modern ARM architectures.
7317 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7318   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7319 * [On Unix the runtime aborts by calling `libc::abort` instead of
7320   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7321 * [Rust is now bootstrapped from the previous release of Rust,
7322   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7323
7324 Compatibility Notes
7325 -------------------
7326
7327 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7328 * [`target_env` for Linux ARM targets is just `gnu`, not
7329   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7330 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7331 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7332 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7333   Affects how macros are parsed.
7334 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7335 * [Feature-gated attributes on macro-generated macro invocations are
7336   now rejected](https://github.com/rust-lang/rust/pull/32791).
7337 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7338   This caused some minor changes to type inference.
7339
7340
7341 Version 1.9.0 (2016-05-26)
7342 ==========================
7343
7344 Language
7345 --------
7346
7347 * The `#[deprecated]` attribute when applied to an API will generate
7348   warnings when used. The warnings may be suppressed with
7349   `#[allow(deprecated)]`. [RFC 1270].
7350 * [`fn` item types are zero sized, and each `fn` names a unique
7351   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7352   `transmute` on a `fn` type will generate a warning for a few cycles,
7353   then will be converted to an error.
7354 * [Field and method resolution understand visibility, so private
7355   fields and methods cannot prevent the proper use of public fields
7356   and methods][1.9fv].
7357 * [The parser considers unicode codepoints in the
7358   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7359
7360 Stabilized APIs
7361 ---------------
7362
7363 * [`std::panic`]
7364 * [`std::panic::catch_unwind`] (renamed from `recover`)
7365 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7366 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7367 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7368 * [`str::is_char_boundary`]
7369 * [`<*const T>::as_ref`]
7370 * [`<*mut T>::as_ref`]
7371 * [`<*mut T>::as_mut`]
7372 * [`AsciiExt::make_ascii_uppercase`]
7373 * [`AsciiExt::make_ascii_lowercase`]
7374 * [`char::decode_utf16`]
7375 * [`char::DecodeUtf16`]
7376 * [`char::DecodeUtf16Error`]
7377 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7378 * [`BTreeSet::take`]
7379 * [`BTreeSet::replace`]
7380 * [`BTreeSet::get`]
7381 * [`HashSet::take`]
7382 * [`HashSet::replace`]
7383 * [`HashSet::get`]
7384 * [`OsString::with_capacity`]
7385 * [`OsString::clear`]
7386 * [`OsString::capacity`]
7387 * [`OsString::reserve`]
7388 * [`OsString::reserve_exact`]
7389 * [`OsStr::is_empty`]
7390 * [`OsStr::len`]
7391 * [`std::os::unix::thread`]
7392 * [`RawPthread`]
7393 * [`JoinHandleExt`]
7394 * [`JoinHandleExt::as_pthread_t`]
7395 * [`JoinHandleExt::into_pthread_t`]
7396 * [`HashSet::hasher`]
7397 * [`HashMap::hasher`]
7398 * [`CommandExt::exec`]
7399 * [`File::try_clone`]
7400 * [`SocketAddr::set_ip`]
7401 * [`SocketAddr::set_port`]
7402 * [`SocketAddrV4::set_ip`]
7403 * [`SocketAddrV4::set_port`]
7404 * [`SocketAddrV6::set_ip`]
7405 * [`SocketAddrV6::set_port`]
7406 * [`SocketAddrV6::set_flowinfo`]
7407 * [`SocketAddrV6::set_scope_id`]
7408 * [`slice::copy_from_slice`]
7409 * [`ptr::read_volatile`]
7410 * [`ptr::write_volatile`]
7411 * [`OpenOptions::create_new`]
7412 * [`TcpStream::set_nodelay`]
7413 * [`TcpStream::nodelay`]
7414 * [`TcpStream::set_ttl`]
7415 * [`TcpStream::ttl`]
7416 * [`TcpStream::set_only_v6`]
7417 * [`TcpStream::only_v6`]
7418 * [`TcpStream::take_error`]
7419 * [`TcpStream::set_nonblocking`]
7420 * [`TcpListener::set_ttl`]
7421 * [`TcpListener::ttl`]
7422 * [`TcpListener::set_only_v6`]
7423 * [`TcpListener::only_v6`]
7424 * [`TcpListener::take_error`]
7425 * [`TcpListener::set_nonblocking`]
7426 * [`UdpSocket::set_broadcast`]
7427 * [`UdpSocket::broadcast`]
7428 * [`UdpSocket::set_multicast_loop_v4`]
7429 * [`UdpSocket::multicast_loop_v4`]
7430 * [`UdpSocket::set_multicast_ttl_v4`]
7431 * [`UdpSocket::multicast_ttl_v4`]
7432 * [`UdpSocket::set_multicast_loop_v6`]
7433 * [`UdpSocket::multicast_loop_v6`]
7434 * [`UdpSocket::set_multicast_ttl_v6`]
7435 * [`UdpSocket::multicast_ttl_v6`]
7436 * [`UdpSocket::set_ttl`]
7437 * [`UdpSocket::ttl`]
7438 * [`UdpSocket::set_only_v6`]
7439 * [`UdpSocket::only_v6`]
7440 * [`UdpSocket::join_multicast_v4`]
7441 * [`UdpSocket::join_multicast_v6`]
7442 * [`UdpSocket::leave_multicast_v4`]
7443 * [`UdpSocket::leave_multicast_v6`]
7444 * [`UdpSocket::take_error`]
7445 * [`UdpSocket::connect`]
7446 * [`UdpSocket::send`]
7447 * [`UdpSocket::recv`]
7448 * [`UdpSocket::set_nonblocking`]
7449
7450 Libraries
7451 ---------
7452
7453 * [`std::sync::Once` is poisoned if its initialization function
7454   fails][1.9o].
7455 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7456 * [Most types implement `fmt::Debug`][1.9db].
7457 * [The default buffer size used by `BufReader` and `BufWriter` was
7458   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7459   used by other languages.
7460 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7461   `Duration` additionally implements `*=` and `/=`][1.9ta].
7462 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7463 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7464 * [`Chain` implements `BufRead`][1.9ch].
7465 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7466
7467 Cargo
7468 -----
7469
7470 * [Cargo can now run concurrently][1.9cc].
7471 * [Top-level overrides allow specific revisions of crates to be
7472   overridden through the entire crate graph][1.9ct].  This is intended
7473   to make upgrades easier for large projects, by allowing crates to be
7474   forked temporarily until they've been upgraded and republished.
7475 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7476 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7477   on the commandline][1.9cf]. `rustc` arguments can also be specified
7478   in the `build.rustflags` configuration key.
7479
7480 Performance
7481 -----------
7482
7483 * [The time complexity of comparing variables for equivalence during type
7484   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7485   to major compilation time improvement in some scenarios.
7486 * [`ToString` is specialized for `str`, giving it the same performance
7487   as `to_owned`][1.9ts].
7488 * [Spawning processes with `Command::output` no longer creates extra
7489   threads][1.9sp].
7490 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7491   for C-like enums][1.9cl].
7492
7493 Misc
7494 ----
7495
7496 * [Passing the `--quiet` flag to a test runner will produce
7497   much-abbreviated output][1.9q].
7498 * The Rust Project now publishes std binaries for the
7499   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7500   `i586-pc-windows-msvc` targets.
7501
7502 Compatibility Notes
7503 -------------------
7504
7505 * [`std::sync::Once` is poisoned if its initialization function
7506   fails][1.9o].
7507 * [It is illegal to define methods with the same name in overlapping
7508   inherent `impl` blocks][1.9sn].
7509 * [`fn` item types are zero sized, and each `fn` names a unique
7510   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7511   `transmute` on a `fn` type will generate a warning for a few cycles,
7512   then will be converted to an error.
7513 * [Improvements to const evaluation may trigger new errors when integer
7514   literals are out of range][1.9ce].
7515
7516
7517 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7518 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7519 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7520 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7521 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7522 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7523 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7524 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7525 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7526 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7527 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7528 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7529 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7530 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7531 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7532 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7533 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7534 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7535 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7536 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7537 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7538 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7539 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7540 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7541 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7542 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7543 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7544 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7545 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7546 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7547 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7548 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7549 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7550 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7551 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7552 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7553 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7554 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7555 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7556 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7557 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7558 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7559 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7560 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7561 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7562 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7563 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7564 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7565 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7566 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7567 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7568 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7569 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7570 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7571 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7572 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7573 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7574 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7575 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7576 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7577 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7578 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7579 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7580 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7581 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7582 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7583 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7584 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7585 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7586 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7587 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7588 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7589 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7590 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7591 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7592 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7593 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7594 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7595 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7596 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7597 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7598 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7599 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7600 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7601 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7602 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7603 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7604 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7605 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7606 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7607 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7608 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7609 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7610 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7611 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7612 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7613 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7614 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7615 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7616 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7617 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7618 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7619 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7620 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7621 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7622 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7623 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7624 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7625 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7626 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7627
7628
7629 Version 1.8.0 (2016-04-14)
7630 ==========================
7631
7632 Language
7633 --------
7634
7635 * Rust supports overloading of compound assignment statements like
7636   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7637   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7638   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7639   traits. [RFC 953].
7640 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7641   addition to the non-braced form, `struct Foo;`. [RFC 218].
7642
7643 Libraries
7644 ---------
7645
7646 * Stabilized APIs:
7647   * [`str::encode_utf16`] (renamed from `utf16_units`)
7648   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7649   * [`Ref::map`]
7650   * [`RefMut::map`]
7651   * [`ptr::drop_in_place`]
7652   * [`time::Instant`]
7653   * [`time::SystemTime`]
7654   * [`Instant::now`]
7655   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7656   * [`Instant::elapsed`]
7657   * [`SystemTime::now`]
7658   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7659   * [`SystemTime::elapsed`]
7660   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7661   * [`SystemTimeError`]
7662   * [`SystemTimeError::duration`]
7663   * Various impls for `SystemTimeError`
7664   * [`UNIX_EPOCH`]
7665   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7666     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7667     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7668 * [The `write!` and `writeln!` macros correctly emit errors if any of
7669   their arguments can't be formatted][1.8w].
7670 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7671 * [The Unix-specific `raw` modules, which contain a number of
7672   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7673   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7674   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7675   across platforms was making it difficult to implement `std`
7676   correctly. Those that need these definitions should use the `libc`
7677   crate. [RFC 1415].
7678 * The Unix-specific `MetadataExt` traits, including
7679   `os::unix::fs::MetadataExt`, which expose values such as inode
7680   numbers [no longer return platform-specific types][1.8r], but
7681   instead return widened integers. [RFC 1415].
7682 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7683 * [Atomic loads and stores are not volatile][1.8a].
7684 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7685
7686 Performance
7687 -----------
7688
7689 * [Inlining hash functions lead to a 3% compile-time improvement in
7690   some workloads][1.8h].
7691 * When using jemalloc, its symbols are [unprefixed so that it
7692   overrides the libc malloc implementation][1.8h]. This means that for
7693   rustc, LLVM is now using jemalloc, which results in a 6%
7694   compile-time improvement on a specific workload.
7695 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7696
7697 Misc
7698 ----
7699
7700 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7701   i686-pc-windows-msvc is now considered a tier-1 platform.
7702 * [The `--print targets` flag prints a list of supported targets][1.8t].
7703 * [The `--print cfg` flag prints the `cfg`s defined for the current
7704   target][1.8cf].
7705 * [`rustc` can be built with an new Cargo-based build system, written
7706   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7707   build system. To enable it configure with `configure --rustbuild`.
7708 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7709   variants while also indicating the total number of missing variants
7710   if more than 3][1.8m].
7711 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7712 * The Rust Project now publishes binary releases of the standard
7713   library for a number of tier-2 targets:
7714   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7715   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7716   `x86_64-rumprun-netbsd`. These can be installed with
7717   tools such as [multirust][1.8mr].
7718
7719 Cargo
7720 -----
7721
7722 * [`cargo init` creates a new Cargo project in the current
7723   directory][1.8ci].  It is otherwise like `cargo new`.
7724 * [Cargo has configuration keys for `-v` and
7725   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7726   `[term]` section of `.cargo/config`.
7727 * [Configuration keys that evaluate to strings or integers can be set
7728   via environment variables][1.8ce]. For example the `build.jobs` key
7729   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7730   precedence over config files.
7731 * [Target-specific dependencies support Rust `cfg` syntax for
7732   describing targets][1.8cfg] so that dependencies for multiple
7733   targets can be specified together. [RFC 1361].
7734 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7735   `RUSTDOC` take precedence over the `build.target-dir`,
7736   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7737 * [The child process tree is killed on Windows when Cargo is
7738   killed][1.8ck].
7739 * [The `build.target` configuration value sets the target platform,
7740   like `--target`][1.8ct].
7741
7742 Compatibility Notes
7743 -------------------
7744
7745 * [Unstable compiler flags have been further restricted][1.8u]. Since
7746   1.0 `-Z` flags have been considered unstable, and other flags that
7747   were considered unstable additionally required passing `-Z
7748   unstable-options` to access. Unlike unstable language and library
7749   features though, these options have been accessible on the stable
7750   release channel. Going forward, *new unstable flags will not be
7751   available on the stable release channel*, and old unstable flags
7752   will warn about their usage. In the future, all unstable flags will
7753   be unavailable on the stable release channel.
7754 * [It is no longer possible to `match` on empty enum variants using
7755   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7756 * The Unix-specific `MetadataExt` traits, including
7757   `os::unix::fs::MetadataExt`, which expose values such as inode
7758   numbers [no longer return platform-specific types][1.8r], but
7759   instead return widened integers. [RFC 1415].
7760 * [Modules sourced from the filesystem cannot appear within arbitrary
7761   blocks, but only within other modules][1.8mf].
7762 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7763 * On Unix, [stack overflow triggers a runtime abort instead of a
7764   SIGSEGV][1.8so].
7765 * [`Command::spawn` and its equivalents return an error if any of
7766   its command-line arguments contain interior `NUL`s][1.8n].
7767 * [Tuple and unit enum variants from other crates are in the type
7768   namespace][1.8tn].
7769 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7770   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7771   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7772   instead of `foo.lib`.
7773
7774
7775 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7776 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7777 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7778 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7779 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7780 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7781 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7782 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7783 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7784 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7785 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7786 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7787 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7788 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7789 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7790 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7791 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7792 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7793 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7794 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7795 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7796 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7797 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7798 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7799 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7800 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7801 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7802 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7803 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7804 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7805 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7806 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7807 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7808 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7809 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7810 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7811 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7812 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7813 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7814 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7815 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7816 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7817 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7818 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7819 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7820 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7821 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7822 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7823 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7824 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7825 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7826 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7827 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7828 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7829 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7830 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7831 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7832 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7833 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7834 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7835
7836
7837 Version 1.7.0 (2016-03-03)
7838 ==========================
7839
7840 Libraries
7841 ---------
7842
7843 * Stabilized APIs
7844   * `Path`
7845     * [`Path::strip_prefix`] (renamed from relative_from)
7846     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7847   * `Ipv4Addr`
7848     * [`Ipv4Addr::is_loopback`]
7849     * [`Ipv4Addr::is_private`]
7850     * [`Ipv4Addr::is_link_local`]
7851     * [`Ipv4Addr::is_multicast`]
7852     * [`Ipv4Addr::is_broadcast`]
7853     * [`Ipv4Addr::is_documentation`]
7854   * `Ipv6Addr`
7855     * [`Ipv6Addr::is_unspecified`]
7856     * [`Ipv6Addr::is_loopback`]
7857     * [`Ipv6Addr::is_multicast`]
7858   * `Vec`
7859     * [`Vec::as_slice`]
7860     * [`Vec::as_mut_slice`]
7861   * `String`
7862     * [`String::as_str`]
7863     * [`String::as_mut_str`]
7864   * Slices
7865     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7866     be the same length
7867     * `<[T]>::`[`sort_by_key`]
7868   * checked, saturated, and overflowing operations
7869     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7870     * [`i32::saturating_mul`]
7871     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7872     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7873     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7874     * [`u32::saturating_mul`]
7875     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7876     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7877     * and checked, saturated, and overflowing operations for other primitive types
7878   * FFI
7879     * [`ffi::IntoStringError`]
7880     * [`CString::into_string`]
7881     * [`CString::into_bytes`]
7882     * [`CString::into_bytes_with_nul`]
7883     * `From<CString> for Vec<u8>`
7884   * `IntoStringError`
7885     * [`IntoStringError::into_cstring`]
7886     * [`IntoStringError::utf8_error`]
7887     * `Error for IntoStringError`
7888   * Hashing
7889     * [`std::hash::BuildHasher`]
7890     * [`BuildHasher::Hasher`]
7891     * [`BuildHasher::build_hasher`]
7892     * [`std::hash::BuildHasherDefault`]
7893     * [`HashMap::with_hasher`]
7894     * [`HashMap::with_capacity_and_hasher`]
7895     * [`HashSet::with_hasher`]
7896     * [`HashSet::with_capacity_and_hasher`]
7897     * [`std::collections::hash_map::RandomState`]
7898     * [`RandomState::new`]
7899 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7900   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7901   from bytes is faster.
7902 * [The performance of `LineWriter` (and thus `io::stdout`) was
7903   improved by using `memchr` to search for newlines][1.7m].
7904 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7905   `f64` variants were stabilized previously.
7906 * [`BTreeMap` was rewritten to use less memory and improve the performance
7907   of insertion and iteration, the latter by as much as 5x][1.7bm].
7908 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7909   covariant over their contained type][1.7bt].
7910 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7911   over their contained type][1.7ll].
7912 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7913   searching methods.
7914 * [`Any` is implemented for unsized types][1.7a].
7915 * [`Hash` is implemented for `Duration`][1.7h].
7916
7917 Misc
7918 ----
7919
7920 * [When running tests with `--test`, rustdoc will pass `--cfg`
7921   arguments to the compiler][1.7dt].
7922 * [The compiler is built with RPATH information by default][1.7rpa].
7923   This means that it will be possible to run `rustc` when installed in
7924   unusual configurations without configuring the dynamic linker search
7925   path explicitly.
7926 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7927   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7928   over `LD_LIBRARY_PATH`.
7929
7930 Cargo
7931 -----
7932
7933 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7934   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7935 * [The `rerun-if-changed` build script directive no longer causes the
7936   build script to incorrectly run twice in certain scenarios][1.7rr].
7937
7938 Compatibility Notes
7939 -------------------
7940
7941 * Soundness fixes to the interactions between associated types and
7942   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7943   code that violates the new rules. This is a significant change that
7944   is known to break existing code, so it has emitted warnings for the
7945   new error cases since 1.4 to give crate authors time to adapt. The
7946   details of what is changing are subtle; read the RFC for more.
7947 * [Several bugs in the compiler's visibility calculations were
7948   fixed][1.7v]. Since this was found to break significant amounts of
7949   code, the new errors will be emitted as warnings for several release
7950   cycles, under the `private_in_public` lint.
7951 * Defaulted type parameters were accidentally accepted in positions
7952   that were not intended. In this release, [defaulted type parameters
7953   appearing outside of type definitions will generate a
7954   warning][1.7d], which will become an error in future releases.
7955 * [Parsing "." as a float results in an error instead of 0][1.7p].
7956   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7957 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7958
7959 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7960 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7961 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7962 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7963 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7964 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7965 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7966 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7967 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7968 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7969 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7970 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7971 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7972 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7973 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7974 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7975 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7976 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7977 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7978 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7979 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7980 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7981 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7982 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7983 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7984 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7985 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7986 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7987 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7988 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7989 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7990 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7991 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7992 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7993 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7994 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7995 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7996 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7997 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7998 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7999 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8000 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8001 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8002 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8003 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8004 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8005 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8006 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8007 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8008 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8009 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8010 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8011 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8012 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8013 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8014 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8015 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8016 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8017 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8018 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8019 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8020 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8021 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8022 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8023 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8024 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8025 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8026 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8027 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8028 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8029 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8030 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8031 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8032 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8033 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8034 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8035 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8036 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8037 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8038
8039
8040 Version 1.6.0 (2016-01-21)
8041 ==========================
8042
8043 Language
8044 --------
8045
8046 * The `#![no_std]` attribute causes a crate to not be linked to the
8047   standard library, but only the [core library][1.6co], as described
8048   in [RFC 1184]. The core library defines common types and traits but
8049   has no platform dependencies whatsoever, and is the basis for Rust
8050   software in environments that cannot support a full port of the
8051   standard library, such as operating systems. Most of the core
8052   library is now stable.
8053
8054 Libraries
8055 ---------
8056
8057 * Stabilized APIs:
8058   [`Read::read_exact`],
8059   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8060   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8061   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8062   [`os::unix::fs::DirBuilderExt`],
8063   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8064   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8065   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8066   [`collections::hash_map::Drain`],
8067   [`collections::hash_map::HashMap::drain`],
8068   [`collections::hash_set::Drain`],
8069   [`collections::hash_set::HashSet::drain`],
8070   [`collections::binary_heap::Drain`],
8071   [`collections::binary_heap::BinaryHeap::drain`],
8072   [`Vec::extend_from_slice`] (renamed from `push_all`),
8073   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8074   [`RwLock::into_inner`],
8075   [`Iterator::min_by_key`] (renamed from `min_by`),
8076   [`Iterator::max_by_key`] (renamed from `max_by`).
8077 * The [core library][1.6co] is stable, as are most of its APIs.
8078 * [The `assert_eq!` macro supports arguments that don't implement
8079   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8080   `assert!`.
8081 * Several timer functions that take duration in milliseconds [are
8082   deprecated in favor of those that take `Duration`][1.6ms]. These
8083   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8084   `thread::park_timeout_ms`.
8085 * The algorithm by which `Vec` reserves additional elements was
8086   [tweaked to not allocate excessive space][1.6a] while still growing
8087   exponentially.
8088 * `From` conversions are [implemented from integers to floats][1.6f]
8089   in cases where the conversion is lossless. Thus they are not
8090   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8091   or `f64`. They are also not implemented for `isize` and `usize`
8092   because the implementations would be platform-specific. `From` is
8093   also implemented from `f32` to `f64`.
8094 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8095 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8096 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8097 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8098   improvements.
8099 * Sorting slices that are already sorted [is 50% faster in some
8100   cases][1.6s].
8101
8102 Cargo
8103 -----
8104
8105 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8106 * Cargo build scripts can specify their dependencies by emitting the
8107   [`rerun-if-changed`][1.6rr] key.
8108 * crates.io will reject publication of crates with dependencies that
8109   have a wildcard version constraint. Crates with wildcard
8110   dependencies were seen to cause a variety of problems, as described
8111   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8112   warning.
8113 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8114   release folder.  A variety of artifacts that Cargo failed to clean
8115   are now correctly deleted.
8116
8117 Misc
8118 ----
8119
8120 * The `unreachable_code` lint [warns when a function call's argument
8121   diverges][1.6dv].
8122 * The parser indicates [failures that may be caused by
8123   confusingly-similar Unicode characters][1.6uc]
8124 * Certain macro errors [are reported at definition time][1.6m], not
8125   expansion.
8126
8127 Compatibility Notes
8128 -------------------
8129
8130 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8131   environment variable when locating crates. This was a pre-cargo
8132   feature for integrating with the package manager that was
8133   accidentally never removed.
8134 * [A number of bugs were fixed in the privacy checker][1.6p] that
8135   could cause previously-accepted code to break.
8136 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8137 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8138   struct pattern syntax (`Foo(..)`) can no longer be used to match
8139   unit structs. This is a warning now, but will become an error in
8140   future releases. Patterns that share the same name as a const are
8141   now an error.
8142 * A bug was fixed that causes [rustc not to apply default type
8143   parameters][1.6xc] when resolving certain method implementations of
8144   traits defined in other crates.
8145
8146 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8147 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8148 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8149 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8150 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8151 [1.6co]: http://doc.rust-lang.org/core/index.html
8152 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8153 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8154 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8155 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8156 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8157 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8158 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8159 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8160 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8161 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8162 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8163 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8164 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8165 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8166 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8167 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8168 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8169 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8170 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8171 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8172 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8173 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8174 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8175 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8176 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8177 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8178 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8179 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8180 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8181 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8182 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8183 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8184 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8185 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8186 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8187 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8188 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8189 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8190 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8191 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8192 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8193
8194
8195 Version 1.5.0 (2015-12-10)
8196 ==========================
8197
8198 * ~700 changes, numerous bugfixes
8199
8200 Highlights
8201 ----------
8202
8203 * Stabilized APIs:
8204   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8205   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8206   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8207   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8208   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8209   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8210   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8211   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8212   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8213   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8214   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8215   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8216   [`Path::read_link`], [`Path::symlink_metadata`],
8217   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8218   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8219   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8220   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8221   [`slice::split_first_mut`], [`slice::split_first`],
8222   [`slice::split_last_mut`], [`slice::split_last`],
8223   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8224   [`str::MatchIndices`], [`str::RMatchIndices`],
8225   [`str::match_indices`], [`str::rmatch_indices`],
8226   [`str::slice_mut_unchecked`], [`string::ParseError`].
8227 * Rust applications hosted on crates.io can be installed locally to
8228   `~/.cargo/bin` with the [`cargo install`] command. Among other
8229   things this makes it easier to augment Cargo with new subcommands:
8230   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8231   invoked as `cargo foo`.
8232 * Crates with wildcard (`*`) dependencies will [emit warnings when
8233   published][1.5w]. In 1.6 it will no longer be possible to publish
8234   crates with wildcard dependencies.
8235
8236 Breaking Changes
8237 ----------------
8238
8239 * The rules determining when a particular lifetime must outlive
8240   a particular value (known as '[dropck]') have been [modified
8241   to not rely on parametricity][1.5p].
8242 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8243   and `Arc`][1.5a]. Because these smart pointer types implement
8244   `Deref`, this causes breakage in cases where the interior type
8245   contains methods of the same name.
8246 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8247   that they could drop their content. Soundness fix.
8248 * All method invocations are [properly checked][1.5wf1] for
8249   [well-formedness][1.5wf2]. Soundness fix.
8250 * Traits whose supertraits contain `Self` are [not object
8251   safe][1.5o]. Soundness fix.
8252 * Target specifications support a [`no_default_libraries`][1.5nd]
8253   setting that controls whether `-nodefaultlibs` is passed to the
8254   linker, and in turn the `is_like_windows` setting no longer affects
8255   the `-nodefaultlibs` flag.
8256 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8257 * The `#[inline]` and `#[repr]` attributes [can only appear
8258   in valid locations][1.5at].
8259 * Native libraries linked from the local crate are [passed to
8260   the linker before native libraries from upstream crates][1.5nl].
8261 * Two rarely-used attributes, `#[no_debug]` and
8262   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8263 * Negation of unsigned integers, which has been a warning for
8264   several releases, [is now behind a feature gate and will
8265   generate errors][1.5nu].
8266 * The parser accidentally accepted visibility modifiers on
8267   enum variants, a bug [which has been fixed][1.5ev].
8268 * [A bug was fixed that allowed `use` statements to import unstable
8269   features][1.5use].
8270
8271 Language
8272 --------
8273
8274 * When evaluating expressions at compile-time that are not
8275   compile-time constants (const-evaluating expressions in non-const
8276   contexts), incorrect code such as overlong bitshifts and arithmetic
8277   overflow will [generate a warning instead of an error][1.5ce],
8278   delaying the error until runtime. This will allow the
8279   const-evaluator to be expanded in the future backwards-compatibly.
8280 * The `improper_ctypes` lint [no longer warns about using `isize` and
8281   `usize` in FFI][1.5ict].
8282
8283 Libraries
8284 ---------
8285
8286 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8287   invariant][1.5c].
8288 * `Default` is [implemented for mutable slices][1.5d].
8289 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8290 * There are now `From` conversions [between floating point
8291   types][1.5f] where the conversions are lossless.
8292 * There are now `From` conversions [between integer types][1.5i] where
8293   the conversions are lossless.
8294 * [`fs::Metadata` implements `Clone`][1.5fs].
8295 * The `parse` method [accepts a leading "+" when parsing
8296   integers][1.5pi].
8297 * [`AsMut` is implemented for `Vec`][1.5am].
8298 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8299   been optimized][1.5cf] and no longer rely on the default impl.
8300 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8301   `unsafe extern "C"` function types now [implement `Clone`,
8302   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8303   `fmt::Debug` for up to 12 arguments][1.5fp].
8304 * [Dropping `Vec`s is much faster in unoptimized builds when the
8305   element types don't implement `Drop`][1.5dv].
8306 * A bug that caused in incorrect behavior when [combining `VecDeque`
8307   with zero-sized types][1.5vdz] was resolved.
8308 * [`PartialOrd` for slices is faster][1.5po].
8309
8310 Miscellaneous
8311 -------------
8312
8313 * [Crate metadata size was reduced by 20%][1.5md].
8314 * [Improvements to code generation reduced the size of libcore by 3.3
8315   MB and rustc's memory usage by 18MB][1.5m].
8316 * [Improvements to deref translation increased performance in
8317   unoptimized builds][1.5dr].
8318 * Various errors in trait resolution [are deduplicated to only be
8319   reported once][1.5te].
8320 * Rust has preliminary [support for rumprun kernels][1.5rr].
8321 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8322
8323 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8324 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8325 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8326 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8327 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8328 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8329 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8330 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8331 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8332 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8333 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8334 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8335 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8336 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8337 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8338 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8339 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8340 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8341 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8342 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8343 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8344 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8345 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8346 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8347 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8348 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8349 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8350 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8351 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8352 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8353 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8354 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8355 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8356 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8357 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8358 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8359 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8360 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8361 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8362 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8363 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8364 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8365 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8366 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8367 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8368 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8369 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8370 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8371 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8372 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8373 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8374 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8375 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8376 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8377 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8378 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8379 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8380 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8381 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8382 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8383 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8384 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8385 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8386 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8387 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8388 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8389 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8390 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8391 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8392 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8393 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8394 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8395 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8396 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8397 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8398 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8399 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8400 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8401 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8402 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8403 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8404 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8405 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8406 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8407 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8408 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8409 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8410 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8411 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8412
8413 Version 1.4.0 (2015-10-29)
8414 ==========================
8415
8416 * ~1200 changes, numerous bugfixes
8417
8418 Highlights
8419 ----------
8420
8421 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8422   GNU) are now supported and recommended for use.
8423
8424 Breaking Changes
8425 ----------------
8426
8427 * [Several changes have been made to fix type soundness and improve
8428   the behavior of associated types][sound]. See [RFC 1214]. Although
8429   we have mostly introduced these changes as warnings this release, to
8430   become errors next release, there are still some scenarios that will
8431   see immediate breakage.
8432 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8433   line breaks in addition to `\n`][crlf].
8434 * [Loans of `'static` lifetime extend to the end of a function][stat].
8435 * [`str::parse` no longer introduces avoidable rounding error when
8436   parsing floating point numbers. Together with earlier changes to
8437   float formatting/output, "round trips" like f.to_string().parse()
8438   now preserve the value of f exactly. Additionally, leading plus
8439   signs are now accepted][fp3].
8440
8441
8442 Language
8443 --------
8444
8445 * `use` statements that import multiple items [can now rename
8446   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8447 * [Binops work correctly on fat pointers][binfat].
8448 * `pub extern crate`, which does not behave as expected, [issues a
8449   warning][pec] until a better solution is found.
8450
8451 Libraries
8452 ---------
8453
8454 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8455   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8456   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8457   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8458   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8459   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8460   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8461   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8462   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8463   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8464   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8465   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8466   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8467   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8468   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8469   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8470   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8471   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8472   [`thread::sleep`].
8473 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8474   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8475   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8476   `f64::from_str_radix`.
8477 * [Reverse-searching strings is faster with the 'two-way'
8478   algorithm][s].
8479 * [`std::io::copy` allows `?Sized` arguments][cc].
8480 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8481   [override `count`, `nth` and `last` with an *O*(1)
8482   implementation][it].
8483 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8484 * [`IntoRawFd` has been added to the Unix-specific prelude,
8485   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8486   prelude][pr].
8487 * [`Extend<String>` and `FromIterator<String` are both implemented for
8488   `String`][es].
8489 * [`IntoIterator` is implemented for references to `Option` and
8490   `Result`][into2].
8491 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8492   Copy`][ext] as part of [RFC 839]. This will cause type inference
8493   breakage in rare situations.
8494 * [`BinaryHeap` implements `Debug`][bh2].
8495 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8496   arrays][bm].
8497 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8498   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8499 * [String comparison is faster][faststr].
8500 * `&mut T` where `T: std::fmt::Write` [also implements
8501   `std::fmt::Write`][mutw].
8502 * [A stable regression in `VecDeque::push_back` and other
8503   capacity-altering methods that caused panics for zero-sized types
8504   was fixed][vd].
8505 * [Function pointers implement traits for up to 12 parameters][fp2].
8506
8507 Miscellaneous
8508 -------------
8509
8510 * The compiler [no longer uses the 'morestack' feature to prevent
8511   stack overflow][mm]. Instead it uses guard pages and stack
8512   probes (though stack probes are not yet implemented on any platform
8513   but Windows).
8514 * [The compiler matches traits faster when projections are involved][p].
8515 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8516   `usize`][ffi].
8517 * [Cargo now displays useful information about what its doing during
8518   `cargo update`][cu].
8519
8520 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8521 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8522 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8523 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8524 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8525 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8526 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8527 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8528 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8529 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8530 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8531 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8532 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8533 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8534 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8535 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8536 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8537 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8538 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8539 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8540 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8541 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8542 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8543 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8544 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8545 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8546 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8547 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8548 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8549 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8550 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8551 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8552 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8553 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8554 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8555 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8556 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8557 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8558 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8559 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8560 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8561 [bh2]: https://github.com/rust-lang/rust/pull/28156
8562 [binfat]: https://github.com/rust-lang/rust/pull/28270
8563 [bm]: https://github.com/rust-lang/rust/pull/28197
8564 [cc]: https://github.com/rust-lang/rust/pull/27531
8565 [crlf]: https://github.com/rust-lang/rust/pull/28034
8566 [cu]: https://github.com/rust-lang/cargo/pull/1931
8567 [d]: https://github.com/rust-lang/rust/pull/27825
8568 [dep]: https://github.com/rust-lang/rust/pull/28339
8569 [es]: https://github.com/rust-lang/rust/pull/27956
8570 [ext]: https://github.com/rust-lang/rust/pull/28094
8571 [faststr]: https://github.com/rust-lang/rust/pull/28338
8572 [ffi]: https://github.com/rust-lang/rust/pull/28779
8573 [fp]: https://github.com/rust-lang/rust/pull/28268
8574 [fp2]: https://github.com/rust-lang/rust/pull/28560
8575 [fp3]: https://github.com/rust-lang/rust/pull/27307
8576 [i]: https://github.com/rust-lang/rust/pull/27451
8577 [into2]: https://github.com/rust-lang/rust/pull/28039
8578 [it]: https://github.com/rust-lang/rust/pull/27652
8579 [mm]: https://github.com/rust-lang/rust/pull/27338
8580 [mutw]: https://github.com/rust-lang/rust/pull/28368
8581 [sound]: https://github.com/rust-lang/rust/pull/27641
8582 [p]: https://github.com/rust-lang/rust/pull/27866
8583 [pec]: https://github.com/rust-lang/rust/pull/28486
8584 [pr]: https://github.com/rust-lang/rust/pull/27896
8585 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8586 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8587 [s]: https://github.com/rust-lang/rust/pull/27474
8588 [stab]: https://github.com/rust-lang/rust/pull/28339
8589 [stat]: https://github.com/rust-lang/rust/pull/28321
8590 [vd]: https://github.com/rust-lang/rust/pull/28494
8591
8592 Version 1.3.0 (2015-09-17)
8593 ==============================
8594
8595 * ~900 changes, numerous bugfixes
8596
8597 Highlights
8598 ----------
8599
8600 * The [new object lifetime defaults][nold] have been [turned
8601   on][nold2] after a cycle of warnings about the change. Now types
8602   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8603   being interpreted as `&'a Box<Trait+'a>` to `&'a
8604   Box<Trait+'static>`.
8605 * [The Rustonomicon][nom] is a new book in the official documentation
8606   that dives into writing unsafe Rust.
8607 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8608   timekeeping is employed by other std APIs, as well as out-of-tree
8609   time crates.
8610
8611 Breaking Changes
8612 ----------------
8613
8614 * The [new object lifetime defaults][nold] have been [turned
8615   on][nold2] after a cycle of warnings about the change.
8616 * There is a known [regression][lr] in how object lifetime elision is
8617   interpreted, the proper solution for which is undetermined.
8618 * The `#[prelude_import]` attribute, an internal implementation
8619   detail, was accidentally stabilized previously. [It has been put
8620   behind the `prelude_import` feature gate][pi]. This change is
8621   believed to break no existing code.
8622 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8623   [more sane for dynamically sized types][dst3]. Code that relied on
8624   the previous behavior is thought to be broken.
8625 * The `dropck` rules, which checks that destructors can't access
8626   destroyed values, [have been updated][dropck] to match the
8627   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8628   cause some previously-compiling code to no longer build.
8629
8630 Language
8631 --------
8632
8633 * The [new object lifetime defaults][nold] have been [turned
8634   on][nold2] after a cycle of warnings about the change.
8635 * Semicolons may [now follow types and paths in
8636   macros](https://github.com/rust-lang/rust/pull/27000).
8637 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8638   [more sane for dynamically sized types][dst3]. Code that relied on
8639   the previous behavior is not known to exist, and suspected to be
8640   broken.
8641 * `'static` variables [may now be recursive][st].
8642 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8643   implementations correctly.
8644 * The `dropck` rules, which checks that destructors can't access
8645   destroyed values, [have been updated][dropck] to match the
8646   [RFC][dropckrfc].
8647
8648 Libraries
8649 ---------
8650
8651 * The [`Duration`] API, [has been stabilized][ds], as well as the
8652   `std::time` module, which presently contains only `Duration`.
8653 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8654 * The owned C string, [`CString`], implements [`Borrow`] and the
8655   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8656   these allow C strings to be borrowed and cloned in generic code.
8657 * [`CStr`] implements [`Debug`].
8658 * [`AtomicPtr`] implements [`Debug`].
8659 * [`Error`] trait objects [can be downcast to their concrete types][e]
8660   in many common configurations, using the [`is`], [`downcast`],
8661   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8662   [`Any`] trait.
8663 * Searching for substrings now [employs the two-way algorithm][search]
8664   instead of doing a naive search. This gives major speedups to a
8665   number of methods, including [`contains`][sc], [`find`][sf],
8666   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8667   [`ends_with`][sew] are also faster.
8668 * The performance of `PartialEq` for slices is [much faster][ps].
8669 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8670   is overridden and optimized by the implementations for scalars.
8671 * The [`Hasher`] trait now has a number of specialized `write_*`
8672   methods for primitive types, for efficiency.
8673 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8674   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8675   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8676   of [`std::error::Error::cause`][iec] also delegates to the inner
8677   error.
8678 * [`process::Child`][pc] gained the [`id`] method, which returns a
8679   `u32` representing the platform-specific process identifier.
8680 * The [`connect`] method on slices is deprecated, replaced by the new
8681   [`join`] method (note that both of these are on the *unstable*
8682   [`SliceConcatExt`] trait, but through the magic of the prelude are
8683   available to stable code anyway).
8684 * The [`Div`] operator is implemented for [`Wrapping`] types.
8685 * [`DerefMut` is implemented for `String`][dms].
8686 * Performance of SipHash (the default hasher for `HashMap`) is
8687   [better for long data][sh].
8688 * [`AtomicPtr`] implements [`Send`].
8689 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8690   are now [specialized to use uninitialized buffers for increased
8691   performance][rte].
8692 * Lifetime parameters of foreign functions [are now resolved
8693   properly][f].
8694
8695 Misc
8696 ----
8697
8698 * Rust can now, with some coercion, [produce programs that run on
8699   Windows XP][xp], though XP is not considered a supported platform.
8700 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8701   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8702   recommended for use in 1.3, though should be fully-functional
8703   in the [64-bit 1.4 beta][b14].
8704 * On Fedora-based systems installation will [properly configure the
8705   dynamic linker][fl].
8706 * The compiler gained many new extended error descriptions, which can
8707   be accessed with the `--explain` flag.
8708 * The `dropck` pass, which checks that destructors can't access
8709   destroyed values, [has been rewritten][dropck]. This fixes some
8710   soundness holes, and as such will cause some previously-compiling
8711   code to no longer build.
8712 * `rustc` now uses [LLVM to write archive files where possible][ar].
8713   Eventually this will eliminate the compiler's dependency on the ar
8714   utility.
8715 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8716   supported FreeBSD on x86_64).
8717 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8718   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8719   more strict.
8720 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8721   will kill the process instead of leaking][nlp].
8722
8723 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8724 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8725 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8726 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8727 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8728 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8729 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8730 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8731 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8732 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8733 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8734 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8735 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8736 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8737 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8738 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8739 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8740 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8741 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8742 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8743 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8744 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8745 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8746 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8747 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8748 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8749 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8750 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8751 [ar]: https://github.com/rust-lang/rust/pull/26926
8752 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8753 [dms]: https://github.com/rust-lang/rust/pull/26241
8754 [dropck]: https://github.com/rust-lang/rust/pull/27261
8755 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8756 [ds]: https://github.com/rust-lang/rust/pull/26818
8757 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8758 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8759 [dst3]: https://github.com/rust-lang/rust/pull/27351
8760 [e]: https://github.com/rust-lang/rust/pull/24793
8761 [f]: https://github.com/rust-lang/rust/pull/26588
8762 [fb]: https://github.com/rust-lang/rust/pull/26959
8763 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8764 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8765 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8766 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8767 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8768 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8769 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8770 [lic]: https://github.com/rust-lang/rust/pull/26583
8771 [lnu]: https://github.com/rust-lang/rust/pull/27026
8772 [lr]: https://github.com/rust-lang/rust/issues/27248
8773 [lum]: https://github.com/rust-lang/rust/pull/26378
8774 [lur]: https://github.com/rust-lang/rust/pull/26783
8775 [nlp]: https://github.com/rust-lang/rust/pull/27176
8776 [nold2]: https://github.com/rust-lang/rust/pull/27045
8777 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8778 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8779 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8780 [pi]: https://github.com/rust-lang/rust/pull/26699
8781 [ps]: https://github.com/rust-lang/rust/pull/26884
8782 [rte]: https://github.com/rust-lang/rust/pull/26950
8783 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8784 [search]: https://github.com/rust-lang/rust/pull/26327
8785 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8786 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8787 [sh]: https://github.com/rust-lang/rust/pull/27280
8788 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8789 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8790 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8791 [st]: https://github.com/rust-lang/rust/pull/26630
8792 [win1]: https://github.com/rust-lang/rust/pull/26569
8793 [win2]: https://github.com/rust-lang/rust/pull/26741
8794 [win3]: https://github.com/rust-lang/rust/pull/26741
8795 [win4]: https://github.com/rust-lang/rust/pull/27210
8796 [xp]: https://github.com/rust-lang/rust/pull/26569
8797
8798 Version 1.2.0 (2015-08-07)
8799 ==========================
8800
8801 * ~1200 changes, numerous bugfixes
8802
8803 Highlights
8804 ----------
8805
8806 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8807   like `Rc` to contain types without a fixed size, arrays and trait
8808   objects, finally enabling use of `Rc<[T]>` and completing the
8809   implementation of DST.
8810 * [Parallel codegen][parcodegen] is now working again, which can
8811   substantially speed up large builds in debug mode; It also gets
8812   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8813   jobs). It's not enabled by default, but will be "in the near
8814   future". It can be activated with the `-C codegen-units=N` flag to
8815   `rustc`.
8816 * This is the first release with [experimental support for linking
8817   with the MSVC linker and lib C on Windows (instead of using the GNU
8818   variants via MinGW)][win]. It is yet recommended only for the most
8819   intrepid Rustaceans.
8820 * Benchmark compilations are showing a 30% improvement in
8821   bootstrapping over 1.1.
8822
8823 Breaking Changes
8824 ----------------
8825
8826 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8827   unicode case mapping, which is a previously-planned change in
8828   behavior and considered a bugfix.
8829 * [`mem::align_of`] now specifies [the *minimum alignment* for
8830   T][align], which is usually the alignment programs are interested
8831   in, and the same value reported by clang's
8832   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8833   break real code.
8834 * [The `#[packed]` attribute is no longer silently accepted by the
8835   compiler][packed]. This attribute did nothing and code that
8836   mentioned it likely did not work as intended.
8837 * Associated type defaults are [now behind the
8838   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8839   defaults *did not work*, but could be mentioned syntactically. As
8840   such this breakage has minimal impact.
8841
8842 Language
8843 --------
8844
8845 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8846   matching against dereferenceable values.
8847
8848 Libraries
8849 ---------
8850
8851 * The [`Extend`] trait, which grows a collection from an iterator, is
8852   implemented over iterators of references, for `String`, `Vec`,
8853   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8854   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8855 * The [`iter::once`] function returns an iterator that yields a single
8856   element, and [`iter::empty`] returns an iterator that yields no
8857   elements.
8858 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8859   over substring matches.
8860 * [`Cell`] and [`RefCell`] both implement `Eq`.
8861 * A number of methods for wrapping arithmetic are added to the
8862   integral types, [`wrapping_div`], [`wrapping_rem`],
8863   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8864   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8865   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8866   type.. It is illegal for the default arithmetic operations in Rust
8867   to overflow; the desire to wrap must be explicit.
8868 * The `{:#?}` formatting specifier [displays the alternate,
8869   pretty-printed][debugfmt] form of the `Debug` formatter. This
8870   feature was actually introduced prior to 1.0 with little
8871   fanfare.
8872 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8873   for writing data to formatted strings, similar to [`io::Write`].
8874 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8875   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8876   are used by code generators to emit implementations of [`Debug`].
8877 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8878   methods that convert case, following Unicode case mapping.
8879 * It is now easier to handle poisoned locks. The [`PoisonError`]
8880   type, returned by failing lock operations, exposes `into_inner`,
8881   `get_ref`, and `get_mut`, which all give access to the inner lock
8882   guard, and allow the poisoned lock to continue to operate. The
8883   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8884   poisoned lock without attempting to take the lock.
8885 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8886   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8887   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8888   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8889   `ChildStderr`.
8890 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8891   malformed input.
8892
8893 Misc
8894 ----
8895
8896 * `rustc` employs smarter heuristics for guessing at [typos].
8897 * `rustc` emits more efficient code for [no-op conversions between
8898   unsafe pointers][nop].
8899 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8900   resulting in faster compile times and smaller code.
8901
8902 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8903 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8904 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8905 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8906 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8907 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8908 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8909 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8910 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8911 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8912 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8913 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8914 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8915 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8916 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8917 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8918 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8919 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8920 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8921 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8922 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8923 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8924 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8925 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8926 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8927 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8928 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8929 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8930 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8931 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8932 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8933 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8934 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8935 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8936 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8937 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8938 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8939 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8940 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8941 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8942 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8943 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8944 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8945 [align]: https://github.com/rust-lang/rust/pull/25646
8946 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8947 [typos]: https://github.com/rust-lang/rust/pull/26087
8948 [nop]: https://github.com/rust-lang/rust/pull/26336
8949 [fat]: https://github.com/rust-lang/rust/pull/26411
8950 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8951 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8952 [packed]: https://github.com/rust-lang/rust/pull/25541
8953 [ad]: https://github.com/rust-lang/rust/pull/27382
8954 [win]: https://github.com/rust-lang/rust/pull/25350
8955
8956 Version 1.1.0 (2015-06-25)
8957 =========================
8958
8959 * ~850 changes, numerous bugfixes
8960
8961 Highlights
8962 ----------
8963
8964 * The [`std::fs` module has been expanded][fs] to expand the set of
8965   functionality exposed:
8966   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8967     don't incur a syscall on some platforms.
8968   * A `symlink_metadata` function has been added.
8969   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8970     access to all underlying information.
8971 * The compiler now contains extended explanations of many errors. When an error
8972   with an explanation occurs the compiler suggests using the `--explain` flag
8973   to read the explanation. Error explanations are also [available online][err-index].
8974 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8975   well as other work, the time to bootstrap the compiler decreased by
8976   32%.
8977
8978 Libraries
8979 ---------
8980
8981 * The [`str::split_whitespace`] method splits a string on unicode
8982   whitespace boundaries.
8983 * On both Windows and Unix, new extension traits provide conversion of
8984   I/O types to and from the underlying system handles. On Unix, these
8985   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8986   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8987   `TcpListener`, and `UpdSocket`. Further implementations for
8988   `std::process` will be stabilized later.
8989 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8990   Windows, symlinks can be created with
8991   `std::os::windows::symlink_dir` and
8992   `std::os::windows::symlink_file`.
8993 * The `mpsc::Receiver` type can now be converted into an iterator with
8994   `into_iter` on the [`IntoIterator`] trait.
8995 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8996   implementation of the [`From`] trait.
8997 * The `Debug` implementation for `RangeFull` [creates output that is
8998   more consistent with other implementations][rf].
8999 * [`Debug` is implemented for `File`][file].
9000 * The `Default` implementation for `Arc` [no longer requires `Sync +
9001   Send`][arc].
9002 * [The `Iterator` methods `count`, `nth`, and `last` have been
9003   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9004 * Incorrect handling of paths on Windows has been improved in both the
9005   compiler and the standard library.
9006 * [`AtomicPtr` gained a `Default` implementation][ap].
9007 * In accordance with Rust's policy on arithmetic overflow `abs` now
9008   [panics on overflow when debug assertions are enabled][abs].
9009 * The [`Cloned`] iterator, which was accidentally left unstable for
9010   1.0 [has been stabilized][c].
9011 * The [`Incoming`] iterator, which iterates over incoming TCP
9012   connections, and which was accidentally unnamable in 1.0, [is now
9013   properly exported][inc].
9014 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9015   `sift_up` or `sift_down` panic][bh].
9016 * The [`split_off`] method of `LinkedList` [no longer corrupts
9017   the list in certain scenarios][ll].
9018
9019 Misc
9020 ----
9021
9022 * Type checking performance [has improved notably][sk] with
9023   [multiple improvements][pre].
9024 * The compiler [suggests code changes][ch] for more errors.
9025 * rustc and it's build system have experimental support for [building
9026   toolchains against MUSL][m] instead of glibc on Linux.
9027 * The compiler defines the `target_env` cfg value, which is used for
9028   distinguishing toolchains that are otherwise for the same
9029   platform. Presently this is set to `gnu` for common GNU Linux
9030   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9031 * The [`cargo rustc`][crc] command invokes a build with custom flags
9032   to rustc.
9033 * [Android executables are always position independent][pie].
9034 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9035   with `Drop`][drop].
9036
9037 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9038 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9039 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9040 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9041 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9042 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9043 [rf]: https://github.com/rust-lang/rust/pull/24491
9044 [err-index]: https://doc.rust-lang.org/error-index.html
9045 [sk]: https://github.com/rust-lang/rust/pull/24615
9046 [pre]: https://github.com/rust-lang/rust/pull/25323
9047 [file]: https://github.com/rust-lang/rust/pull/24598
9048 [ch]: https://github.com/rust-lang/rust/pull/24683
9049 [arc]: https://github.com/rust-lang/rust/pull/24695
9050 [si]: https://github.com/rust-lang/rust/pull/24701
9051 [ap]: https://github.com/rust-lang/rust/pull/24834
9052 [m]: https://github.com/rust-lang/rust/pull/24777
9053 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9054 [crc]: https://github.com/rust-lang/cargo/pull/1568
9055 [pie]: https://github.com/rust-lang/rust/pull/24953
9056 [abs]: https://github.com/rust-lang/rust/pull/25441
9057 [c]: https://github.com/rust-lang/rust/pull/25496
9058 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9059 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9060 [inc]: https://github.com/rust-lang/rust/pull/25522
9061 [bh]: https://github.com/rust-lang/rust/pull/25856
9062 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9063 [ll]: https://github.com/rust-lang/rust/pull/26022
9064 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9065 [drop]: https://github.com/rust-lang/rust/pull/24935
9066
9067 Version 1.0.0 (2015-05-15)
9068 ========================
9069
9070 * ~1500 changes, numerous bugfixes
9071
9072 Highlights
9073 ----------
9074
9075 * The vast majority of the standard library is now `#[stable]`. It is
9076   no longer possible to use unstable features with a stable build of
9077   the compiler.
9078 * Many popular crates on [crates.io] now work on the stable release
9079   channel.
9080 * Arithmetic on basic integer types now [checks for overflow in debug
9081   builds][overflow].
9082
9083 Language
9084 --------
9085
9086 * Several [restrictions have been added to trait coherence][coh] in
9087   order to make it easier for upstream authors to change traits
9088   without breaking downstream code.
9089 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9090   improve error messages and macro behavior. For example, `0b1234` is
9091   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9092 * Trait bounds [are always invariant][inv], eliminating the need for
9093   the `PhantomFn` and `MarkerTrait` lang items, which have been
9094   removed.
9095 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9096   "foo" as bar` syntax has been replaced with `extern crate foo as
9097   bar`, and Cargo now automatically translates "-" in *package* names
9098   to underscore for the crate name.
9099 * [Lifetime shadowing is an error][lt].
9100 * [`Send` no longer implies `'static`][send-rfc].
9101 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9102   `MyType::default()`.
9103 * Primitive types [now have inherent methods][prim-inherent],
9104   obviating the need for extension traits like `SliceExt`.
9105 * Methods with `Self: Sized` in their `where` clause are [considered
9106   object-safe][self-sized], allowing many extension traits like
9107   `IteratorExt` to be merged into the traits they extended.
9108 * You can now [refer to associated types][assoc-where] whose
9109   corresponding trait bounds appear only in a `where` clause.
9110 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9111   like `Send` and `Sync` are now library-defined.
9112 * A [Reflect trait][reflect] was introduced, which means that
9113   downcasting via the `Any` trait is effectively limited to concrete
9114   types. This helps retain the potentially-important "parametricity"
9115   property: generic code cannot behave differently for different type
9116   arguments except in minor ways.
9117 * The `unsafe_destructor` feature is now deprecated in favor of the
9118   [new `dropck`][dropck]. This change is a major reduction in unsafe
9119   code.
9120
9121 Libraries
9122 ---------
9123
9124 * The `thread_local` module [has been renamed to `std::thread`][th].
9125 * The methods of `IteratorExt` [have been moved to the `Iterator`
9126   trait itself][ie].
9127 * Several traits that implement Rust's conventions for type
9128   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9129   [centralized in the `std::convert` module][con].
9130 * The `FromError` trait [was removed in favor of `From`][fe].
9131 * The basic sleep function [has moved to
9132   `std::thread::sleep_ms`][slp].
9133 * The `splitn` function now takes an `n` parameter that represents the
9134   number of items yielded by the returned iterator [instead of the
9135   number of 'splits'][spl].
9136 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9137 * [Derived implementations of `PartialOrd` now order enums according
9138   to their explicitly-assigned discriminants][po].
9139 * [Methods for searching strings are generic over `Pattern`s][pat],
9140   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9141   some others.
9142 * [In method resolution, object methods are resolved before inherent
9143   methods][meth].
9144 * [`String::from_str` has been deprecated in favor of the `From` impl,
9145   `String::from`][sf].
9146 * [`io::Error` implements `Sync`][ios].
9147 * [The `words` method on `&str` has been replaced with
9148   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9149   a word?'
9150 * The new path and IO modules are complete and `#[stable]`. This
9151   was the major library focus for this cycle.
9152 * The path API was [revised][path-normalize] to normalize `.`,
9153   adjusting the tradeoffs in favor of the most common usage.
9154 * A large number of remaining APIs in `std` were also stabilized
9155   during this cycle; about 75% of the non-deprecated API surface
9156   is now stable.
9157 * The new [string pattern API][string-pattern] landed, which makes
9158   the string slice API much more internally consistent and flexible.
9159 * A new set of [generic conversion traits][conversion] replaced
9160   many existing ad hoc traits.
9161 * Generic numeric traits were [completely removed][num-traits]. This
9162   was made possible thanks to inherent methods for primitive types,
9163   and the removal gives maximal flexibility for designing a numeric
9164   hierarchy in the future.
9165 * The `Fn` traits are now related via [inheritance][fn-inherit]
9166   and provide ergonomic [blanket implementations][fn-blanket].
9167 * The `Index` and `IndexMut` traits were changed to
9168   [take the index by value][index-value], enabling code like
9169   `hash_map["string"]` to work.
9170 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9171   `Copy` data is known to be `Clone` as well.
9172
9173 Misc
9174 ----
9175
9176 * Many errors now have extended explanations that can be accessed with
9177   the `--explain` flag to `rustc`.
9178 * Many new examples have been added to the standard library
9179   documentation.
9180 * rustdoc has received a number of improvements focused on completion
9181   and polish.
9182 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9183 * Much headway was made on ecosystem-wide CI, making it possible
9184   to [compare builds for breakage][ci-compare].
9185
9186
9187 [crates.io]: http://crates.io
9188 [clo]: https://github.com/rust-lang/rust/pull/24034
9189 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9190 [con]: https://github.com/rust-lang/rust/pull/23875
9191 [cr]: https://github.com/rust-lang/rust/pull/23419
9192 [fe]: https://github.com/rust-lang/rust/pull/23879
9193 [ie]: https://github.com/rust-lang/rust/pull/23300
9194 [inv]: https://github.com/rust-lang/rust/pull/23938
9195 [ios]: https://github.com/rust-lang/rust/pull/24133
9196 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9197 [lt]: https://github.com/rust-lang/rust/pull/24057
9198 [meth]: https://github.com/rust-lang/rust/pull/24056
9199 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9200 [po]: https://github.com/rust-lang/rust/pull/24270
9201 [sf]: https://github.com/rust-lang/rust/pull/24517
9202 [slp]: https://github.com/rust-lang/rust/pull/23949
9203 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9204 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9205 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9206 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9207 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9208 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9209 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9210 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9211 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9212 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9213 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9214 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9215 [reflect]: https://github.com/rust-lang/rust/pull/23712
9216 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9217 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9218 [index-value]: https://github.com/rust-lang/rust/pull/23601
9219 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9220 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9221 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9222 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9223 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9224 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9225
9226
9227 Version 1.0.0-alpha.2 (2015-02-20)
9228 =====================================
9229
9230 * ~1300 changes, numerous bugfixes
9231
9232 * Highlights
9233
9234     * The various I/O modules were [overhauled][io-rfc] to reduce
9235       unnecessary abstractions and provide better interoperation with
9236       the underlying platform. The old `io` module remains temporarily
9237       at `std::old_io`.
9238     * The standard library now [participates in feature gating][feat],
9239       so use of unstable libraries now requires a `#![feature(...)]`
9240       attribute. The impact of this change is [described on the
9241       forum][feat-forum]. [RFC][feat-rfc].
9242
9243 * Language
9244
9245     * `for` loops [now operate on the `IntoIterator` trait][into],
9246       which eliminates the need to call `.iter()`, etc. to iterate
9247       over collections. There are some new subtleties to remember
9248       though regarding what sort of iterators various types yield, in
9249       particular that `for foo in bar { }` yields values from a move
9250       iterator, destroying the original collection. [RFC][into-rfc].
9251     * Objects now have [default lifetime bounds][obj], so you don't
9252       have to write `Box<Trait+'static>` when you don't care about
9253       storing references. [RFC][obj-rfc].
9254     * In types that implement `Drop`, [lifetimes must outlive the
9255       value][drop]. This will soon make it possible to safely
9256       implement `Drop` for types where `#[unsafe_destructor]` is now
9257       required. Read the [gorgeous RFC][drop-rfc] for details.
9258     * The fully qualified <T as Trait>::X syntax lets you set the Self
9259       type for a trait method or associated type. [RFC][ufcs-rfc].
9260     * References to types that implement `Deref<U>` now [automatically
9261       coerce to references][deref] to the dereferenced type `U`,
9262       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9263       should eliminate many unsightly uses of `&*`, as when converting
9264       from references to vectors into references to
9265       slices. [RFC][deref-rfc].
9266     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9267       `|:|`) is obsolete and closure kind is inferred from context.
9268     * [`Self` is a keyword][Self].
9269
9270 * Libraries
9271
9272     * The `Show` and `String` formatting traits [have been
9273       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9274       their related purposes. Automatically getting a string
9275       conversion to use with `format!("{:?}", something_to_debug)` is
9276       now written `#[derive(Debug)]`.
9277     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9278       OsStr}`, provide strings in platform-specific encodings for easier
9279       interop with system APIs. [RFC][osstr-rfc].
9280     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9281       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9282       creating raw pointers.
9283
9284 * Tooling
9285
9286     * Certain long error messages of the form 'expected foo found bar'
9287       are now [split neatly across multiple
9288       lines][multiline]. Examples in the PR.
9289     * On Unix Rust can be [uninstalled][un] by running
9290       `/usr/local/lib/rustlib/uninstall.sh`.
9291     * The `#[rustc_on_unimplemented]` attribute, requiring the
9292       'on_unimplemented' feature, lets rustc [display custom error
9293       messages when a trait is expected to be implemented for a type
9294       but is not][onun].
9295
9296 * Misc
9297
9298     * Rust is tested against a [LALR grammar][lalr], which parses
9299       almost all the Rust files that rustc does.
9300
9301 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9302 [close]: https://github.com/rust-lang/rust/pull/21843
9303 [deref]: https://github.com/rust-lang/rust/pull/21351
9304 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9305 [drop]: https://github.com/rust-lang/rust/pull/21972
9306 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9307 [feat]: https://github.com/rust-lang/rust/pull/21248
9308 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9309 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9310 [fmt]: https://github.com/rust-lang/rust/pull/21457
9311 [into]: https://github.com/rust-lang/rust/pull/20790
9312 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9313 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9314 [lalr]: https://github.com/rust-lang/rust/pull/21452
9315 [multiline]: https://github.com/rust-lang/rust/pull/19870
9316 [obj]: https://github.com/rust-lang/rust/pull/22230
9317 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9318 [onun]: https://github.com/rust-lang/rust/pull/20889
9319 [osstr]: https://github.com/rust-lang/rust/pull/21488
9320 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9321 [Self]: https://github.com/rust-lang/rust/pull/22158
9322 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9323 [un]: https://github.com/rust-lang/rust/pull/22256
9324
9325
9326 Version 1.0.0-alpha (2015-01-09)
9327 ==================================
9328
9329   * ~2400 changes, numerous bugfixes
9330
9331   * Highlights
9332
9333     * The language itself is considered feature complete for 1.0,
9334       though there will be many usability improvements and bugfixes
9335       before the final release.
9336     * Nearly 50% of the public API surface of the standard library has
9337       been declared 'stable'. Those interfaces are unlikely to change
9338       before 1.0.
9339     * The long-running debate over integer types has been
9340       [settled][ints]: Rust will ship with types named `isize` and
9341       `usize`, rather than `int` and `uint`, for pointer-sized
9342       integers. Guidelines will be rolled out during the alpha cycle.
9343     * Most crates that are not `std` have been moved out of the Rust
9344       distribution into the Cargo ecosystem so they can evolve
9345       separately and don't need to be stabilized as quickly, including
9346       'time', 'getopts', 'num', 'regex', and 'term'.
9347     * Documentation continues to be expanded with more API coverage, more
9348       examples, and more in-depth explanations. The guides have been
9349       consolidated into [The Rust Programming Language][trpl].
9350     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9351     * All official Rust binary installers now come with [Cargo], the
9352       Rust package manager.
9353
9354 * Language
9355
9356     * Closures have been [completely redesigned][unboxed] to be
9357       implemented in terms of traits, can now be used as generic type
9358       bounds and thus monomorphized and inlined, or via an opaque
9359       pointer (boxed) as in the old system. The new system is often
9360       referred to as 'unboxed' closures.
9361     * Traits now support [associated types][assoc], allowing families
9362       of related types to be defined together and used generically in
9363       powerful ways.
9364     * Enum variants are [namespaced by their type names][enum].
9365     * [`where` clauses][where] provide a more versatile and attractive
9366       syntax for specifying generic bounds, though the previous syntax
9367       remains valid.
9368     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9369       numeric types.
9370     * Rust [no longer has a runtime][rt] of any description, and only
9371       supports OS threads, not green threads.
9372     * At long last, Rust has been overhauled for 'dynamically-sized
9373       types' ([DST]), which integrates 'fat pointers' (object types,
9374       arrays, and `str`) more deeply into the type system, making it
9375       more consistent.
9376     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9377       `..j` that produce range types and which, when combined with the
9378       `Index` operator and multidispatch, leads to a convenient slice
9379       notation, `[i..j]`.
9380     * The new range syntax revealed an ambiguity in the fixed-length
9381       array syntax, so now fixed length arrays [are written `[T;
9382       N]`][arrays].
9383     * The `Copy` trait is no longer implemented automatically. Unsafe
9384       pointers no longer implement `Sync` and `Send` so types
9385       containing them don't automatically either. `Sync` and `Send`
9386       are now 'unsafe traits' so one can "forcibly" implement them via
9387       `unsafe impl` if a type confirms to the requirements for them
9388       even though the internals do not (e.g. structs containing unsafe
9389       pointers like `Arc`). These changes are intended to prevent some
9390       footguns and are collectively known as [opt-in built-in
9391       traits][oibit] (though `Sync` and `Send` will soon become pure
9392       library types unknown to the compiler).
9393     * Operator traits now take their operands [by value][ops], and
9394       comparison traits can use multidispatch to compare one type
9395       against multiple other types, allowing e.g. `String` to be
9396       compared with `&str`.
9397     * `if let` and `while let` are no longer feature-gated.
9398     * Rust has adopted a more [uniform syntax for escaping unicode
9399       characters][unicode].
9400     * `macro_rules!` [has been declared stable][mac]. Though it is a
9401       flawed system it is sufficiently popular that it must be usable
9402       for 1.0. Effort has gone into [future-proofing][mac-future] it
9403       in ways that will allow other macro systems to be developed in
9404       parallel, and won't otherwise impact the evolution of the
9405       language.
9406     * The prelude has been [pared back significantly][prelude] such
9407       that it is the minimum necessary to support the most pervasive
9408       code patterns, and through [generalized where clauses][where]
9409       many of the prelude extension traits have been consolidated.
9410     * Rust's rudimentary reflection [has been removed][refl], as it
9411       incurred too much code generation for little benefit.
9412     * [Struct variants][structvars] are no longer feature-gated.
9413     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9414       known as 'higher-ranked trait bounds', this crucially allows
9415       unboxed closures to work.
9416     * Macros invocations surrounded by parens or square brackets and
9417       not terminated by a semicolon are [parsed as
9418       expressions][macros], which makes expressions like `vec![1i32,
9419       2, 3].len()` work as expected.
9420     * Trait objects now implement their traits automatically, and
9421       traits that can be coerced to objects now must be [object
9422       safe][objsafe].
9423     * Automatically deriving traits is now done with `#[derive(...)]`
9424       not `#[deriving(...)]` for [consistency with other naming
9425       conventions][derive].
9426     * Importing the containing module or enum at the same time as
9427       items or variants they contain is [now done with `self` instead
9428       of `mod`][self], as in use `foo::{self, bar}`
9429     * Glob imports are no longer feature-gated.
9430     * The `box` operator and `box` patterns have been feature-gated
9431       pending a redesign. For now unique boxes should be allocated
9432       like other containers, with `Box::new`.
9433
9434 * Libraries
9435
9436     * A [series][coll1] of [efforts][coll2] to establish
9437       [conventions][coll3] for collections types has resulted in API
9438       improvements throughout the standard library.
9439     * New [APIs for error handling][err] provide ergonomic interop
9440       between error types, and [new conventions][err-conv] describe
9441       more clearly the recommended error handling strategies in Rust.
9442     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9443       it is easier to discuss failure in the context of error handling
9444       without making clarifications as to whether you are referring to
9445       the 'fail' macro or failure more generally.
9446     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9447       syscall when available.
9448     * The 'serialize' crate has been renamed 'rustc-serialize' and
9449       moved out of the distribution to Cargo. Although it is widely
9450       used now, it is expected to be superseded in the near future.
9451     * The `Show` formatter, typically implemented with
9452       `#[derive(Show)]` is [now requested with the `{:?}`
9453       specifier][show] and is intended for use by all types, for uses
9454       such as `println!` debugging. The new `String` formatter must be
9455       implemented by hand, uses the `{}` specifier, and is intended
9456       for full-fidelity conversions of things that can logically be
9457       represented as strings.
9458
9459 * Tooling
9460
9461     * [Flexible target specification][flex] allows rustc's code
9462       generation to be configured to support otherwise-unsupported
9463       platforms.
9464     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9465       respective debuggers with Rust-appropriate pretty-printing.
9466     * The Windows installation of Rust is distributed with the
9467       MinGW components currently required to link binaries on that
9468       platform.
9469
9470 * Misc
9471
9472     * Nullable enum optimizations have been extended to more types so
9473       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9474       space than the inner types themselves.
9475     * Work has begun on supporting AArch64.
9476
9477 [Cargo]: https://crates.io
9478 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9479 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9480 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9481 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9482 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9483 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9484 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9485 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9486 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9487 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9488 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9489 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9490 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9491 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9492 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9493 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9494 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9495 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9496 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9497 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9498 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9499 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9500 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9501 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9502 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9503 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9504 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9505 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9506 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9507 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9508 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9509 [trpl]: https://doc.rust-lang.org/book/index.html
9510 [rbe]: http://rustbyexample.com/
9511
9512
9513 Version 0.12.0 (2014-10-09)
9514 =============================
9515
9516   * ~1900 changes, numerous bugfixes
9517
9518   * Highlights
9519
9520     * The introductory documentation (now called The Rust Guide) has
9521       been completely rewritten, as have a number of supplementary
9522       guides.
9523     * Rust's package manager, Cargo, continues to improve and is
9524       sometimes considered to be quite awesome.
9525     * Many API's in `std` have been reviewed and updated for
9526       consistency with the in-development Rust coding
9527       guidelines. The standard library documentation tracks
9528       stabilization progress.
9529     * Minor libraries have been moved out-of-tree to the rust-lang org
9530       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9531       be installed with Cargo.
9532     * Lifetime elision allows lifetime annotations to be left off of
9533       function declarations in many common scenarios.
9534     * Rust now works on 64-bit Windows.
9535
9536   * Language
9537     * Indexing can be overloaded with the `Index` and `IndexMut`
9538       traits.
9539     * The `if let` construct takes a branch only if the `let` pattern
9540       matches, currently behind the 'if_let' feature gate.
9541     * 'where clauses', a more flexible syntax for specifying trait
9542       bounds that is more aesthetic, have been added for traits and
9543       free functions. Where clauses will in the future make it
9544       possible to constrain associated types, which would be
9545       impossible with the existing syntax.
9546     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9547       the 'slicing_syntax' feature gate, and can be overloaded with
9548       the `Slice` or `SliceMut` traits.
9549     * The syntax for matching of sub-slices has been changed to use a
9550       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9551       consistency with other uses of `..` and to future-proof
9552       potential additional uses of the syntax.
9553     * The syntax for matching inclusive ranges in patterns has changed
9554       from `0..3` to `0...4` to be consistent with the exclusive range
9555       syntax for slicing.
9556     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9557       c]`) has been put behind the 'advanced_slice_patterns' feature
9558       gate and may be removed in the future.
9559     * Components of tuples and tuple structs can be extracted using
9560       the `value.0` syntax, currently behind the `tuple_indexing`
9561       feature gate.
9562     * The `#[crate_id]` attribute is no longer supported; versioning
9563       is handled by the package manager.
9564     * Renaming crate imports are now written `extern crate foo as bar`
9565       instead of `extern crate bar = foo`.
9566     * Renaming use statements are now written `use foo as bar` instead
9567       of `use bar = foo`.
9568     * `let` and `match` bindings and argument names in macros are now
9569       hygienic.
9570     * The new, more efficient, closure types ('unboxed closures') have
9571       been added under a feature gate, 'unboxed_closures'. These will
9572       soon replace the existing closure types, once higher-ranked
9573       trait lifetimes are added to the language.
9574     * `move` has been added as a keyword, for indicating closures
9575       that capture by value.
9576     * Mutation and assignment is no longer allowed in pattern guards.
9577     * Generic structs and enums can now have trait bounds.
9578     * The `Share` trait is now called `Sync` to free up the term
9579       'shared' to refer to 'shared reference' (the default reference
9580       type.
9581     * Dynamically-sized types have been mostly implemented,
9582       unifying the behavior of fat-pointer types with the rest of the
9583       type system.
9584     * As part of dynamically-sized types, the `Sized` trait has been
9585       introduced, which qualifying types implement by default, and
9586       which type parameters expect by default. To specify that a type
9587       parameter does not need to be sized, write `<Sized? T>`. Most
9588       types are `Sized`, notable exceptions being unsized arrays
9589       (`[T]`) and trait types.
9590     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9591     * Lifetime bounds can now be applied to type parameters and object
9592       types.
9593     * The old, reference counted GC type, `Gc<T>` which was once
9594       denoted by the `@` sigil, has finally been removed. GC will be
9595       revisited in the future.
9596
9597   * Libraries
9598     * Library documentation has been improved for a number of modules.
9599     * Bit-vectors, collections::bitv has been modernized.
9600     * The url crate is deprecated in favor of
9601       http://github.com/servo/rust-url, which can be installed with
9602       Cargo.
9603     * Most I/O stream types can be cloned and subsequently closed from
9604       a different thread.
9605     * A `std::time::Duration` type has been added for use in I/O
9606       methods that rely on timers, as well as in the 'time' crate's
9607       `Timespec` arithmetic.
9608     * The runtime I/O abstraction layer that enabled the green thread
9609       scheduler to do non-thread-blocking I/O has been removed, along
9610       with the libuv-based implementation employed by the green thread
9611       scheduler. This will greatly simplify the future I/O work.
9612     * `collections::btree` has been rewritten to have a more
9613       idiomatic and efficient design.
9614
9615   * Tooling
9616     * rustdoc output now indicates the stability levels of API's.
9617     * The `--crate-name` flag can specify the name of the crate
9618       being compiled, like `#[crate_name]`.
9619     * The `-C metadata` specifies additional metadata to hash into
9620       symbol names, and `-C extra-filename` specifies additional
9621       information to put into the output filename, for use by the
9622       package manager for versioning.
9623     * debug info generation has continued to improve and should be
9624       more reliable under both gdb and lldb.
9625     * rustc has experimental support for compiling in parallel
9626       using the `-C codegen-units` flag.
9627     * rustc no longer encodes rpath information into binaries by
9628       default.
9629
9630   * Misc
9631     * Stack usage has been optimized with LLVM lifetime annotations.
9632     * Official Rust binaries on Linux are more compatible with older
9633       kernels and distributions, built on CentOS 5.10.
9634
9635
9636 Version 0.11.0 (2014-07-02)
9637 ==========================
9638
9639   * ~1700 changes, numerous bugfixes
9640
9641   * Language
9642     * ~[T] has been removed from the language. This type is superseded by
9643       the Vec<T> type.
9644     * ~str has been removed from the language. This type is superseded by
9645       the String type.
9646     * ~T has been removed from the language. This type is superseded by the
9647       Box<T> type.
9648     * @T has been removed from the language. This type is superseded by the
9649       standard library's std::gc::Gc<T> type.
9650     * Struct fields are now all private by default.
9651     * Vector indices and shift amounts are both required to be a `uint`
9652       instead of any integral type.
9653     * Byte character, byte string, and raw byte string literals are now all
9654       supported by prefixing the normal literal with a `b`.
9655     * Multiple ABIs are no longer allowed in an ABI string
9656     * The syntax for lifetimes on closures/procedures has been tweaked
9657       slightly: `<'a>|A, B|: 'b + K -> T`
9658     * Floating point modulus has been removed from the language; however it
9659       is still provided by a library implementation.
9660     * Private enum variants are now disallowed.
9661     * The `priv` keyword has been removed from the language.
9662     * A closure can no longer be invoked through a &-pointer.
9663     * The `use foo, bar, baz;` syntax has been removed from the language.
9664     * The transmute intrinsic no longer works on type parameters.
9665     * Statics now allow blocks/items in their definition.
9666     * Trait bounds are separated from objects with + instead of : now.
9667     * Objects can no longer be read while they are mutably borrowed.
9668     * The address of a static is now marked as insignificant unless the
9669       #[inline(never)] attribute is placed it.
9670     * The #[unsafe_destructor] attribute is now behind a feature gate.
9671     * Struct literals are no longer allowed in ambiguous positions such as
9672       if, while, match, and for..in.
9673     * Declaration of lang items and intrinsics are now feature-gated by
9674       default.
9675     * Integral literals no longer default to `int`, and floating point
9676       literals no longer default to `f64`. Literals must be suffixed with an
9677       appropriate type if inference cannot determine the type of the
9678       literal.
9679     * The Box<T> type is no longer implicitly borrowed to &mut T.
9680     * Procedures are now required to not capture borrowed references.
9681
9682   * Libraries
9683     * The standard library is now a "facade" over a number of underlying
9684       libraries. This means that development on the standard library should
9685       be speedier due to smaller crates, as well as a clearer line between
9686       all dependencies.
9687     * A new library, libcore, lives under the standard library's facade
9688       which is Rust's "0-assumption" library, suitable for embedded and
9689       kernel development for example.
9690     * A regex crate has been added to the standard distribution. This crate
9691       includes statically compiled regular expressions.
9692     * The unwrap/unwrap_err methods on Result require a Show bound for
9693       better error messages.
9694     * The return types of the std::comm primitives have been centralized
9695       around the Result type.
9696     * A number of I/O primitives have gained the ability to time out their
9697       operations.
9698     * A number of I/O primitives have gained the ability to close their
9699       reading/writing halves to cancel pending operations.
9700     * Reverse iterator methods have been removed in favor of `rev()` on
9701       their forward-iteration counterparts.
9702     * A bitflags! macro has been added to enable easy interop with C and
9703       management of bit flags.
9704     * A debug_assert! macro is now provided which is disabled when
9705       `--cfg ndebug` is passed to the compiler.
9706     * A graphviz crate has been added for creating .dot files.
9707     * The std::cast module has been migrated into std::mem.
9708     * The std::local_data api has been migrated from freestanding functions
9709       to being based on methods.
9710     * The Pod trait has been renamed to Copy.
9711     * jemalloc has been added as the default allocator for types.
9712     * The API for allocating memory has been changed to use proper alignment
9713       and sized deallocation
9714     * Connecting a TcpStream or binding a TcpListener is now based on a
9715       string address and a u16 port. This allows connecting to a hostname as
9716       opposed to an IP.
9717     * The Reader trait now contains a core method, read_at_least(), which
9718       correctly handles many repeated 0-length reads.
9719     * The process-spawning API is now centered around a builder-style
9720       Command struct.
9721     * The :? printing qualifier has been moved from the standard library to
9722       an external libdebug crate.
9723     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9724       have been renamed to Eq/Ord.
9725     * The select/plural methods have been removed from format!. The escapes
9726       for { and } have also changed from \{ and \} to {{ and }},
9727       respectively.
9728     * The TaskBuilder API has been re-worked to be a true builder, and
9729       extension traits for spawning native/green tasks have been added.
9730
9731   * Tooling
9732     * All breaking changes to the language or libraries now have their
9733       commit message annotated with `[breaking-change]` to allow for easy
9734       discovery of breaking changes.
9735     * The compiler will now try to suggest how to annotate lifetimes if a
9736       lifetime-related error occurs.
9737     * Debug info continues to be improved greatly with general bug fixes and
9738       better support for situations like link time optimization (LTO).
9739     * Usage of syntax extensions when cross-compiling has been fixed.
9740     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9741       -fdata-sections and --gc-sections has been enabled by default
9742     * The compiler is now stricter about where it will load module files
9743       from when a module is declared via `mod foo;`.
9744     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9745       Syntax extensions are now discovered via a "plugin registrar" type
9746       which will be extended in the future to other various plugins.
9747     * Lints have been restructured to allow for dynamically loadable lints.
9748     * A number of rustdoc improvements:
9749       * The HTML output has been visually redesigned.
9750       * Markdown is now powered by hoedown instead of sundown.
9751       * Searching heuristics have been greatly improved.
9752       * The search index has been reduced in size by a great amount.
9753       * Cross-crate documentation via `pub use` has been greatly improved.
9754       * Primitive types are now hyperlinked and documented.
9755     * Documentation has been moved from static.rust-lang.org/doc to
9756       doc.rust-lang.org
9757     * A new sandbox, play.rust-lang.org, is available for running and
9758       sharing rust code examples on-line.
9759     * Unused attributes are now more robustly warned about.
9760     * The dead_code lint now warns about unused struct fields.
9761     * Cross-compiling to iOS is now supported.
9762     * Cross-compiling to mipsel is now supported.
9763     * Stability attributes are now inherited by default and no longer apply
9764       to intra-crate usage, only inter-crate usage.
9765     * Error message related to non-exhaustive match expressions have been
9766       greatly improved.
9767
9768
9769 Version 0.10 (2014-04-03)
9770 =========================
9771
9772   * ~1500 changes, numerous bugfixes
9773
9774   * Language
9775     * A new RFC process is now in place for modifying the language.
9776     * Patterns with `@`-pointers have been removed from the language.
9777     * Patterns with unique vectors (`~[T]`) have been removed from the
9778       language.
9779     * Patterns with unique strings (`~str`) have been removed from the
9780       language.
9781     * `@str` has been removed from the language.
9782     * `@[T]` has been removed from the language.
9783     * `@self` has been removed from the language.
9784     * `@Trait` has been removed from the language.
9785     * Headers on `~` allocations which contain `@` boxes inside the type for
9786       reference counting have been removed.
9787     * The semantics around the lifetimes of temporary expressions have changed,
9788       see #3511 and #11585 for more information.
9789     * Cross-crate syntax extensions are now possible, but feature gated. See
9790       #11151 for more information. This includes both `macro_rules!` macros as
9791       well as syntax extensions such as `format!`.
9792     * New lint modes have been added, and older ones have been turned on to be
9793       warn-by-default.
9794       * Unnecessary parentheses
9795       * Uppercase statics
9796       * Camel Case types
9797       * Uppercase variables
9798       * Publicly visible private types
9799       * `#[deriving]` with raw pointers
9800     * Unsafe functions can no longer be coerced to closures.
9801     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9802     * The `#[simd]` attribute is now behind a feature gate.
9803     * Visibility is no longer allowed on `extern crate` statements, and
9804       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9805     * Trailing commas are now allowed in argument lists and tuple patterns.
9806     * The `do` keyword has been removed, it is now a reserved keyword.
9807     * Default type parameters have been implemented, but are feature gated.
9808     * Borrowed variables through captures in closures are now considered soundly.
9809     * `extern mod` is now `extern crate`
9810     * The `Freeze` trait has been removed.
9811     * The `Share` trait has been added for types that can be shared among
9812       threads.
9813     * Labels in macros are now hygienic.
9814     * Expression/statement macro invocations can be delimited with `{}` now.
9815     * Treatment of types allowed in `static mut` locations has been tweaked.
9816     * The `*` and `.` operators are now overloadable through the `Deref` and
9817       `DerefMut` traits.
9818     * `~Trait` and `proc` no longer have `Send` bounds by default.
9819     * Partial type hints are now supported with the `_` type marker.
9820     * An `Unsafe` type was introduced for interior mutability. It is now
9821       considered undefined to transmute from `&T` to `&mut T` without using the
9822       `Unsafe` type.
9823     * The #[linkage] attribute was implemented for extern statics/functions.
9824     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9825     * `Pod` was renamed to `Copy`.
9826
9827   * Libraries
9828     * The `libextra` library has been removed. It has now been decomposed into
9829       component libraries with smaller and more focused nuggets of
9830       functionality. The full list of libraries can be found on the
9831       documentation index page.
9832     * std: `std::condition` has been removed. All I/O errors are now propagated
9833       through the `Result` type. In order to assist with error handling, a
9834       `try!` macro for unwrapping errors with an early return and a lint for
9835       unused results has been added. See #12039 for more information.
9836     * std: The `vec` module has been renamed to `slice`.
9837     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9838       This will become the only growable vector in the future.
9839     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9840       are now found at `std::io::BufferedReader` instead of
9841       `std::io::buffered::BufferedReader`.
9842     * std: `print` and `println` are no longer in the prelude, the `print!` and
9843       `println!` macros are intended to be used instead.
9844     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9845       attempts to statically prevent cycles.
9846     * std: The standard distribution is adopting the policy of pushing failure
9847       to the user rather than failing in libraries. Many functions (such as
9848       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9849     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9850       deriving mode: `#[deriving(Show)]`.
9851     * std: `ToStr` is now implemented for all types implementing `Show`.
9852     * std: The formatting trait methods now take `&self` instead of `&T`
9853     * std: The `invert()` method on iterators has been renamed to `rev()`
9854     * std: `std::num` has seen a reduction in the genericity of its traits,
9855       consolidating functionality into a few core traits.
9856     * std: Backtraces are now printed on task failure if the environment
9857       variable `RUST_BACKTRACE` is present.
9858     * std: Naming conventions for iterators have been standardized. More details
9859       can be found on the wiki's style guide.
9860     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9861       still implement the function.
9862     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9863     * std: `assert_approx_eq!` has been removed
9864     * std: The `e` and `E` formatting specifiers for floats have been added to
9865       print them in exponential notation.
9866     * std: The `Times` trait has been removed
9867     * std: Indications of variance and opting out of builtin bounds is done
9868       through marker types in `std::kinds::marker` now
9869     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9870       `#[deriving(Hash)]` is now possible.
9871     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9872     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9873     * std: `Chan::new` is now `channel()`.
9874     * std: A new synchronous channel type has been implemented.
9875     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9876     * std: `hashmap` and `trie` have been moved to `libcollections`
9877     * std: `run` has been rolled into `io::process`
9878     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9879     * std: The equality and comparison traits have seen some reorganization.
9880     * std: `rand` has moved to `librand`.
9881     * std: `to_{lower,upper}case` has been implemented for `char`.
9882     * std: Logging has been moved to `liblog`.
9883     * collections: `HashMap` has been rewritten for higher performance and less
9884       memory usage.
9885     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9886       it can be booted manually. The runtime guide has more information and
9887       examples.
9888     * native: All I/O functionality except signals has been implemented.
9889     * green: Task spawning with `libgreen` has been optimized with stack caching
9890       and various trimming of code.
9891     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9892     * sync: The `extra::sync` module has been updated to modern rust (and moved
9893       to the `sync` library), tweaking and improving various interfaces while
9894       dropping redundant functionality.
9895     * sync: A new `Barrier` type has been added to the `sync` library.
9896     * sync: An efficient mutex for native and green tasks has been implemented.
9897     * serialize: The `base64` module has seen some improvement. It treats
9898       newlines better, has non-string error values, and has seen general
9899       cleanup.
9900     * fourcc: A `fourcc!` macro was introduced
9901     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9902       hexadecimal literal.
9903
9904   * Tooling
9905     * `rustpkg` has been deprecated and removed from the main repository. Its
9906       replacement, `cargo`, is under development.
9907     * Nightly builds of rust are now available
9908     * The memory usage of rustc has been improved many times throughout this
9909       release cycle.
9910     * The build process supports disabling rpath support for the rustc binary
9911       itself.
9912     * Code generation has improved in some cases, giving more information to the
9913       LLVM optimization passes to enable more extensive optimizations.
9914     * Debuginfo compatibility with lldb on OSX has been restored.
9915     * The master branch is now gated on an android bot, making building for
9916       android much more reliable.
9917     * Output flags have been centralized into one `--emit` flag.
9918     * Crate type flags have been centralized into one `--crate-type` flag.
9919     * Codegen flags have been consolidated behind a `-C` flag.
9920     * Linking against outdated crates now has improved error messages.
9921     * Error messages with lifetimes will often suggest how to annotate the
9922       function to fix the error.
9923     * Many more types are documented in the standard library, and new guides
9924       were written.
9925     * Many `rustdoc` improvements:
9926       * code blocks are syntax highlighted.
9927       * render standalone markdown files.
9928       * the --test flag tests all code blocks by default.
9929       * exported macros are displayed.
9930       * re-exported types have their documentation inlined at the location of the
9931         first re-export.
9932       * search works across crates that have been rendered to the same output
9933         directory.
9934
9935
9936 Version 0.9 (2014-01-09)
9937 ==========================
9938
9939    * ~1800 changes, numerous bugfixes
9940
9941    * Language
9942       * The `float` type has been removed. Use `f32` or `f64` instead.
9943       * A new facility for enabling experimental features (feature gating) has
9944         been added, using the crate-level `#[feature(foo)]` attribute.
9945       * Managed boxes (@) are now behind a feature gate
9946         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9947         standard library's `Gc` or `Rc` types instead.
9948       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9949       * Jumping back to the top of a loop is now done with `continue` instead of
9950         `loop`.
9951       * Strings can no longer be mutated through index assignment.
9952       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9953         hash delimiters, as in `r###"foo"###`.
9954       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9955         called once.
9956       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9957       * `@fn`s have been removed.
9958       * `do` only works with procs in order to make it obvious what the cost
9959         of `do` is.
9960       * Single-element tuple-like structs can no longer be dereferenced to
9961         obtain the inner value. A more comprehensive solution for overloading
9962         the dereference operator will be provided in the future.
9963       * The `#[link(...)]` attribute has been replaced with
9964         `#[crate_id = "name#vers"]`.
9965       * Empty `impl`s must be terminated with empty braces and may not be
9966         terminated with a semicolon.
9967       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9968         no longer has any special meaning.
9969       * The old `fmt!` string formatting macro has been removed.
9970       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9971         `print!` and `println!`.
9972       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9973       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9974         `extern mod foo = "bar"` instead.
9975       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9976       * Macros can have attributes.
9977       * Macros can expand to items with attributes.
9978       * Macros can expand to multiple items.
9979       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9980       * Comments may be nested.
9981       * Values automatically coerce to trait objects they implement, without
9982         an explicit `as`.
9983       * Enum discriminants are no longer an entire word but as small as needed to
9984         contain all the variants. The `repr` attribute can be used to override
9985         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9986         `#[repr(C)]` to match C enums.
9987       * Non-string literals are not allowed in attributes (they never worked).
9988       * The FFI now supports variadic functions.
9989       * Octal numeric literals, as in `0o7777`.
9990       * The `concat!` syntax extension performs compile-time string concatenation.
9991       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9992         removed as Rust no longer uses segmented stacks.
9993       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9994       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9995         not `*`; ignoring remaining fields of a struct is also done with `..`,
9996         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9997       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9998       * `rustc` supports the "system" calling convention, which defaults to the
9999         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10000         "C" elsewhere.
10001       * The `type_overflow` lint (default: warn) checks literals for overflow.
10002       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10003       * The `attribute_usage` lint (default: warn) warns about unknown
10004         attributes.
10005       * The `unknown_features` lint (default: warn) warns about unknown
10006         feature gates.
10007       * The `dead_code` lint (default: warn) checks for dead code.
10008       * Rust libraries can be linked statically to one another
10009       * `#[link_args]` is behind the `link_args` feature gate.
10010       * Native libraries are now linked with `#[link(name = "foo")]`
10011       * Native libraries can be statically linked to a rust crate
10012         (`#[link(name = "foo", kind = "static")]`).
10013       * Native OS X frameworks are now officially supported
10014         (`#[link(name = "foo", kind = "framework")]`).
10015       * The `#[thread_local]` attribute creates thread-local (not task-local)
10016         variables. Currently behind the `thread_local` feature gate.
10017       * The `return` keyword may be used in closures.
10018       * Types that can be copied via a memcpy implement the `Pod` kind.
10019       * The `cfg` attribute can now be used on struct fields and enum variants.
10020
10021    * Libraries
10022       * std: The `option` and `result` API's have been overhauled to make them
10023         simpler, more consistent, and more composable.
10024       * std: The entire `std::io` module has been replaced with one that is
10025         more comprehensive and that properly interfaces with the underlying
10026         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10027         implemented.
10028       * std: `io::util` contains a number of useful implementations of
10029         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10030         `ZeroReader`, `TeeReader`.
10031       * std: The reference counted pointer type `extra::rc` moved into std.
10032       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10033         just a wrapper around it).
10034       * std: The `Either` type has been removed.
10035       * std: `fmt::Default` can be implemented for any type to provide default
10036         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10037       * std: The `rand` API continues to be tweaked.
10038       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10039         on failure in gdb, is now named `rust_fail`.
10040       * std: The `each_key` and `each_value` methods on `HashMap` have been
10041         replaced by the `keys` and `values` iterators.
10042       * std: Functions dealing with type size and alignment have moved from the
10043         `sys` module to the `mem` module.
10044       * std: The `path` module was written and API changed.
10045       * std: `str::from_utf8` has been changed to cast instead of allocate.
10046       * std: `starts_with` and `ends_with` methods added to vectors via the
10047         `ImmutableEqVector` trait, which is in the prelude.
10048       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10049         if the index is out of bounds.
10050       * std: Task failure no longer propagates between tasks, as the model was
10051         complex, expensive, and incompatible with thread-based tasks.
10052       * std: The `Any` type can be used for dynamic typing.
10053       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10054         `task::try`.
10055       * std: Methods that produce iterators generally do not have an `_iter`
10056         suffix now.
10057       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10058         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10059       * std: `util::ignore` renamed to `prelude::drop`.
10060       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10061         trait.
10062       * std: `vec::raw` has seen a lot of cleanup and API changes.
10063       * std: The standard library no longer includes any C++ code, and very
10064         minimal C, eliminating the dependency on libstdc++.
10065       * std: Runtime scheduling and I/O functionality has been factored out into
10066         extensible interfaces and is now implemented by two different crates:
10067         libnative, for native threading and I/O; and libgreen, for green threading
10068         and I/O. This paves the way for using the standard library in more limited
10069         embedded environments.
10070       * std: The `comm` module has been rewritten to be much faster, have a
10071         simpler, more consistent API, and to work for both native and green
10072         threading.
10073       * std: All libuv dependencies have been moved into the rustuv crate.
10074       * native: New implementations of runtime scheduling on top of OS threads.
10075       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10076         and other I/O.
10077       * green: The green thread scheduler and message passing types are almost
10078         entirely lock-free.
10079       * extra: The `flatpipes` module had bitrotted and was removed.
10080       * extra: All crypto functions have been removed and Rust now has a policy of
10081         not reimplementing crypto in the standard library. In the future crypto
10082         will be provided by external crates with bindings to established libraries.
10083       * extra: `c_vec` has been modernized.
10084       * extra: The `sort` module has been removed. Use the `sort` method on
10085         mutable slices.
10086
10087    * Tooling
10088       * The `rust` and `rusti` commands have been removed, due to lack of
10089         maintenance.
10090       * `rustdoc` was completely rewritten.
10091       * `rustdoc` can test code examples in documentation.
10092       * `rustpkg` can test packages with the argument, 'test'.
10093       * `rustpkg` supports arbitrary dependencies, including C libraries.
10094       * `rustc`'s support for generating debug info is improved again.
10095       * `rustc` has better error reporting for unbalanced delimiters.
10096       * `rustc`'s JIT support was removed due to bitrot.
10097       * Executables and static libraries can be built with LTO (-Z lto)
10098       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10099         build tools.
10100
10101
10102 Version 0.8 (2013-09-26)
10103 ============================
10104
10105    * ~2200 changes, numerous bugfixes
10106
10107    * Language
10108       * The `for` loop syntax has changed to work with the `Iterator` trait.
10109       * At long last, unwinding works on Windows.
10110       * Default methods are ready for use.
10111       * Many trait inheritance bugs fixed.
10112       * Owned and borrowed trait objects work more reliably.
10113       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10114       * rustc can omit emission of code for the `debug!` macro if it is passed
10115         `--cfg ndebug`
10116       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10117         for foo.rs, then foo/mod.rs, and will generate an error when both are
10118         present.
10119       * Strings no longer contain trailing nulls. The new `std::c_str` module
10120         provides new mechanisms for converting to C strings.
10121       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10122       * The FFI has been overhauled such that foreign functions are called directly,
10123         instead of through a stack-switching wrapper.
10124       * Calling a foreign function must be done through a Rust function with the
10125         `#[fixed_stack_segment]` attribute.
10126       * The `externfn!` macro can be used to declare both a foreign function and
10127         a `#[fixed_stack_segment]` wrapper at once.
10128       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10129       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10130       * `priv` is disallowed everywhere except for struct fields and enum variants.
10131       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10132       * `ref` bindings in irrefutable patterns work correctly now.
10133       * `char` is now prevented from containing invalid code points.
10134       * Casting to `bool` is no longer allowed.
10135       * `\0` is now accepted as an escape in chars and strings.
10136       * `yield` is a reserved keyword.
10137       * `typeof` is a reserved keyword.
10138       * Crates may be imported by URL with `extern mod foo = "url";`.
10139       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10140       * Static vectors can be initialized with repeating elements,
10141         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10142       * Static structs can be initialized with functional record update,
10143         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10144       * `cfg!` can be used to conditionally execute code based on the crate
10145         configuration, similarly to `#[cfg(...)]`.
10146       * The `unnecessary_qualification` lint detects unneeded module
10147         prefixes (default: allow).
10148       * Arithmetic operations have been implemented on the SIMD types in
10149         `std::unstable::simd`.
10150       * Exchange allocation headers were removed, reducing memory usage.
10151       * `format!` implements a completely new, extensible, and higher-performance
10152         string formatting system. It will replace `fmt!`.
10153       * `print!` and `println!` write formatted strings (using the `format!`
10154         extension) to stdout.
10155       * `write!` and `writeln!` write formatted strings (using the `format!`
10156         extension) to the new Writers in `std::rt::io`.
10157       * The library section in which a function or static is placed may
10158         be specified with `#[link_section = "..."]`.
10159       * The `proto!` syntax extension for defining bounded message protocols
10160         was removed.
10161       * `macro_rules!` is hygienic for `let` declarations.
10162       * The `#[export_name]` attribute specifies the name of a symbol.
10163       * `unreachable!` can be used to indicate unreachable code, and fails
10164         if executed.
10165
10166    * Libraries
10167       * std: Transitioned to the new runtime, written in Rust.
10168       * std: Added an experimental I/O library, `rt::io`, based on the new
10169         runtime.
10170       * std: A new generic `range` function was added to the prelude, replacing
10171         `uint::range` and friends.
10172       * std: `range_rev` no longer exists. Since range is an iterator it can be
10173         reversed with `range(lo, hi).invert()`.
10174       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10175         renamed to `unwrap_or`.
10176       * std: The `iterator` module was renamed to `iter`.
10177       * std: Integral types now support the `checked_add`, `checked_sub`, and
10178         `checked_mul` operations for detecting overflow.
10179       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10180         consistency.
10181       * std: Methods are standardizing on conventions for casting methods:
10182         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10183         and cheap casts.
10184       * std: The `CString` type in `c_str` provides new ways to convert to and
10185         from C strings.
10186       * std: `DoubleEndedIterator` can yield elements in two directions.
10187       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10188         two splices.
10189       * std: `str::from_bytes` renamed to `str::from_utf8`.
10190       * std: `pop_opt` and `shift_opt` methods added to vectors.
10191       * std: The task-local data interface no longer uses @, and keys are
10192         no longer function pointers.
10193       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10194       * std: Added `SharedPort` to `comm`.
10195       * std: `Eq` has a default method for `ne`; only `eq` is required
10196         in implementations.
10197       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10198         is required in implementations.
10199       * std: `is_utf8` performance is improved, impacting many string functions.
10200       * std: `os::MemoryMap` provides cross-platform mmap.
10201       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10202         are not 'in-bounds' are considered undefined.
10203       * std: Many freestanding functions in `vec` removed in favor of methods.
10204       * std: Many freestanding functions on scalar types removed in favor of
10205         methods.
10206       * std: Many options to task builders were removed since they don't make
10207         sense in the new scheduler design.
10208       * std: More containers implement `FromIterator` so can be created by the
10209         `collect` method.
10210       * std: More complete atomic types in `unstable::atomics`.
10211       * std: `comm::PortSet` removed.
10212       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10213         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10214         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10215         default implementations.
10216       * std: Various `from_str` functions were removed in favor of a generic
10217         `from_str` which is available in the prelude.
10218       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10219       * extra: `dlist`, the doubly-linked list was modernized.
10220       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10221       * extra: Added `glob` module, replacing `std::os::glob`.
10222       * extra: `rope` was removed.
10223       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10224       * extra: `net`, and `timer` were removed. The experimental replacements
10225         are `std::rt::io::net` and `std::rt::io::timer`.
10226       * extra: Iterators implemented for `SmallIntMap`.
10227       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10228       * extra: `SmallIntSet` removed. Use `BitvSet`.
10229       * extra: Performance of JSON parsing greatly improved.
10230       * extra: `semver` updated to SemVer 2.0.0.
10231       * extra: `term` handles more terminals correctly.
10232       * extra: `dbg` module removed.
10233       * extra: `par` module removed.
10234       * extra: `future` was cleaned up, with some method renames.
10235       * extra: Most free functions in `getopts` were converted to methods.
10236
10237    * Other
10238       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10239       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10240         similarly to gcc's `--march` flag.
10241       * rustc's performance compiling small crates is much better.
10242       * rustpkg has received many improvements.
10243       * rustpkg supports git tags as package IDs.
10244       * rustpkg builds into target-specific directories so it can be used for
10245         cross-compiling.
10246       * The number of concurrent test tasks is controlled by the environment
10247         variable RUST_TEST_TASKS.
10248       * The test harness can now report metrics for benchmarks.
10249       * All tools have man pages.
10250       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10251       * The runtime uses jemalloc for allocations.
10252       * Segmented stacks are temporarily disabled as part of the transition to
10253         the new runtime. Stack overflows are possible!
10254       * A new documentation backend, rustdoc_ng, is available for use. It is
10255         still invoked through the normal `rustdoc` command.
10256
10257
10258 Version 0.7 (2013-07-03)
10259 =======================
10260
10261    * ~2000 changes, numerous bugfixes
10262
10263    * Language
10264       * `impl`s no longer accept a visibility qualifier. Put them on methods
10265         instead.
10266       * The borrow checker has been rewritten with flow-sensitivity, fixing
10267         many bugs and inconveniences.
10268       * The `self` parameter no longer implicitly means `&'self self`,
10269         and can be explicitly marked with a lifetime.
10270       * Overloadable compound operators (`+=`, etc.) have been temporarily
10271         removed due to bugs.
10272       * The `for` loop protocol now requires `for`-iterators to return `bool`
10273         so they compose better.
10274       * The `Durable` trait is replaced with the `'static` bounds.
10275       * Trait default methods work more often.
10276       * Structs with the `#[packed]` attribute have byte alignment and
10277         no padding between fields.
10278       * Type parameters bound by `Copy` must now be copied explicitly with
10279         the `copy` keyword.
10280       * It is now illegal to move out of a dereferenced unsafe pointer.
10281       * `Option<~T>` is now represented as a nullable pointer.
10282       * `@mut` does dynamic borrow checks correctly.
10283       * The `main` function is only detected at the topmost level of the crate.
10284         The `#[main]` attribute is still valid anywhere.
10285       * Struct fields may no longer be mutable. Use inherited mutability.
10286       * The `#[no_send]` attribute makes a type that would otherwise be
10287         `Send`, not.
10288       * The `#[no_freeze]` attribute makes a type that would otherwise be
10289         `Freeze`, not.
10290       * Unbounded recursion will abort the process after reaching the limit
10291         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10292       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10293         are never implicitly copyable.
10294       * `#[static_assert]` makes compile-time assertions about static bools.
10295       * At long last, 'argument modes' no longer exist.
10296       * The rarely used `use mod` statement no longer exists.
10297
10298    * Syntax extensions
10299       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10300         argument list.
10301       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10302         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10303         `#[deriving(...)]`.
10304       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10305         and unsuffixed integer literals.
10306
10307    * Libraries
10308       * The `core` crate was renamed to `std`.
10309       * The `std` crate was renamed to `extra`.
10310       * More and improved documentation.
10311       * std: `iterator` module for external iterator objects.
10312       * Many old-style (internal, higher-order function) iterators replaced by
10313         implementations of `Iterator`.
10314       * std: Many old internal vector and string iterators,
10315         incl. `any`, `all`. removed.
10316       * std: The `finalize` method of `Drop` renamed to `drop`.
10317       * std: The `drop` method now takes `&mut self` instead of `&self`.
10318       * std: The prelude no longer re-exports any modules, only types and traits.
10319       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10320         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10321       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10322         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10323       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10324         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10325       * std: Many types implement `Clone`.
10326       * std: `path` type renamed to `Path`.
10327       * std: `mut` module and `Mut` type removed.
10328       * std: Many standalone functions removed in favor of methods and iterators
10329         in `vec`, `str`. In the future methods will also work as functions.
10330       * std: `reinterpret_cast` removed. Use `transmute`.
10331       * std: ascii string handling in `std::ascii`.
10332       * std: `Rand` is implemented for ~/@.
10333       * std: `run` module for spawning processes overhauled.
10334       * std: Various atomic types added to `unstable::atomic`.
10335       * std: Various types implement `Zero`.
10336       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10337       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10338       * std: Added `os::mkdir_recursive`.
10339       * std: Added `os::glob` function performs filesystems globs.
10340       * std: `FuzzyEq` renamed to `ApproxEq`.
10341       * std: `Map` now defines `pop` and `swap` methods.
10342       * std: `Cell` constructors converted to static methods.
10343       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10344       * extra: `flate` module moved from `std` to `extra`.
10345       * extra: `fileinput` module for iterating over a series of files.
10346       * extra: `Complex` number type and `complex` module.
10347       * extra: `Rational` number type and `rational` module.
10348       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10349       * extra: `term` uses terminfo now, is more correct.
10350       * extra: `arc` functions converted to methods.
10351       * extra: Implementation of fixed output size variations of SHA-2.
10352
10353    * Tooling
10354       * `unused_variables` lint mode for unused variables (default: warn).
10355       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10356         (default: warn).
10357       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10358         (default: warn).
10359       * `dead_assignment` lint mode for unread variables (default: warn).
10360       * `unnecessary_allocation` lint mode detects some heap allocations that are
10361         immediately borrowed so could be written without allocating (default: warn).
10362       * `missing_doc` lint mode (default: allow).
10363       * `unreachable_code` lint mode (default: warn).
10364       * The `rusti` command has been rewritten and a number of bugs addressed.
10365       * rustc outputs in color on more terminals.
10366       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10367       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10368       * Compiling with `-g` will make the binary record information about
10369         dynamic borrowcheck failures for debugging.
10370       * rustdoc has a nicer stylesheet.
10371       * Various improvements to rustdoc.
10372       * Improvements to rustpkg (see the detailed release notes).
10373
10374
10375 Version 0.6 (2013-04-03)
10376 ========================
10377
10378    * ~2100 changes, numerous bugfixes
10379
10380    * Syntax changes
10381       * The self type parameter in traits is now spelled `Self`
10382       * The `self` parameter in trait and impl methods must now be explicitly
10383         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10384       * Static methods no longer require the `static` keyword and instead
10385         are distinguished by the lack of a `self` parameter
10386       * Replaced the `Durable` trait with the `'static` lifetime
10387       * The old closure type syntax with the trailing sigil has been
10388         removed in favor of the more consistent leading sigil
10389       * `super` is a keyword, and may be prefixed to paths
10390       * Trait bounds are separated with `+` instead of whitespace
10391       * Traits are implemented with `impl Trait for Type`
10392         instead of `impl Type: Trait`
10393       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10394       * The `export` keyword has finally been removed
10395       * The `move` keyword has been removed (see "Semantic changes")
10396       * The interior mutability qualifier on vectors, `[mut T]`, has been
10397         removed. Use `&mut [T]`, etc.
10398       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10399       * `fail` is no longer a keyword. Use `fail!()`
10400       * `assert` is no longer a keyword. Use `assert!()`
10401       * `log` is no longer a keyword. use `debug!`, etc.
10402       * 1-tuples may be represented as `(T,)`
10403       * Struct fields may no longer be `mut`. Use inherited mutability,
10404         `@mut T`, `core::mut` or `core::cell`
10405       * `extern mod { ... }` is no longer valid syntax for foreign
10406         function modules. Use extern blocks: `extern { ... }`
10407       * Newtype enums removed. Use tuple-structs.
10408       * Trait implementations no longer support visibility modifiers
10409       * Pattern matching over vectors improved and expanded
10410       * `const` renamed to `static` to correspond to lifetime name,
10411         and make room for future `static mut` unsafe mutable globals.
10412       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10413       * `Clone` implementations can be automatically generated with
10414         `#[deriving(Clone)]`
10415       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10416         instead of `foo as Bar`.
10417       * Fixed length vector types are now written as `[int, .. 3]`
10418         instead of `[int * 3]`.
10419       * Fixed length vector types can express the length as a constant
10420         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10421
10422    * Semantic changes
10423       * Types with owned pointers or custom destructors move by default,
10424         eliminating the `move` keyword
10425       * All foreign functions are considered unsafe
10426       * &mut is now unaliasable
10427       * Writes to borrowed @mut pointers are prevented dynamically
10428       * () has size 0
10429       * The name of the main function can be customized using #[main]
10430       * The default type of an inferred closure is &fn instead of @fn
10431       * `use` statements may no longer be "chained" - they cannot import
10432         identifiers imported by previous `use` statements
10433       * `use` statements are crate relative, importing from the "top"
10434         of the crate by default. Paths may be prefixed with `super::`
10435         or `self::` to change the search behavior.
10436       * Method visibility is inherited from the implementation declaration
10437       * Structural records have been removed
10438       * Many more types can be used in static items, including enums
10439         'static-lifetime pointers and vectors
10440       * Pattern matching over vectors improved and expanded
10441       * Typechecking of closure types has been overhauled to
10442         improve inference and eliminate unsoundness
10443       * Macros leave scope at the end of modules, unless that module is
10444         tagged with #[macro_escape]
10445
10446    * Libraries
10447       * Added big integers to `std::bigint`
10448       * Removed `core::oldcomm` module
10449       * Added pipe-based `core::comm` module
10450       * Numeric traits have been reorganized under `core::num`
10451       * `vec::slice` finally returns a slice
10452       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10453       * Containers reorganized around traits in `core::container`
10454       * `core::dvec` removed, `~[T]` is a drop-in replacement
10455       * `core::send_map` renamed to `core::hashmap`
10456       * `std::map` removed; replaced with `core::hashmap`
10457       * `std::treemap` reimplemented as an owned balanced tree
10458       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10459       * `core::trie` added as a fast ordered map for integer keys
10460       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10461       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10462         overload the comparison operators, whereas `TotalOrd` is used
10463         by certain container types
10464
10465    * Other
10466       * Replaced the 'cargo' package manager with 'rustpkg'
10467       * Added all-purpose 'rust' tool
10468       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10469       * rustc now *attempts* to offer spelling suggestions
10470       * Improved support for ARM and Android
10471       * Preliminary MIPS backend
10472       * Improved foreign function ABI implementation for x86, x86_64
10473       * Various memory usage improvements
10474       * Rust code may be embedded in foreign code under limited circumstances
10475       * Inline assembler supported by new asm!() syntax extension.
10476
10477
10478 Version 0.5 (2012-12-21)
10479 ===========================
10480
10481    * ~900 changes, numerous bugfixes
10482
10483    * Syntax changes
10484       * Removed `<-` move operator
10485       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10486       * Removed old fixed length vector syntax - `[T]/N`
10487       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10488       * Macros may now expand to items and statements
10489       * `a.b()` is always parsed as a method call, never as a field projection
10490       * `Eq` and `IterBytes` implementations can be automatically generated
10491         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10492       * Removed the special crate language for `.rc` files
10493       * Function arguments may consist of any irrefutable pattern
10494
10495    * Semantic changes
10496       * `&` and `~` pointers may point to objects
10497       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10498       * Enum variants may be structs
10499       * Destructors can be added to all nominal types with the Drop trait
10500       * Structs and nullary enum variants may be constants
10501       * Values that cannot be implicitly copied are now automatically moved
10502         without writing `move` explicitly
10503       * `&T` may now be coerced to `*T`
10504       * Coercions happen in `let` statements as well as function calls
10505       * `use` statements now take crate-relative paths
10506       * The module and type namespaces have been merged so that static
10507         method names can be resolved under the trait in which they are
10508         declared
10509
10510    * Improved support for language features
10511       * Trait inheritance works in many scenarios
10512       * More support for explicit self arguments in methods - `self`, `&self`
10513         `@self`, and `~self` all generally work as expected
10514       * Static methods work in more situations
10515       * Experimental: Traits may declare default methods for the implementations
10516         to use
10517
10518    * Libraries
10519       * New condition handling system in `core::condition`
10520       * Timsort added to `std::sort`
10521       * New priority queue, `std::priority_queue`
10522       * Pipes for serializable types, `std::flatpipes'
10523       * Serialization overhauled to be trait-based
10524       * Expanded `getopts` definitions
10525       * Moved futures to `std`
10526       * More functions are pure now
10527       * `core::comm` renamed to `oldcomm`. Still deprecated
10528       * `rustdoc` and `cargo` are libraries now
10529
10530    * Misc
10531       * Added a preliminary REPL, `rusti`
10532       * License changed from MIT to dual MIT/APL2
10533
10534
10535 Version 0.4 (2012-10-15)
10536 ==========================
10537
10538    * ~2000 changes, numerous bugfixes
10539
10540    * Syntax
10541       * All keywords are now strict and may not be used as identifiers anywhere
10542       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10543         'of', 'with', 'to', 'class'.
10544       * Classes are replaced with simpler structs
10545       * Explicit method self types
10546       * `ret` became `return` and `alt` became `match`
10547       * `import` is now `use`; `use is now `extern mod`
10548       * `extern mod { ... }` is now `extern { ... }`
10549       * `use mod` is the recommended way to import modules
10550       * `pub` and `priv` replace deprecated export lists
10551       * The syntax of `match` pattern arms now uses fat arrow (=>)
10552       * `main` no longer accepts an args vector; use `os::args` instead
10553
10554    * Semantics
10555       * Trait implementations are now coherent, ala Haskell typeclasses
10556       * Trait methods may be static
10557       * Argument modes are deprecated
10558       * Borrowed pointers are much more mature and recommended for use
10559       * Strings and vectors in the static region are stored in constant memory
10560       * Typestate was removed
10561       * Resolution rewritten to be more reliable
10562       * Support for 'dual-mode' data structures (freezing and thawing)
10563
10564    * Libraries
10565       * Most binary operators can now be overloaded via the traits in
10566         `core::ops'
10567       * `std::net::url` for representing URLs
10568       * Sendable hash maps in `core::send_map`
10569       * `core::task' gained a (currently unsafe) task-local storage API
10570
10571    * Concurrency
10572       * An efficient new intertask communication primitive called the pipe,
10573         along with a number of higher-level channel types, in `core::pipes`
10574       * `std::arc`, an atomically reference counted, immutable, shared memory
10575         type
10576       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10577       * Futures are now based on pipes and sendable
10578       * More robust linked task failure
10579       * Improved task builder API
10580
10581    * Other
10582       * Improved error reporting
10583       * Preliminary JIT support
10584       * Preliminary work on precise GC
10585       * Extensive architectural improvements to rustc
10586       * Begun a transition away from buggy C++-based reflection (shape) code to
10587         Rust-based (visitor) code
10588       * All hash functions and tables converted to secure, randomized SipHash
10589
10590
10591 Version 0.3  (2012-07-12)
10592 ========================
10593
10594    * ~1900 changes, numerous bugfixes
10595
10596    * New coding conveniences
10597       * Integer-literal suffix inference
10598       * Per-item control over warnings, errors
10599       * #[cfg(windows)] and #[cfg(unix)] attributes
10600       * Documentation comments
10601       * More compact closure syntax
10602       * 'do' expressions for treating higher-order functions as
10603         control structures
10604       * *-patterns (wildcard extended to all constructor fields)
10605
10606    * Semantic cleanup
10607       * Name resolution pass and exhaustiveness checker rewritten
10608       * Region pointers and borrow checking supersede alias
10609         analysis
10610       * Init-ness checking is now provided by a region-based liveness
10611         pass instead of the typestate pass; same for last-use analysis
10612       * Extensive work on region pointers
10613
10614    * Experimental new language features
10615       * Slices and fixed-size, interior-allocated vectors
10616       * #!-comments for lang versioning, shell execution
10617       * Destructors and iface implementation for classes;
10618         type-parameterized classes and class methods
10619       * 'const' type kind for types that can be used to implement
10620         shared-memory concurrency patterns
10621
10622    * Type reflection
10623
10624    * Removal of various obsolete features
10625       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10626                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10627
10628       * Constructs: do-while loops ('do' repurposed), fn binding,
10629                     resources (replaced by destructors)
10630
10631    * Compiler reorganization
10632       * Syntax-layer of compiler split into separate crate
10633       * Clang (from LLVM project) integrated into build
10634       * Typechecker split into sub-modules
10635
10636    * New library code
10637       * New time functions
10638       * Extension methods for many built-in types
10639       * Arc: atomic-refcount read-only / exclusive-use shared cells
10640       * Par: parallel map and search routines
10641       * Extensive work on libuv interface
10642       * Much vector code moved to libraries
10643       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10644         #include, #include_str, #include_bin
10645
10646    * Tool improvements
10647       * Cargo automatically resolves dependencies
10648
10649
10650 Version 0.2  (2012-03-29)
10651 =========================
10652
10653    * >1500 changes, numerous bugfixes
10654
10655    * New docs and doc tooling
10656
10657    * New port: FreeBSD x86_64
10658
10659    * Compilation model enhancements
10660       * Generics now specialized, multiply instantiated
10661       * Functions now inlined across separate crates
10662
10663    * Scheduling, stack and threading fixes
10664       * Noticeably improved message-passing performance
10665       * Explicit schedulers
10666       * Callbacks from C
10667       * Helgrind clean
10668
10669    * Experimental new language features
10670       * Operator overloading
10671       * Region pointers
10672       * Classes
10673
10674    * Various language extensions
10675       * C-callback function types: 'crust fn ...'
10676       * Infinite-loop construct: 'loop { ... }'
10677       * Shorten 'mutable' to 'mut'
10678       * Required mutable-local qualifier: 'let mut ...'
10679       * Basic glob-exporting: 'export foo::*;'
10680       * Alt now exhaustive, 'alt check' for runtime-checked
10681       * Block-function form of 'for' loop, with 'break' and 'ret'.
10682
10683    * New library code
10684       * AST quasi-quote syntax extension
10685       * Revived libuv interface
10686       * New modules: core::{future, iter}, std::arena
10687       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10688       * Extensive cleanup, regularization in libstd, libcore
10689
10690
10691 Version 0.1  (2012-01-20)
10692 ===============================
10693
10694    * Most language features work, including:
10695       * Unique pointers, unique closures, move semantics
10696       * Interface-constrained generics
10697       * Static interface dispatch
10698       * Stack growth
10699       * Multithread task scheduling
10700       * Typestate predicates
10701       * Failure unwinding, destructors
10702       * Pattern matching and destructuring assignment
10703       * Lightweight block-lambda syntax
10704       * Preliminary macro-by-example
10705
10706    * Compiler works with the following configurations:
10707       * Linux: x86 and x86_64 hosts and targets
10708       * macOS: x86 and x86_64 hosts and targets
10709       * Windows: x86 hosts and targets
10710
10711    * Cross compilation / multi-target configuration supported.
10712
10713    * Preliminary API-documentation and package-management tools included.
10714
10715 Known issues:
10716
10717    * Documentation is incomplete.
10718
10719    * Performance is below intended target.
10720
10721    * Standard library APIs are subject to extensive change, reorganization.
10722
10723    * Language-level versioning is not yet operational - future code will
10724      break unexpectedly.