]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #89675 - oli-obk:type_checker, r=davidtwco
[rust.git] / RELEASES.md
1 Rust 1.56.0 (2021-10-21)
2 ========================
3
4 Language
5 --------
6
7 - [The 2021 Edition is now stable.][rust#88100]
8   See [the edition guide][rust-2021-edition-guide] for more details.
9 - [You can now specify explicit discriminant values on any Rust enum.][rust#86860]
10 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
11 - [Union field access is permitted in `const fn`.][rust#85769]
12
13 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
14
15 Compiler
16 --------
17
18 - [Upgrade to LLVM 13.][rust#87570]
19 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
20 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
21 - [Warnings can be forced on with `--force-warn`.][rust#87472]
22   This feature is primarily intended for usage by `cargo fix`, rather than end users.
23 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
24 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
25
26 \* Refer to Rust's [platform support page][platform-support-doc] for more
27 information on Rust's tiered platform support.
28
29 Libraries
30 ---------
31
32 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
33   The Windows console still requires valid Unicode, but this change allows
34   splitting a UTF-8 character across multiple write calls. This allows, for
35   instance, programs that just read and write data buffers (e.g. copying a file
36   to stdout) without regard for Unicode or character boundaries.
37 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
38   For this use case, atomics scale much better under contention.
39 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
40 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
41 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
42 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
43 - [Treat invalid environment variable names as non-existent.][rust#86183]
44   Previously, the environment functions would panic if given a variable name
45   with an internal null character or equal sign (`=`). Now, these functions will
46   just treat such names as non-existent variables, since the OS cannot represent
47   the existence of a variable with such a name.
48
49 Stabilised APIs
50 ---------------
51
52 - [`std::os::unix::fs::chroot`]
53 - [`Iterator::intersperse`]
54 - [`Iterator::intersperse_with`]
55 - [`UnsafeCell::raw_get`]
56 - [`BufWriter::into_parts`]
57 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
58   These APIs were previously stable in `std`, but are now also available in `core`.
59 - [`Vec::shrink_to`]
60 - [`String::shrink_to`]
61 - [`OsString::shrink_to`]
62 - [`PathBuf::shrink_to`]
63 - [`BinaryHeap::shrink_to`]
64 - [`VecDeque::shrink_to`]
65 - [`HashMap::shrink_to`]
66 - [`HashSet::shrink_to`]
67
68 These APIs are now usable in const contexts:
69
70 - [`std::mem::transmute`]
71 - [`[T]::first`][`slice::first`]
72 - [`[T]::split_first`][`slice::split_first`]
73 - [`[T]::last`][`slice::last`]
74 - [`[T]::split_last`][`slice::split_last`]
75
76 Cargo
77 -----
78
79 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
80   This has no effect at present on dependency version selection.
81   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
82   that support Rust code to include a crate's specified minimum version in the text matrix for that
83   crate by default.
84
85 Compatibility notes
86 -------------------
87
88 - [Update to new argument parsing rules on Windows.][rust#87580]
89   This adjusts Rust's standard library to match the behavior of the standard
90   libraries for C/C++. The rules have changed slightly over time, and this PR
91   brings us to the latest set of rules (changed in 2008).
92 - [Disallow the aapcs calling convention on aarch64][rust#88399]
93   This was already not supported by LLVM; this change surfaces this lack of
94   support with a better error message.
95 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
96 - [Warn when an escaped newline skips multiple lines.][rust#87671]
97 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
98    may return different values on glibc <= 2.24.][rust#81825]
99    Rust now invokes the `clone3` system call directly, when available, to use new functionality
100    available via that system call. Older versions of glibc cache the result of `getpid`, and only
101    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
102    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
103
104 Internal changes
105 ----------------
106 These changes provide no direct user facing benefits, but represent significant
107 improvements to the internals and overall performance of rustc
108 and related tools.
109
110 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
111   This improves the performance of most Rust builds.
112 - [Unify representation of macros in internal data structures.][rust#88019]
113   This change fixes a host of bugs with the handling of macros by the compiler,
114   as well as rustdoc.
115
116 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
117 [`Iterator::intersperse`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
118 [`Iterator::intersperse_with`]: https://doc.rust-lang.org/stable/std/iter/trait.Iterator.html#method.intersperse
119 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
120 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
121 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
122 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
123 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
124 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
125 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
126 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
127 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
128 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
129 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
130 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
131 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
132 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
133 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
134 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
135 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
136 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
137 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
138 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
139 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
140 [rust#86860]: https://github.com/rust-lang/rust/pull/86860
141 [rust#84039]: https://github.com/rust-lang/rust/pull/84039
142 [rust#86492]: https://github.com/rust-lang/rust/pull/86492
143 [rust#88363]: https://github.com/rust-lang/rust/pull/88363
144 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
145 [rust#87832]: https://github.com/rust-lang/rust/pull/87832
146 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
147 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
148 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
149 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
150 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
151 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
152 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
153 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
154 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
155 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
156 [rust#88177]: https://github.com/rust-lang/rust/pull/88177
157 [rust#88548]: https://github.com/rust-lang/rust/pull/88548
158 [rust#88551]: https://github.com/rust-lang/rust/pull/88551
159 [rust#88299]: https://github.com/rust-lang/rust/pull/88299
160 [rust#88220]: https://github.com/rust-lang/rust/pull/88220
161 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
162 [rust#86879]: https://github.com/rust-lang/rust/pull/86879
163 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
164 [rust#84662]: https://github.com/rust-lang/rust/pull/84662
165 [rust#86593]: https://github.com/rust-lang/rust/pull/86593
166 [rust#81050]: https://github.com/rust-lang/rust/pull/81050
167 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
168 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
169 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
170 [rust#88490]: https://github.com/rust-lang/rust/pull/88490
171 [rust#88269]: https://github.com/rust-lang/rust/pull/88269
172 [rust#84176]: https://github.com/rust-lang/rust/pull/84176
173 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
174 [rust#88227]: https://github.com/rust-lang/rust/pull/88227
175 [rust#88200]: https://github.com/rust-lang/rust/pull/88200
176 [rust#82776]: https://github.com/rust-lang/rust/pull/82776
177 [rust#88077]: https://github.com/rust-lang/rust/pull/88077
178 [rust#87728]: https://github.com/rust-lang/rust/pull/87728
179 [rust#87050]: https://github.com/rust-lang/rust/pull/87050
180 [rust#87619]: https://github.com/rust-lang/rust/pull/87619
181 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
182 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
183
184 Version 1.55.0 (2021-09-09)
185 ============================
186
187 Language
188 --------
189 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
190   will end at the maximum value of the integer.][83918]
191 - [You can now explicitly import the prelude of different editions
192   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
193
194 Compiler
195 --------
196 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
197
198 \* Refer to Rust's [platform support page][platform-support-doc] for more
199    information on Rust's tiered platform support.
200
201 Libraries
202 ---------
203
204 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
205   These improvements should in general provide faster string parsing of floats,
206   no longer reject certain valid floating point values, and reduce
207   the produced code size for non-stripped artifacts.
208 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
209
210 Stabilised APIs
211 ---------------
212
213 - [`Bound::cloned`]
214 - [`Drain::as_str`]
215 - [`IntoInnerError::into_error`]
216 - [`IntoInnerError::into_parts`]
217 - [`MaybeUninit::assume_init_mut`]
218 - [`MaybeUninit::assume_init_ref`]
219 - [`MaybeUninit::write`]
220 - [`array::map`]
221 - [`ops::ControlFlow`]
222 - [`x86::_bittest`]
223 - [`x86::_bittestandcomplement`]
224 - [`x86::_bittestandreset`]
225 - [`x86::_bittestandset`]
226 - [`x86_64::_bittest64`]
227 - [`x86_64::_bittestandcomplement64`]
228 - [`x86_64::_bittestandreset64`]
229 - [`x86_64::_bittestandset64`]
230
231 The following previously stable functions are now `const`.
232
233 - [`str::from_utf8_unchecked`]
234
235
236 Cargo
237 -----
238 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
239   rustc in parallel such as when using `cargo test`.][cargo/9675]
240 - [The package definition in `cargo metadata` now includes the `"default_run"`
241   field from the manifest.][cargo/9550]
242 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
243 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
244   of packages.][cargo/9663]
245
246 Rustdoc
247 -------
248 - [Added "Go to item on exact match" search option.][85876]
249 - [The "Implementors" section on traits no longer shows redundant
250   method definitions.][85970]
251 - [Trait implementations are toggled open by default.][86260] This should make the
252   implementations more searchable by tools like `CTRL+F` in your browser.
253 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
254   through type aliases.][86334]
255 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
256   "Trait Implementations" section.][86513]
257
258
259 Compatibility Notes
260 -------------------
261 - [std functions that return an `io::Error` will no longer use the
262   `ErrorKind::Other` variant.][85746] This is to better reflect that these
263   kinds of errors could be categorised [into newer more specific `ErrorKind`
264   variants][79965], and that they do not represent a user error.
265 - [Using environment variable names with `process::Command` on Windows now
266   behaves as expected.][85270] Previously using envionment variables with
267   `Command` would cause them to be ASCII-uppercased.
268 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
269   with `rustdoc::`][86849]
270
271 [86849]: https://github.com/rust-lang/rust/pull/86849
272 [86513]: https://github.com/rust-lang/rust/pull/86513
273 [86334]: https://github.com/rust-lang/rust/pull/86334
274 [86260]: https://github.com/rust-lang/rust/pull/86260
275 [85970]: https://github.com/rust-lang/rust/pull/85970
276 [85876]: https://github.com/rust-lang/rust/pull/85876
277 [83572]: https://github.com/rust-lang/rust/pull/83572
278 [86294]: https://github.com/rust-lang/rust/pull/86294
279 [86858]: https://github.com/rust-lang/rust/pull/86858
280 [86761]: https://github.com/rust-lang/rust/pull/86761
281 [85769]: https://github.com/rust-lang/rust/pull/85769
282 [85746]: https://github.com/rust-lang/rust/pull/85746
283 [85305]: https://github.com/rust-lang/rust/pull/85305
284 [85270]: https://github.com/rust-lang/rust/pull/85270
285 [84111]: https://github.com/rust-lang/rust/pull/84111
286 [83918]: https://github.com/rust-lang/rust/pull/83918
287 [79965]: https://github.com/rust-lang/rust/pull/79965
288 [87370]: https://github.com/rust-lang/rust/pull/87370
289 [87298]: https://github.com/rust-lang/rust/pull/87298
290 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
291 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
292 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
293 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
294 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
295 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
296 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
297 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
298 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
299 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
300 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
301 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
302 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
303 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
304 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
305 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
306 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
307 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
308 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
309 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
310 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
311 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
312 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
313 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
314
315
316 Version 1.54.0 (2021-07-29)
317 ============================
318
319 Language
320 -----------------------
321
322 - [You can now use macros for values in some built-in attributes.][83366]
323   This primarily allows you to call macros within the `#[doc]` attribute. For
324   example, to include external documentation in your crate, you can now write
325   the following:
326   ```rust
327   #![doc = include_str!("README.md")]
328   ```
329
330 - [You can now cast between unsized slice types (and types which contain
331   unsized slices) in `const fn`.][85078]
332 - [You can now use multiple generic lifetimes with `impl Trait` where the
333    lifetimes don't explicitly outlive another.][84701] In code this means
334    that you can now have `impl Trait<'a, 'b>` where as before you could
335    only have `impl Trait<'a, 'b> where 'b: 'a`.
336
337 Compiler
338 -----------------------
339
340 - [Rustc will now search for custom JSON targets in
341   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
342   directory.][83800] You can find your sysroot directory by running
343   `rustc --print sysroot`.
344 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
345 - [You can now use `#[target_feature]` on safe functions when targeting
346   WebAssembly platforms.][84988]
347 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
348 - [Added tier 3\* support for `bpfel-unknown-none`
349    and `bpfeb-unknown-none`.][79608]
350 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
351
352 \* Refer to Rust's [platform support page][platform-support-doc] for more
353    information on Rust's tiered platform support.
354
355 Libraries
356 -----------------------
357
358 - [`panic::panic_any` will now `#[track_caller]`.][85745]
359 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
360 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
361 - [The implementations of vendor intrinsics in core::arch have been
362    significantly refactored.][83278] The main user-visible changes are
363    a 50% reduction in the size of libcore.rlib and stricter validation
364    of constant operands passed to intrinsics. The latter is technically
365    a breaking change, but allows Rust to more closely match the C vendor
366    intrinsics API.
367
368 Stabilized APIs
369 ---------------
370
371 - [`BTreeMap::into_keys`]
372 - [`BTreeMap::into_values`]
373 - [`HashMap::into_keys`]
374 - [`HashMap::into_values`]
375 - [`arch::wasm32`]
376 - [`VecDeque::binary_search`]
377 - [`VecDeque::binary_search_by`]
378 - [`VecDeque::binary_search_by_key`]
379 - [`VecDeque::partition_point`]
380
381 Cargo
382 -----
383
384 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
385   the dependency graph.][cargo/9520]
386 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
387   in the tree ][cargo/9499]
388 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
389   macro dependencies.][cargo/9488]
390 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
391   This variable points to a directory that integration tests and benches
392   can use as a "scratchpad" for testing filesystem operations.
393
394 Compatibility Notes
395 -------------------
396 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
397 - [Previously unsound code is no longer permitted where different constructors in branches
398   could require different lifetimes.][85574]
399 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
400   than before and may reject some previously accepted code.
401 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
402    when compiled with `codegen-units = 1`.][86063]
403
404 [85574]: https://github.com/rust-lang/rust/issues/85574
405 [86831]: https://github.com/rust-lang/rust/issues/86831
406 [86063]: https://github.com/rust-lang/rust/issues/86063
407 [86831]: https://github.com/rust-lang/rust/issues/86831
408 [79608]: https://github.com/rust-lang/rust/pull/79608
409 [84988]: https://github.com/rust-lang/rust/pull/84988
410 [84701]: https://github.com/rust-lang/rust/pull/84701
411 [84072]: https://github.com/rust-lang/rust/pull/84072
412 [85745]: https://github.com/rust-lang/rust/pull/85745
413 [84744]: https://github.com/rust-lang/rust/pull/84744
414 [85078]: https://github.com/rust-lang/rust/pull/85078
415 [84717]: https://github.com/rust-lang/rust/pull/84717
416 [83800]: https://github.com/rust-lang/rust/pull/83800
417 [83366]: https://github.com/rust-lang/rust/pull/83366
418 [83278]: https://github.com/rust-lang/rust/pull/83278
419 [85292]: https://github.com/rust-lang/rust/pull/85292
420 [82834]: https://github.com/rust-lang/rust/pull/82834
421 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
422 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
423 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
424 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
425 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
426 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
427 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
428 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
429 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
430 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
431 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
432
433 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
434
435 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
436
437 Version 1.53.0 (2021-06-17)
438 ============================
439
440 Language
441 -----------------------
442 - [You can now use unicode for identifiers.][83799] This allows multilingual
443   identifiers but still doesn't allow glyphs that are not considered characters
444   such as `◆` or `🦀`. More specifically you can now use any identifier that
445   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
446   is the same standard as languages like Python, however Rust uses NFC
447   normalization which may be different from other languages.
448 - [You can now specify "or patterns" inside pattern matches.][79278]
449   Previously you could only use `|` (OR) on complete patterns. E.g.
450   ```rust
451   let x = Some(2u8);
452   // Before
453   matches!(x, Some(1) | Some(2));
454   // Now
455   matches!(x, Some(1 | 2));
456   ```
457 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
458   has the same semantics as the `:pat` matcher. This is to allow `:pat`
459   to change semantics to being a pattern fragment in a future edition.
460
461 Compiler
462 -----------------------
463 - [Updated the minimum external LLVM version to LLVM 10.][83387]
464 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
465 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
466
467 \* Refer to Rust's [platform support page][platform-support-doc] for more
468 information on Rust's tiered platform support.
469
470 Libraries
471 -----------------------
472 - [Abort messages will now forward to `android_set_abort_message` on
473   Android platforms when available.][81469]
474 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
475 - [Arrays of any length now implement `IntoIterator`.][84147]
476   Currently calling `.into_iter()` as a method on an array will
477   return `impl Iterator<Item=&T>`, but this may change in a
478   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
479   directly on arrays will provide `impl Iterator<Item=T>` as expected.
480 - [`leading_zeros`, and `trailing_zeros` are now available on all
481   `NonZero` integer types.][84082]
482 - [`{f32, f64}::from_str` now parse and print special values
483   (`NaN`, `-0`) according to IEEE 754.][78618]
484 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
485 - [Add the `BITS` associated constant to all numeric types.][82565]
486
487 Stabilised APIs
488 ---------------
489 - [`AtomicBool::fetch_update`]
490 - [`AtomicPtr::fetch_update`]
491 - [`BTreeMap::retain`]
492 - [`BTreeSet::retain`]
493 - [`BufReader::seek_relative`]
494 - [`DebugStruct::non_exhaustive`]
495 - [`Duration::MAX`]
496 - [`Duration::ZERO`]
497 - [`Duration::is_zero`]
498 - [`Duration::saturating_add`]
499 - [`Duration::saturating_mul`]
500 - [`Duration::saturating_sub`]
501 - [`ErrorKind::Unsupported`]
502 - [`Option::insert`]
503 - [`Ordering::is_eq`]
504 - [`Ordering::is_ge`]
505 - [`Ordering::is_gt`]
506 - [`Ordering::is_le`]
507 - [`Ordering::is_lt`]
508 - [`Ordering::is_ne`]
509 - [`OsStr::is_ascii`]
510 - [`OsStr::make_ascii_lowercase`]
511 - [`OsStr::make_ascii_uppercase`]
512 - [`OsStr::to_ascii_lowercase`]
513 - [`OsStr::to_ascii_uppercase`]
514 - [`Peekable::peek_mut`]
515 - [`Rc::decrement_strong_count`]
516 - [`Rc::increment_strong_count`]
517 - [`Vec::extend_from_within`]
518 - [`array::from_mut`]
519 - [`array::from_ref`]
520 - [`cmp::max_by_key`]
521 - [`cmp::max_by`]
522 - [`cmp::min_by_key`]
523 - [`cmp::min_by`]
524 - [`f32::is_subnormal`]
525 - [`f64::is_subnormal`]
526
527 Cargo
528 -----------------------
529 - [Cargo now supports git repositories where the default `HEAD` branch is not
530   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
531   which can handle default branches correctly.
532 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
533 - [The `authors` field is no longer included in `Cargo.toml` for new
534   projects.][cargo/9282]
535
536 Rustdoc
537 -----------------------
538 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
539   without hyperlinks.][81764]
540
541 Compatibility Notes
542 -------------------
543 - [Implement token-based handling of attributes during expansion][82608]
544 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
545   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
546   to confusion and potential security vulnerabilities and [is no
547   longer recommended][ietf6943].
548 - [The added `BITS` constant may conflict with external definitions.][85667]
549   In particular, this was known to be a problem in the `lexical-core` crate,
550   but they have published fixes for semantic versions 0.4 through 0.7. To
551   update this dependency alone, use `cargo update -p lexical-core`.
552 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
553
554 Internal Only
555 -------------
556 These changes provide no direct user facing benefits, but represent significant
557 improvements to the internals and overall performance of rustc and
558 related tools.
559
560 - [Rework the `std::sys::windows::alloc` implementation.][83065]
561 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
562 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
563 - [Rework rustdoc const type][82873]
564
565 [85667]: https://github.com/rust-lang/rust/pull/85667
566 [83386]: https://github.com/rust-lang/rust/pull/83386
567 [82771]: https://github.com/rust-lang/rust/pull/82771
568 [84147]: https://github.com/rust-lang/rust/pull/84147
569 [84082]: https://github.com/rust-lang/rust/pull/84082
570 [83799]: https://github.com/rust-lang/rust/pull/83799
571 [83681]: https://github.com/rust-lang/rust/pull/83681
572 [83652]: https://github.com/rust-lang/rust/pull/83652
573 [83387]: https://github.com/rust-lang/rust/pull/83387
574 [82873]: https://github.com/rust-lang/rust/pull/82873
575 [82864]: https://github.com/rust-lang/rust/pull/82864
576 [82608]: https://github.com/rust-lang/rust/pull/82608
577 [82565]: https://github.com/rust-lang/rust/pull/82565
578 [80525]: https://github.com/rust-lang/rust/pull/80525
579 [79278]: https://github.com/rust-lang/rust/pull/79278
580 [78618]: https://github.com/rust-lang/rust/pull/78618
581 [77704]: https://github.com/rust-lang/rust/pull/77704
582 [83941]: https://github.com/rust-lang/rust/pull/83941
583 [83065]: https://github.com/rust-lang/rust/pull/83065
584 [81764]: https://github.com/rust-lang/rust/pull/81764
585 [81469]: https://github.com/rust-lang/rust/pull/81469
586 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
587 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
588 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
589 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
590 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
591 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
592 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
593 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
594 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
595 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
596 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
597 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
598 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
599 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
600 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
601 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
602 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
603 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
604 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
605 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
606 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
607 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
608 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
609 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
610 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
611 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
612 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
613 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
614 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
615 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
616 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
617 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
618 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
619 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
620 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
621 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
622 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
623 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
624 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
625 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
626 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
627 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
628
629
630 Version 1.52.1 (2021-05-10)
631 ============================
632
633 This release disables incremental compilation, unless the user has explicitly
634 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
635
636 This is due to the widespread, and frequently occuring, breakage encountered by
637 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
638 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
639 newly added incremental verification are still present in past stable versions,
640 and are not yet fixed on any channel. These bugs can lead to miscompilation of
641 Rust binaries.
642
643 These problems only affect incremental builds, so release builds with Cargo
644 should not be affected unless the user has explicitly opted into incremental.
645 Debug and check builds are affected.
646
647 See [84970] for more details.
648
649 [84970]: https://github.com/rust-lang/rust/issues/84970
650
651 Version 1.52.0 (2021-05-06)
652 ============================
653
654 Language
655 --------
656 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
657   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
658   is allowed by default, and may become a warning or hard error in a
659   future edition.
660 - [You can now cast mutable references to arrays to a pointer of the same type as
661   the element.][81479]
662
663 Compiler
664 --------
665 - [Upgraded the default LLVM to LLVM 12.][81451]
666
667 Added tier 3\* support for the following targets.
668
669 - [`s390x-unknown-linux-musl`][82166]
670 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
671 - [`powerpc-unknown-openbsd`][82733]
672
673 \* Refer to Rust's [platform support page][platform-support-doc] for more
674 information on Rust's tiered platform support.
675
676 Libraries
677 ---------
678 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
679 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
680 - [`Arc<impl Error>` now implements `error::Error`.][80553]
681 - [All integer division and remainder operations are now `const`.][80962]
682
683 Stabilised APIs
684 -------------
685 - [`Arguments::as_str`]
686 - [`char::MAX`]
687 - [`char::REPLACEMENT_CHARACTER`]
688 - [`char::UNICODE_VERSION`]
689 - [`char::decode_utf16`]
690 - [`char::from_digit`]
691 - [`char::from_u32_unchecked`]
692 - [`char::from_u32`]
693 - [`slice::partition_point`]
694 - [`str::rsplit_once`]
695 - [`str::split_once`]
696
697 The following previously stable APIs are now `const`.
698
699 - [`char::len_utf8`]
700 - [`char::len_utf16`]
701 - [`char::to_ascii_uppercase`]
702 - [`char::to_ascii_lowercase`]
703 - [`char::eq_ignore_ascii_case`]
704 - [`u8::to_ascii_uppercase`]
705 - [`u8::to_ascii_lowercase`]
706 - [`u8::eq_ignore_ascii_case`]
707
708 Rustdoc
709 -------
710 - [Rustdoc lints are now treated as a tool lint, meaning that
711   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
712   Using the old style is still allowed, and will become a warning in
713   a future release.
714 - [Rustdoc now supports argument files.][82261]
715 - [Rustdoc now generates smart punctuation for documentation.][79423]
716 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
717   ```markdown
718   - [x] Complete
719   - [ ] Todo
720   ```
721
722 Misc
723 ----
724 - [You can now pass multiple filters to tests.][81356] E.g.
725   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
726 - [Rustup now distributes PDB symbols for the `std` library on Windows,
727   allowing you to see `std` symbols when debugging.][82218]
728
729 Internal Only
730 -------------
731 These changes provide no direct user facing benefits, but represent significant
732 improvements to the internals and overall performance of rustc and
733 related tools.
734
735 - [Check the result cache before the DepGraph when ensuring queries][81855]
736 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
737 - [Only store a LocalDefId in some HIR nodes][81611]
738 - [Store HIR attributes in a side table][79519]
739
740 Compatibility Notes
741 -------------------
742 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
743 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
744 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
745 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
746   languages in code blocks.][78429]
747 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
748 - [Changes in how proc macros handle whitespace may lead to panics when used
749   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
750 - [Turn `#[derive]` into a regular macro attribute][79078]
751
752 [84136]: https://github.com/rust-lang/rust/issues/84136
753 [80763]: https://github.com/rust-lang/rust/pull/80763
754 [82166]: https://github.com/rust-lang/rust/pull/82166
755 [82121]: https://github.com/rust-lang/rust/pull/82121
756 [81879]: https://github.com/rust-lang/rust/pull/81879
757 [82261]: https://github.com/rust-lang/rust/pull/82261
758 [82218]: https://github.com/rust-lang/rust/pull/82218
759 [82216]: https://github.com/rust-lang/rust/pull/82216
760 [82202]: https://github.com/rust-lang/rust/pull/82202
761 [81855]: https://github.com/rust-lang/rust/pull/81855
762 [81766]: https://github.com/rust-lang/rust/pull/81766
763 [81744]: https://github.com/rust-lang/rust/pull/81744
764 [81611]: https://github.com/rust-lang/rust/pull/81611
765 [81479]: https://github.com/rust-lang/rust/pull/81479
766 [81451]: https://github.com/rust-lang/rust/pull/81451
767 [81356]: https://github.com/rust-lang/rust/pull/81356
768 [80962]: https://github.com/rust-lang/rust/pull/80962
769 [80553]: https://github.com/rust-lang/rust/pull/80553
770 [80527]: https://github.com/rust-lang/rust/pull/80527
771 [79519]: https://github.com/rust-lang/rust/pull/79519
772 [79423]: https://github.com/rust-lang/rust/pull/79423
773 [79208]: https://github.com/rust-lang/rust/pull/79208
774 [78429]: https://github.com/rust-lang/rust/pull/78429
775 [82733]: https://github.com/rust-lang/rust/pull/82733
776 [82594]: https://github.com/rust-lang/rust/pull/82594
777 [79078]: https://github.com/rust-lang/rust/pull/79078
778 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
779 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
780 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
781 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
782 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
783 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
784 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
785 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
786 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
787 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
788 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
789 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
790 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
791 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
792 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
793 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
794 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
795 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
796 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
797 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
798 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
799 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
800
801 Version 1.51.0 (2021-03-25)
802 ============================
803
804 Language
805 --------
806 - [You can now parameterize items such as functions, traits, and `struct`s by constant
807   values in addition to by types and lifetimes.][79135] Also known as "const generics"
808   E.g. you can now write the following. Note: Only values of primitive integers,
809   `bool`, or `char` types are currently permitted.
810   ```rust
811   struct GenericArray<T, const LENGTH: usize> {
812       inner: [T; LENGTH]
813   }
814
815   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
816       const fn last(&self) -> Option<&T> {
817           if LENGTH == 0 {
818               None
819           } else {
820               Some(&self.inner[LENGTH - 1])
821           }
822       }
823   }
824   ```
825
826
827 Compiler
828 --------
829
830 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
831   This option controls whether debug information is split across multiple files
832   or packed into a single file. **Note** This option is unstable on other platforms.
833 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
834   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
835 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
836 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
837
838 \* Refer to Rust's [platform support page][platform-support-doc] for more
839 information on Rust's tiered platform support.
840
841 Libraries
842 ---------
843
844 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
845 - [`str` now implements `AsMut<str>`.][80279]
846 - [`u64` and `u128` now implement `From<char>`.][79502]
847 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
848 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
849 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
850 - [`io::Empty` now implements `io::Seek`.][78044]
851 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
852   `T: ?Sized` types.][80764]
853 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
854
855
856 Stabilized APIs
857 ---------------
858
859 - [`Arc::decrement_strong_count`]
860 - [`Arc::increment_strong_count`]
861 - [`Once::call_once_force`]
862 - [`Peekable::next_if_eq`]
863 - [`Peekable::next_if`]
864 - [`Seek::stream_position`]
865 - [`array::IntoIter`]
866 - [`panic::panic_any`]
867 - [`ptr::addr_of!`]
868 - [`ptr::addr_of_mut!`]
869 - [`slice::fill_with`]
870 - [`slice::split_inclusive_mut`]
871 - [`slice::split_inclusive`]
872 - [`slice::strip_prefix`]
873 - [`slice::strip_suffix`]
874 - [`str::split_inclusive`]
875 - [`sync::OnceState`]
876 - [`task::Wake`]
877 - [`VecDeque::range`]
878 - [`VecDeque::range_mut`]
879
880 Cargo
881 -----
882 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
883   codegen option.][cargo/9112]
884 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
885   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
886   to avoid unifying features of dependencies where that unification could be unwanted.
887   Such as using the same dependency with a `std` feature in a build scripts and
888   proc-macros, while using the `no-std` feature in the final binary. See the
889   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
890
891 Rustdoc
892 -------
893
894 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
895 - [You can now provide a `--default-theme` flag which sets the default theme to use for
896   documentation.][79642]
897
898 Various improvements to intra-doc links:
899
900 - [You can link to non-path primitives such as `slice`.][80181]
901 - [You can link to associated items.][74489]
902 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
903
904 Misc
905 ----
906 - [You can now pass `--include-ignored` to tests (e.g. with
907   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
908
909 Compatibility Notes
910 -------------------
911
912 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
913 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
914   could fail.][80579]
915 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
916   for the distributed artifacts.][81521]
917     - `armv5te-unknown-linux-gnueabi`
918     - `sparc64-unknown-linux-gnu`
919     - `thumbv7neon-unknown-linux-gnueabihf`
920     - `armv7-unknown-linux-gnueabi`
921     - `x86_64-unknown-linux-gnux32`
922 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
923
924 Internal Only
925 -------------
926
927 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
928
929 [79135]: https://github.com/rust-lang/rust/pull/79135
930 [74489]: https://github.com/rust-lang/rust/pull/74489
931 [76934]: https://github.com/rust-lang/rust/pull/76934
932 [79570]: https://github.com/rust-lang/rust/pull/79570
933 [80181]: https://github.com/rust-lang/rust/pull/80181
934 [79642]: https://github.com/rust-lang/rust/pull/79642
935 [80945]: https://github.com/rust-lang/rust/pull/80945
936 [80279]: https://github.com/rust-lang/rust/pull/80279
937 [80053]: https://github.com/rust-lang/rust/pull/80053
938 [79502]: https://github.com/rust-lang/rust/pull/79502
939 [75180]: https://github.com/rust-lang/rust/pull/75180
940 [79135]: https://github.com/rust-lang/rust/pull/79135
941 [81521]: https://github.com/rust-lang/rust/pull/81521
942 [80968]: https://github.com/rust-lang/rust/pull/80968
943 [80959]: https://github.com/rust-lang/rust/pull/80959
944 [80718]: https://github.com/rust-lang/rust/pull/80718
945 [80653]: https://github.com/rust-lang/rust/pull/80653
946 [80579]: https://github.com/rust-lang/rust/pull/80579
947 [79998]: https://github.com/rust-lang/rust/pull/79998
948 [78044]: https://github.com/rust-lang/rust/pull/78044
949 [81455]: https://github.com/rust-lang/rust/pull/81455
950 [80764]: https://github.com/rust-lang/rust/pull/80764
951 [80749]: https://github.com/rust-lang/rust/pull/80749
952 [80662]: https://github.com/rust-lang/rust/pull/80662
953 [79134]: https://github.com/rust-lang/rust/pull/79134
954 [80966]: https://github.com/rust-lang/rust/pull/80966
955 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
956 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
957 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
958 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
959 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
960 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
961 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
962 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
963 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
964 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
965 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
966 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
967 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
968 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
969 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
970 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
971 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
972 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
973 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
974 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
975 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
976 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
977 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
978
979 Version 1.50.0 (2021-02-11)
980 ============================
981
982 Language
983 -----------------------
984 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
985   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
986 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
987
988 Compiler
989 -----------------------
990 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
991 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
992 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
993 - [Dropped support for all cloudabi targets.][78439]
994
995 \* Refer to Rust's [platform support page][platform-support-doc] for more
996 information on Rust's tiered platform support.
997
998 Libraries
999 -----------------------
1000
1001 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1002 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1003 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1004   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1005   up the same amount of space as `File`.
1006
1007 Stabilized APIs
1008 ---------------
1009
1010 - [`bool::then`]
1011 - [`btree_map::Entry::or_insert_with_key`]
1012 - [`f32::clamp`]
1013 - [`f64::clamp`]
1014 - [`hash_map::Entry::or_insert_with_key`]
1015 - [`Ord::clamp`]
1016 - [`RefCell::take`]
1017 - [`slice::fill`]
1018 - [`UnsafeCell::get_mut`]
1019
1020 The following previously stable methods are now `const`.
1021
1022 - [`IpAddr::is_ipv4`]
1023 - [`IpAddr::is_ipv6`]
1024 - [`IpAddr::is_unspecified`]
1025 - [`IpAddr::is_loopback`]
1026 - [`IpAddr::is_multicast`]
1027 - [`Ipv4Addr::octets`]
1028 - [`Ipv4Addr::is_loopback`]
1029 - [`Ipv4Addr::is_private`]
1030 - [`Ipv4Addr::is_link_local`]
1031 - [`Ipv4Addr::is_multicast`]
1032 - [`Ipv4Addr::is_broadcast`]
1033 - [`Ipv4Addr::is_documentation`]
1034 - [`Ipv4Addr::to_ipv6_compatible`]
1035 - [`Ipv4Addr::to_ipv6_mapped`]
1036 - [`Ipv6Addr::segments`]
1037 - [`Ipv6Addr::is_unspecified`]
1038 - [`Ipv6Addr::is_loopback`]
1039 - [`Ipv6Addr::is_multicast`]
1040 - [`Ipv6Addr::to_ipv4`]
1041 - [`Layout::size`]
1042 - [`Layout::align`]
1043 - [`Layout::from_size_align`]
1044 - `pow` for all integer types.
1045 - `checked_pow` for all integer types.
1046 - `saturating_pow` for all integer types.
1047 - `wrapping_pow` for all integer types.
1048 - `next_power_of_two` for all unsigned integer types.
1049 - `checked_next_power_of_two` for all unsigned integer types.
1050
1051 Cargo
1052 -----------------------
1053
1054 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1055   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1056 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1057   contents of that directory for changes.][cargo/8973]
1058 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1059
1060 Misc
1061 ----
1062
1063 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1064 - [Running tests will now print the total time taken to execute.][75752]
1065
1066 Compatibility Notes
1067 -------------------
1068
1069 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1070   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1071 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1072   unhygenic `macro_rules!` macros.][79472]
1073 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1074   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1075 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1076 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1077   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1078 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1079
1080 [74989]: https://github.com/rust-lang/rust/pull/74989
1081 [79261]: https://github.com/rust-lang/rust/pull/79261
1082 [79896]: https://github.com/rust-lang/rust/pull/79896
1083 [79484]: https://github.com/rust-lang/rust/pull/79484
1084 [79472]: https://github.com/rust-lang/rust/pull/79472
1085 [79270]: https://github.com/rust-lang/rust/pull/79270
1086 [79003]: https://github.com/rust-lang/rust/pull/79003
1087 [78864]: https://github.com/rust-lang/rust/pull/78864
1088 [78636]: https://github.com/rust-lang/rust/pull/78636
1089 [78439]: https://github.com/rust-lang/rust/pull/78439
1090 [78343]: https://github.com/rust-lang/rust/pull/78343
1091 [78296]: https://github.com/rust-lang/rust/pull/78296
1092 [78068]: https://github.com/rust-lang/rust/pull/78068
1093 [75752]: https://github.com/rust-lang/rust/pull/75752
1094 [74699]: https://github.com/rust-lang/rust/pull/74699
1095 [78142]: https://github.com/rust-lang/rust/pull/78142
1096 [77484]: https://github.com/rust-lang/rust/pull/77484
1097 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1098 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1099 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1100 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1101 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1102 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1103 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1104 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1105 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1106 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1107 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1108 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1109 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1110 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1111 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1112 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1113 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1114 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1115 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1116 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1117 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1118 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1119 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1120 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1121 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1122 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1123 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1124 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1125 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1126 [`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
1127 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1128 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1129 [`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
1130 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1131
1132
1133 Version 1.49.0 (2020-12-31)
1134 ============================
1135
1136 Language
1137 -----------------------
1138
1139 - [Unions can now implement `Drop`, and you can now have a field in a union
1140   with `ManuallyDrop<T>`.][77547]
1141 - [You can now cast uninhabited enums to integers.][76199]
1142 - [You can now bind by reference and by move in patterns.][76119] This
1143   allows you to selectively borrow individual components of a type. E.g.
1144   ```rust
1145   #[derive(Debug)]
1146   struct Person {
1147       name: String,
1148       age: u8,
1149   }
1150
1151   let person = Person {
1152       name: String::from("Alice"),
1153       age: 20,
1154   };
1155
1156   // `name` is moved out of person, but `age` is referenced.
1157   let Person { name, ref age } = person;
1158   println!("{} {}", name, age);
1159   ```
1160
1161 Compiler
1162 -----------------------
1163
1164 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1165 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1166 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1167 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1168 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1169 - [Output from threads spawned in tests is now captured.][78227]
1170 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1171
1172 \* Refer to Rust's [platform support page][platform-support-doc] for more
1173 information on Rust's tiered platform support.
1174
1175 Libraries
1176 -----------------------
1177
1178 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1179 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1180
1181 Stabilized APIs
1182 ---------------
1183
1184 - [`slice::select_nth_unstable`]
1185 - [`slice::select_nth_unstable_by`]
1186 - [`slice::select_nth_unstable_by_key`]
1187
1188 The following previously stable methods are now `const`.
1189
1190 - [`Poll::is_ready`]
1191 - [`Poll::is_pending`]
1192
1193 Cargo
1194 -----------------------
1195 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1196 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1197 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1198   variable will be set if the crate being built is one the user selected to build, either
1199   with `-p` or through defaults.
1200 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1201
1202
1203 Compatibility Notes
1204 -------------------
1205
1206 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1207 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1208 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1209   Previously such invalid or unused attributes could be ignored.
1210 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1211   read [this post about the changes][rustdoc-ws-post] for more details.
1212 - [Trait bounds are no longer inferred for associated types.][79904]
1213
1214 Internal Only
1215 -------------
1216 These changes provide no direct user facing benefits, but represent significant
1217 improvements to the internals and overall performance of rustc and
1218 related tools.
1219
1220 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1221   Local Storage model.][78201]
1222 - [Calculate visibilities once in resolve.][78077]
1223 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1224 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1225
1226
1227 [75991]: https://github.com/rust-lang/rust/pull/75991
1228 [78951]: https://github.com/rust-lang/rust/pull/78951
1229 [78848]: https://github.com/rust-lang/rust/pull/78848
1230 [78746]: https://github.com/rust-lang/rust/pull/78746
1231 [78376]: https://github.com/rust-lang/rust/pull/78376
1232 [78228]: https://github.com/rust-lang/rust/pull/78228
1233 [78227]: https://github.com/rust-lang/rust/pull/78227
1234 [78201]: https://github.com/rust-lang/rust/pull/78201
1235 [78109]: https://github.com/rust-lang/rust/pull/78109
1236 [78077]: https://github.com/rust-lang/rust/pull/78077
1237 [77997]: https://github.com/rust-lang/rust/pull/77997
1238 [77703]: https://github.com/rust-lang/rust/pull/77703
1239 [77547]: https://github.com/rust-lang/rust/pull/77547
1240 [77015]: https://github.com/rust-lang/rust/pull/77015
1241 [76199]: https://github.com/rust-lang/rust/pull/76199
1242 [76119]: https://github.com/rust-lang/rust/pull/76119
1243 [75914]: https://github.com/rust-lang/rust/pull/75914
1244 [79004]: https://github.com/rust-lang/rust/pull/79004
1245 [78676]: https://github.com/rust-lang/rust/pull/78676
1246 [79904]: https://github.com/rust-lang/rust/issues/79904
1247 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1248 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1249 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1250 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1251 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1252 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1253 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1254 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1255 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1256 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1257 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1258
1259 Version 1.48.0 (2020-11-19)
1260 ==========================
1261
1262 Language
1263 --------
1264
1265 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1266   is still rejected *semantically*, but can now be parsed by procedural macros.
1267
1268 Compiler
1269 --------
1270 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1271   `rustc` whether to link its own C runtime and libraries or to rely on a external
1272   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1273 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1274   Note: If you're using cargo you must explicitly pass the `--target` flag.
1275 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1276
1277 \* Refer to Rust's [platform support page][platform-support-doc] for more
1278 information on Rust's tiered platform support.
1279
1280 Libraries
1281 ---------
1282 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1283   and `&Stderr`.][76275]
1284 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1285 - [The `matches!` macro now supports having a trailing comma.][74880]
1286 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1287 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1288
1289 Stabilized APIs
1290 ---------------
1291 - [`slice::as_ptr_range`]
1292 - [`slice::as_mut_ptr_range`]
1293 - [`VecDeque::make_contiguous`]
1294 - [`future::pending`]
1295 - [`future::ready`]
1296
1297 The following previously stable methods are now `const fn`'s:
1298
1299 - [`Option::is_some`]
1300 - [`Option::is_none`]
1301 - [`Option::as_ref`]
1302 - [`Result::is_ok`]
1303 - [`Result::is_err`]
1304 - [`Result::as_ref`]
1305 - [`Ordering::reverse`]
1306 - [`Ordering::then`]
1307
1308 Cargo
1309 -----
1310
1311 Rustdoc
1312 -------
1313 - [You can now link to items in `rustdoc` using the intra-doc link
1314   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1315   a link to `std::future`'s documentation. See ["Linking to items by
1316   name"][intradoc-links] for more information.
1317 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1318   when searching through `rustdoc`'s UI.][75740]
1319
1320 Compatibility Notes
1321 -------------------
1322 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1323   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1324   promoted to `'static` lifetime any more inside `const fn`s.
1325 - [Associated type bindings on trait objects are now verified to meet the bounds
1326   declared on the trait when checking that they implement the trait.][27675]
1327 - [When trait bounds on associated types or opaque types are ambiguous, the
1328   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1329 - [Fixed recursive nonterminals not being expanded in macros during
1330   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1331   correctly handling recursive nonterminal tokens.
1332 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1333 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1334   in places where they have no effect.][73461]
1335 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1336   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1337 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1338   disallow zero-initialization.][71274]
1339 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1340 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1341   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1342   see the [`catch_unwind`] documentation for further information.
1343
1344
1345
1346 Internal Only
1347 -------------
1348 These changes provide no direct user facing benefits, but represent significant
1349 improvements to the internals and overall performance of rustc and
1350 related tools.
1351
1352 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1353   You can continue building with `make` by setting `ninja=false` in
1354   your `config.toml`.
1355 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1356 - [Made `ensure_sufficient_stack()` non-generic][76680]
1357
1358 [78143]: https://github.com/rust-lang/rust/issues/78143
1359 [76680]: https://github.com/rust-lang/rust/pull/76680/
1360 [76030]: https://github.com/rust-lang/rust/pull/76030/
1361 [70212]: https://github.com/rust-lang/rust/pull/70212/
1362 [27675]: https://github.com/rust-lang/rust/issues/27675/
1363 [54121]: https://github.com/rust-lang/rust/issues/54121/
1364 [71274]: https://github.com/rust-lang/rust/pull/71274/
1365 [77386]: https://github.com/rust-lang/rust/pull/77386/
1366 [77153]: https://github.com/rust-lang/rust/pull/77153/
1367 [77055]: https://github.com/rust-lang/rust/pull/77055/
1368 [76275]: https://github.com/rust-lang/rust/pull/76275/
1369 [76310]: https://github.com/rust-lang/rust/pull/76310/
1370 [76420]: https://github.com/rust-lang/rust/pull/76420/
1371 [76158]: https://github.com/rust-lang/rust/pull/76158/
1372 [75857]: https://github.com/rust-lang/rust/pull/75857/
1373 [75585]: https://github.com/rust-lang/rust/pull/75585/
1374 [75740]: https://github.com/rust-lang/rust/pull/75740/
1375 [75502]: https://github.com/rust-lang/rust/pull/75502/
1376 [74880]: https://github.com/rust-lang/rust/pull/74880/
1377 [74922]: https://github.com/rust-lang/rust/pull/74922/
1378 [74430]: https://github.com/rust-lang/rust/pull/74430/
1379 [74194]: https://github.com/rust-lang/rust/pull/74194/
1380 [73461]: https://github.com/rust-lang/rust/pull/73461/
1381 [73166]: https://github.com/rust-lang/rust/pull/73166/
1382 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1383 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1384 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1385 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1386 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1387 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1388 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1389 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1390 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1391 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1392 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1393 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1394 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1395 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1396 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1397
1398
1399 Version 1.47.0 (2020-10-08)
1400 ==========================
1401
1402 Language
1403 --------
1404 - [Closures will now warn when not used.][74869]
1405
1406 Compiler
1407 --------
1408 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1409   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1410   platforms.
1411 - [Upgraded to LLVM 11.][73526]
1412 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1413 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1414 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1415
1416 \* Refer to Rust's [platform support page][platform-support-doc] for more
1417 information on Rust's tiered platform support.
1418
1419 Libraries
1420 ---------
1421 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1422 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1423   those of length less than 33.][74060]
1424 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1425 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1426   `PartialEq`, and `PartialOrd`.][73583]
1427
1428 Stabilized APIs
1429 ---------------
1430 - [`Ident::new_raw`]
1431 - [`Range::is_empty`]
1432 - [`RangeInclusive::is_empty`]
1433 - [`Result::as_deref`]
1434 - [`Result::as_deref_mut`]
1435 - [`Vec::leak`]
1436 - [`pointer::offset_from`]
1437 - [`f32::TAU`]
1438 - [`f64::TAU`]
1439
1440 The following previously stable APIs have now been made const.
1441
1442 - [The `new` method for all `NonZero` integers.][73858]
1443 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1444   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1445   methods for all integers.][73858]
1446 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1447   signed integers.][73858]
1448 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1449   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1450   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1451   `is_ascii_control` methods for `char` and `u8`.][73858]
1452
1453 Cargo
1454 -----
1455 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1456   You can override this by setting the following in your `Cargo.toml`.
1457   ```toml
1458   [profile.release.build-override]
1459   opt-level = 3
1460   ```
1461 - [`cargo-help` will now display man pages for commands rather just the
1462   `--help` text.][cargo/8456]
1463 - [`cargo-metadata` now emits a `test` field indicating if a target has
1464   tests enabled.][cargo/8478]
1465 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1466 - [`cargo-publish` will now use an alternative registry by default if it's the
1467   only registry specified in `package.publish`.][cargo/8571]
1468
1469 Misc
1470 ----
1471 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1472   type based search.][75366]
1473 - [Added the Ayu theme to rustdoc.][71237]
1474
1475 Compatibility Notes
1476 -------------------
1477 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1478 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1479 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1480   help to preserve more span information.][73084] These changes may cause
1481   compiliation errors if your macro was unhygenic or didn't correctly handle
1482   `Delimiter::None`.
1483 - [Moved support for the CloudABI target to tier 3.][75568]
1484 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1485 - [Added the `rustc-docs` component.][75560] This allows you to install
1486   and read the documentation for the compiler internal APIs. (Currently only
1487   available for `x86_64-unknown-linux-gnu`.)
1488
1489 Internal Only
1490 --------
1491
1492 - [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.
1493
1494 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1495 [75048]: https://github.com/rust-lang/rust/pull/75048/
1496 [74163]: https://github.com/rust-lang/rust/pull/74163/
1497 [71237]: https://github.com/rust-lang/rust/pull/71237/
1498 [74869]: https://github.com/rust-lang/rust/pull/74869/
1499 [73858]: https://github.com/rust-lang/rust/pull/73858/
1500 [75716]: https://github.com/rust-lang/rust/pull/75716/
1501 [75908]: https://github.com/rust-lang/rust/pull/75908/
1502 [75516]: https://github.com/rust-lang/rust/pull/75516/
1503 [75560]: https://github.com/rust-lang/rust/pull/75560/
1504 [75568]: https://github.com/rust-lang/rust/pull/75568/
1505 [75366]: https://github.com/rust-lang/rust/pull/75366/
1506 [75204]: https://github.com/rust-lang/rust/pull/75204/
1507 [74650]: https://github.com/rust-lang/rust/pull/74650/
1508 [74419]: https://github.com/rust-lang/rust/pull/74419/
1509 [73964]: https://github.com/rust-lang/rust/pull/73964/
1510 [74021]: https://github.com/rust-lang/rust/pull/74021/
1511 [74060]: https://github.com/rust-lang/rust/pull/74060/
1512 [73893]: https://github.com/rust-lang/rust/pull/73893/
1513 [73526]: https://github.com/rust-lang/rust/pull/73526/
1514 [73583]: https://github.com/rust-lang/rust/pull/73583/
1515 [73084]: https://github.com/rust-lang/rust/pull/73084/
1516 [73197]: https://github.com/rust-lang/rust/pull/73197/
1517 [72488]: https://github.com/rust-lang/rust/pull/72488/
1518 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1519 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1520 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1521 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1522 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1523 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1524 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1525 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1526 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1527 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1528 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1529 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1530 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1531 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1532 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1533
1534
1535 Version 1.46.0 (2020-08-27)
1536 ==========================
1537
1538 Language
1539 --------
1540 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1541 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1542   const functions.][73862]
1543 - [The `#[track_caller]` attribute can now be added to functions to use the
1544   function's caller's location information for panic messages.][72445]
1545 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1546   `x.0.0` over `(x.0).0`.
1547 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1548   You currently can't use `mem::transmute` in constant functions.
1549
1550 Compiler
1551 --------
1552 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1553 - [Enabled static "Position Independent Executables" by default
1554   for `x86_64-unknown-linux-musl`.][70740]
1555
1556 Libraries
1557 ---------
1558 - [`mem::forget` is now a `const fn`.][73887]
1559 - [`String` now implements `From<char>`.][73466]
1560 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1561   integer types.][73032]
1562 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1563 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1564   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1565 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1566 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1567 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1568
1569 Stabilized APIs
1570 ---------------
1571 - [`Option::zip`]
1572 - [`vec::Drain::as_slice`]
1573
1574 Cargo
1575 -----
1576 Added a number of new environment variables that are now available when
1577 compiling your crate.
1578
1579 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1580   the specific binary being compiled and the name of the crate.
1581 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1582 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1583
1584 Compatibility Notes
1585 -------------------
1586 - [The target configuration option `abi_blacklist` has been renamed
1587   to `unsupported_abis`.][74150] The old name will still continue to work.
1588 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1589   This was previously accepted but will become a hard error in a future release.
1590 - [Rustc will fail to compile if you have a struct with
1591   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1592   allowed on `enum`s.
1593 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1594   ensure that spans have the correct information, and may cause breakage if you
1595   were relying on receiving spans with dummy information.
1596 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1597   a legacy installer that was replaced by a MSI installer a few years ago but
1598   was still being built.
1599 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1600 - [Rustc will no longer accept overlapping trait implementations that only
1601   differ in how the lifetime was bound.][72493]
1602 - [Rustc now correctly relates the lifetime of an existential associated
1603   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1604   you to pass a shorter lifetime than expected.
1605 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1606   The library will need to be installed for `rustc` to work, even though we
1607   expect it to be already available on most systems.
1608 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1609   under QEMU.][74820]
1610 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1611   exact output returned by rustc's pretty printing is an unstable
1612   implementation detail: we recommend any macro relying on it to switch to a
1613   more robust parsing system.
1614
1615 [75453]: https://github.com/rust-lang/rust/issues/75453/
1616 [74820]: https://github.com/rust-lang/rust/issues/74820/
1617 [74420]: https://github.com/rust-lang/rust/issues/74420/
1618 [74109]: https://github.com/rust-lang/rust/pull/74109/
1619 [74150]: https://github.com/rust-lang/rust/pull/74150/
1620 [73862]: https://github.com/rust-lang/rust/pull/73862/
1621 [73887]: https://github.com/rust-lang/rust/pull/73887/
1622 [73466]: https://github.com/rust-lang/rust/pull/73466/
1623 [73516]: https://github.com/rust-lang/rust/pull/73516/
1624 [73293]: https://github.com/rust-lang/rust/pull/73293/
1625 [73007]: https://github.com/rust-lang/rust/pull/73007/
1626 [73032]: https://github.com/rust-lang/rust/pull/73032/
1627 [72920]: https://github.com/rust-lang/rust/pull/72920/
1628 [72569]: https://github.com/rust-lang/rust/pull/72569/
1629 [72583]: https://github.com/rust-lang/rust/pull/72583/
1630 [72584]: https://github.com/rust-lang/rust/pull/72584/
1631 [72717]: https://github.com/rust-lang/rust/pull/72717/
1632 [72437]: https://github.com/rust-lang/rust/pull/72437/
1633 [72445]: https://github.com/rust-lang/rust/pull/72445/
1634 [72486]: https://github.com/rust-lang/rust/pull/72486/
1635 [72493]: https://github.com/rust-lang/rust/pull/72493/
1636 [72331]: https://github.com/rust-lang/rust/pull/72331/
1637 [71896]: https://github.com/rust-lang/rust/pull/71896/
1638 [71660]: https://github.com/rust-lang/rust/pull/71660/
1639 [71322]: https://github.com/rust-lang/rust/pull/71322/
1640 [70740]: https://github.com/rust-lang/rust/pull/70740/
1641 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1642 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1643 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1644 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1645 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1646
1647
1648 Version 1.45.2 (2020-08-03)
1649 ==========================
1650
1651 * [Fix bindings in tuple struct patterns][74954]
1652 * [Fix track_caller integration with trait objects][74784]
1653
1654 [74954]: https://github.com/rust-lang/rust/issues/74954
1655 [74784]: https://github.com/rust-lang/rust/issues/74784
1656
1657
1658 Version 1.45.1 (2020-07-30)
1659 ==========================
1660
1661 * [Fix const propagation with references.][73613]
1662 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1663 * [Avoid spurious implicit region bound.][74509]
1664 * [Install clippy on x.py install][74457]
1665
1666 [73613]: https://github.com/rust-lang/rust/pull/73613
1667 [73078]: https://github.com/rust-lang/rust/issues/73078
1668 [74509]: https://github.com/rust-lang/rust/pull/74509
1669 [74457]: https://github.com/rust-lang/rust/pull/74457
1670
1671
1672 Version 1.45.0 (2020-07-16)
1673 ==========================
1674
1675 Language
1676 --------
1677 - [Out of range float to int conversions using `as` has been defined as a saturating
1678   conversion.][71269] This was previously undefined behaviour, but you can use the
1679    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1680    may be desirable in rare performance sensitive situations.
1681 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1682   using `u64`.][70705]
1683 - [Function like procedural macros can now be used in expression, pattern, and  statement
1684   positions.][68717] This means you can now use a function-like procedural macro
1685   anywhere you can use a declarative (`macro_rules!`) macro.
1686
1687 Compiler
1688 --------
1689 - [You can now override individual target features through the `target-feature`
1690   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1691   equivalent to `-C target-feature=+avx2,+fma`.
1692 - [Added the `force-unwind-tables` flag.][69984] This option allows
1693   rustc to always generate unwind tables regardless of panic strategy.
1694 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1695   to include LLVM bitcode into generated `rlib`s (this is on by default).
1696 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1697 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1698 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1699 - [Upgraded to LLVM 10.][67759]
1700
1701 \* Refer to Rust's [platform support page][platform-support-doc] for more
1702 information on Rust's tiered platform support.
1703
1704
1705 Libraries
1706 ---------
1707 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1708   and `Ord`.][72239]
1709 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1710 - [You can now use `char` with
1711   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1712   a range of codepoints.][72413] E.g.
1713   you can now write the following;
1714   ```rust
1715   for ch in 'a'..='z' {
1716       print!("{}", ch);
1717   }
1718   println!();
1719   // Prints "abcdefghijklmnopqrstuvwxyz"
1720   ```
1721 - [`OsString` now implements `FromStr`.][71662]
1722 - [The `saturating_neg` method has been added to all signed integer primitive
1723   types, and the `saturating_abs` method has been added for all integer
1724   primitive types.][71886]
1725 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1726   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1727   or `Path`.][71447]
1728 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1729 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1730   integer types.][69813]
1731 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1732   integer types.][72324]
1733 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1734
1735 Stabilized APIs
1736 ---------------
1737 - [`Arc::as_ptr`]
1738 - [`BTreeMap::remove_entry`]
1739 - [`Rc::as_ptr`]
1740 - [`rc::Weak::as_ptr`]
1741 - [`rc::Weak::from_raw`]
1742 - [`rc::Weak::into_raw`]
1743 - [`str::strip_prefix`]
1744 - [`str::strip_suffix`]
1745 - [`sync::Weak::as_ptr`]
1746 - [`sync::Weak::from_raw`]
1747 - [`sync::Weak::into_raw`]
1748 - [`char::UNICODE_VERSION`]
1749 - [`Span::resolved_at`]
1750 - [`Span::located_at`]
1751 - [`Span::mixed_site`]
1752 - [`unix::process::CommandExt::arg0`]
1753
1754 Cargo
1755 -----
1756
1757 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1758   time.][cargo/8066]
1759
1760 Misc
1761 ----
1762 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1763   `~~outdated information~~` becomes "~~outdated information~~".
1764 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1765
1766 Compatibility Notes
1767 -------------------
1768 - [Trying to self initialize a static value (that is creating a value using
1769   itself) is unsound and now causes a compile error.][71140]
1770 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1771   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1772 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1773   previously undocumented and not intended for public use. Rustdoc still provides
1774   a non-zero exit code on errors.
1775 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1776   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1777   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1778   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1779   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1780
1781 Internals Only
1782 --------------
1783 - [Make clippy a git subtree instead of a git submodule][70655]
1784 - [Unify the undo log of all snapshot types][69464]
1785
1786 [71848]: https://github.com/rust-lang/rust/issues/71848/
1787 [73420]: https://github.com/rust-lang/rust/issues/73420/
1788 [72324]: https://github.com/rust-lang/rust/pull/72324/
1789 [71843]: https://github.com/rust-lang/rust/pull/71843/
1790 [71886]: https://github.com/rust-lang/rust/pull/71886/
1791 [72234]: https://github.com/rust-lang/rust/pull/72234/
1792 [72239]: https://github.com/rust-lang/rust/pull/72239/
1793 [72397]: https://github.com/rust-lang/rust/pull/72397/
1794 [72413]: https://github.com/rust-lang/rust/pull/72413/
1795 [72014]: https://github.com/rust-lang/rust/pull/72014/
1796 [72062]: https://github.com/rust-lang/rust/pull/72062/
1797 [72094]: https://github.com/rust-lang/rust/pull/72094/
1798 [72133]: https://github.com/rust-lang/rust/pull/72133/
1799 [67759]: https://github.com/rust-lang/rust/pull/67759/
1800 [71900]: https://github.com/rust-lang/rust/pull/71900/
1801 [71928]: https://github.com/rust-lang/rust/pull/71928/
1802 [71662]: https://github.com/rust-lang/rust/pull/71662/
1803 [71716]: https://github.com/rust-lang/rust/pull/71716/
1804 [71447]: https://github.com/rust-lang/rust/pull/71447/
1805 [71269]: https://github.com/rust-lang/rust/pull/71269/
1806 [71095]: https://github.com/rust-lang/rust/pull/71095/
1807 [71140]: https://github.com/rust-lang/rust/pull/71140/
1808 [70655]: https://github.com/rust-lang/rust/pull/70655/
1809 [70705]: https://github.com/rust-lang/rust/pull/70705/
1810 [69984]: https://github.com/rust-lang/rust/pull/69984/
1811 [69813]: https://github.com/rust-lang/rust/pull/69813/
1812 [69464]: https://github.com/rust-lang/rust/pull/69464/
1813 [68717]: https://github.com/rust-lang/rust/pull/68717/
1814 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1815 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1816 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1817 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1818 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1819 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1820 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1821 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1822 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1823 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1824 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1825 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1826 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1827 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1828 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1829 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1830 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1831
1832
1833 Version 1.44.1 (2020-06-18)
1834 ===========================
1835
1836 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1837 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1838 * [Fix crashes when finding backtrace on macOS.][71397]
1839 * [Clippy applies lint levels into different files.][clippy/5356]
1840
1841 [71397]: https://github.com/rust-lang/rust/issues/71397
1842 [73078]: https://github.com/rust-lang/rust/issues/73078
1843 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1844 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1845
1846
1847 Version 1.44.0 (2020-06-04)
1848 ==========================
1849
1850 Language
1851 --------
1852 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1853 - [Added the `unused_braces` lint.][70081]
1854
1855 **Syntax-only changes**
1856
1857 - [Expansion-driven outline module parsing][69838]
1858 ```rust
1859 #[cfg(FALSE)]
1860 mod foo {
1861     mod bar {
1862         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1863     }
1864 }
1865 ```
1866
1867 These are still rejected semantically, so you will likely receive an error but
1868 these changes can be seen and parsed by macros and conditional compilation.
1869
1870 Compiler
1871 --------
1872 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1873   Additionally when in incremental mode rustc defaults to 256 codegen units.
1874 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1875   a panic is thrown.][67502]
1876 - [Added tier 3\* support for the `aarch64-unknown-none` and
1877   `aarch64-unknown-none-softfloat` targets.][68334]
1878 - [Added tier 3 support for `arm64-apple-tvos` and
1879   `x86_64-apple-tvos` targets.][68191]
1880
1881
1882 Libraries
1883 ---------
1884 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1885   `vec![]` to be able to be used in `const` contexts.
1886 - [`convert::Infallible` now implements `Hash`.][70281]
1887 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1888   a `&mut OsStr`.][70048]
1889 - [Unicode 13 is now supported.][69929]
1890 - [`String` now implements `From<&mut str>`.][69661]
1891 - [`IoSlice` now implements `Copy`.][69403]
1892 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1893 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1894 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1895   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1896   integer types.][69373]
1897
1898 Stabilized APIs
1899 ---------------
1900 - [`PathBuf::with_capacity`]
1901 - [`PathBuf::capacity`]
1902 - [`PathBuf::clear`]
1903 - [`PathBuf::reserve`]
1904 - [`PathBuf::reserve_exact`]
1905 - [`PathBuf::shrink_to_fit`]
1906 - [`f32::to_int_unchecked`]
1907 - [`f64::to_int_unchecked`]
1908 - [`Layout::align_to`]
1909 - [`Layout::pad_to_align`]
1910 - [`Layout::array`]
1911 - [`Layout::extend`]
1912
1913 Cargo
1914 -----
1915 - [Added the `cargo tree` command which will print a tree graph of
1916   your dependencies.][cargo/8062] E.g.
1917   ```
1918     mdbook v0.3.2 (/Users/src/rust/mdbook)
1919   ├── ammonia v3.0.0
1920   │   ├── html5ever v0.24.0
1921   │   │   ├── log v0.4.8
1922   │   │   │   └── cfg-if v0.1.9
1923   │   │   ├── mac v0.1.1
1924   │   │   └── markup5ever v0.9.0
1925   │   │       ├── log v0.4.8 (*)
1926   │   │       ├── phf v0.7.24
1927   │   │       │   └── phf_shared v0.7.24
1928   │   │       │       ├── siphasher v0.2.3
1929   │   │       │       └── unicase v1.4.2
1930   │   │       │           [build-dependencies]
1931   │   │       │           └── version_check v0.1.5
1932   ...
1933   ```
1934   You can also display dependencies on multiple versions of the same crate with
1935   `cargo tree -d` (short for `cargo tree --duplicates`).
1936
1937 Misc
1938 ----
1939 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1940   the version in the sidebar.][69494]
1941
1942 Compatibility Notes
1943 -------------------
1944 - [Rustc now correctly generates static libraries on Windows GNU targets with
1945   the `.a` extension, rather than the previous `.lib`.][70937]
1946 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1947 - [The `file_name` property in JSON output of macro errors now points the actual
1948   source file rather than the previous format of `<NAME macros>`.][70969]
1949   **Note:** this may not point to a file that actually exists on the user's system.
1950 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1951 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1952   not allow zero initialization such as `NonZeroU8`.][66059] This was
1953   previously a warning.
1954 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1955   operator has been defined as a saturating operation.][71269] This was previously
1956   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1957   continue using the current behaviour, which may be desirable in rare performance
1958   sensitive situations.
1959
1960 Internal Only
1961 -------------
1962 These changes provide no direct user facing benefits, but represent significant
1963 improvements to the internals and overall performance of rustc and
1964 related tools.
1965
1966 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1967 - [Replace big JS dict with JSON parsing.][71250]
1968
1969 [69373]: https://github.com/rust-lang/rust/pull/69373/
1970 [66059]: https://github.com/rust-lang/rust/pull/66059/
1971 [68191]: https://github.com/rust-lang/rust/pull/68191/
1972 [68899]: https://github.com/rust-lang/rust/pull/68899/
1973 [71147]: https://github.com/rust-lang/rust/pull/71147/
1974 [71250]: https://github.com/rust-lang/rust/pull/71250/
1975 [70937]: https://github.com/rust-lang/rust/pull/70937/
1976 [70969]: https://github.com/rust-lang/rust/pull/70969/
1977 [70632]: https://github.com/rust-lang/rust/pull/70632/
1978 [70281]: https://github.com/rust-lang/rust/pull/70281/
1979 [70345]: https://github.com/rust-lang/rust/pull/70345/
1980 [70048]: https://github.com/rust-lang/rust/pull/70048/
1981 [70081]: https://github.com/rust-lang/rust/pull/70081/
1982 [70156]: https://github.com/rust-lang/rust/pull/70156/
1983 [71269]: https://github.com/rust-lang/rust/pull/71269/
1984 [69838]: https://github.com/rust-lang/rust/pull/69838/
1985 [69929]: https://github.com/rust-lang/rust/pull/69929/
1986 [69661]: https://github.com/rust-lang/rust/pull/69661/
1987 [69778]: https://github.com/rust-lang/rust/pull/69778/
1988 [69494]: https://github.com/rust-lang/rust/pull/69494/
1989 [69403]: https://github.com/rust-lang/rust/pull/69403/
1990 [69033]: https://github.com/rust-lang/rust/pull/69033/
1991 [68692]: https://github.com/rust-lang/rust/pull/68692/
1992 [68334]: https://github.com/rust-lang/rust/pull/68334/
1993 [67502]: https://github.com/rust-lang/rust/pull/67502/
1994 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1995 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1996 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1997 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1998 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1999 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2000 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2001 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2002 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2003 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2004 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2005 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2006 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2007
2008
2009 Version 1.43.1 (2020-05-07)
2010 ===========================
2011
2012 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2013 * [Fixed the stabilization of AVX-512 features.][71473]
2014 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2015
2016 [71430]: https://github.com/rust-lang/rust/pull/71430
2017 [71473]: https://github.com/rust-lang/rust/issues/71473
2018 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2019
2020
2021 Version 1.43.0 (2020-04-23)
2022 ==========================
2023
2024 Language
2025 --------
2026 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2027   the type inferred correctly.][68129]
2028 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2029
2030 **Syntax only changes**
2031 - [Allow `type Foo: Ord` syntactically.][69361]
2032 - [Fuse associated and extern items up to defaultness.][69194]
2033 - [Syntactically allow `self` in all `fn` contexts.][68764]
2034 - [Merge `fn` syntax + cleanup item parsing.][68728]
2035 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2036   For example, you may now write:
2037   ```rust
2038   macro_rules! mac_trait {
2039       ($i:item) => {
2040           trait T { $i }
2041       }
2042   }
2043   mac_trait! {
2044       fn foo() {}
2045   }
2046   ```
2047
2048 These are still rejected *semantically*, so you will likely receive an error but
2049 these changes can be seen and parsed by macros and
2050 conditional compilation.
2051
2052
2053 Compiler
2054 --------
2055 - [You can now pass multiple lint flags to rustc to override the previous
2056   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2057   everything in the `unused` lint group except `unused-variables` which
2058   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2059   everything in the `unused` lint group **including** `unused-variables` since
2060   the allow flag is specified before the deny flag (and therefore overridden).
2061 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2062   if they are available on `windows-gnu`.][67429]
2063 - [rustc now buffers errors/warnings printed in JSON.][69227]
2064
2065 Libraries
2066 ---------
2067 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2068   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2069   respectively.][69538] **Note** These conversions are only available when `N`
2070   is `0..=32`.
2071 - [You can now use associated constants on floats and integers directly, rather
2072   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2073   `f32::NAN` with no imports.
2074 - [`u8::is_ascii` is now `const`.][68984]
2075 - [`String` now implements `AsMut<str>`.][68742]
2076 - [Added the `primitive` module to `std` and `core`.][67637] This module
2077   reexports Rust's primitive types. This is mainly useful in macros
2078   where you want avoid these types being shadowed.
2079 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2080 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2081
2082 Stabilized APIs
2083 ---------------
2084 - [`Once::is_completed`]
2085 - [`f32::LOG10_2`]
2086 - [`f32::LOG2_10`]
2087 - [`f64::LOG10_2`]
2088 - [`f64::LOG2_10`]
2089 - [`iter::once_with`]
2090
2091 Cargo
2092 -----
2093 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2094   your environment.][cargo/7823]
2095 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2096   executable path when running integration tests or benchmarks.][cargo/7697]
2097   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2098   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2099
2100 Misc
2101 ----
2102 - [Certain checks in the `const_err` lint were deemed unrelated to const
2103   evaluation][69185], and have been moved to the `unconditional_panic` and
2104   `arithmetic_overflow` lints.
2105
2106 Compatibility Notes
2107 -------------------
2108
2109 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2110   has been a warning since 1.36.0.
2111 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2112   led to some instances being accepted, and now correctly emits a hard error.
2113
2114 [69340]: https://github.com/rust-lang/rust/pull/69340
2115
2116 Internal Only
2117 -------------
2118 These changes provide no direct user facing benefits, but represent significant
2119 improvements to the internals and overall performance of `rustc` and
2120 related tools.
2121
2122 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2123 - [Improved how rustc generates drop code.][67332]
2124 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2125 - [traits: preallocate 2 Vecs of known initial size][69022]
2126 - [Avoid exponential behaviour when relating types][68772]
2127 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2128 - [Improve performance of coherence checks][68966]
2129 - [Deduplicate types in the generator witness][68672]
2130 - [Invert control in struct_lint_level.][68725]
2131
2132 [67332]: https://github.com/rust-lang/rust/pull/67332/
2133 [67429]: https://github.com/rust-lang/rust/pull/67429/
2134 [67637]: https://github.com/rust-lang/rust/pull/67637/
2135 [67642]: https://github.com/rust-lang/rust/pull/67642/
2136 [67878]: https://github.com/rust-lang/rust/pull/67878/
2137 [67885]: https://github.com/rust-lang/rust/pull/67885/
2138 [68129]: https://github.com/rust-lang/rust/pull/68129/
2139 [68672]: https://github.com/rust-lang/rust/pull/68672/
2140 [68725]: https://github.com/rust-lang/rust/pull/68725/
2141 [68728]: https://github.com/rust-lang/rust/pull/68728/
2142 [68738]: https://github.com/rust-lang/rust/pull/68738/
2143 [68742]: https://github.com/rust-lang/rust/pull/68742/
2144 [68764]: https://github.com/rust-lang/rust/pull/68764/
2145 [68772]: https://github.com/rust-lang/rust/pull/68772/
2146 [68943]: https://github.com/rust-lang/rust/pull/68943/
2147 [68952]: https://github.com/rust-lang/rust/pull/68952/
2148 [68966]: https://github.com/rust-lang/rust/pull/68966/
2149 [68984]: https://github.com/rust-lang/rust/pull/68984/
2150 [69022]: https://github.com/rust-lang/rust/pull/69022/
2151 [69185]: https://github.com/rust-lang/rust/pull/69185/
2152 [69194]: https://github.com/rust-lang/rust/pull/69194/
2153 [69201]: https://github.com/rust-lang/rust/pull/69201/
2154 [69227]: https://github.com/rust-lang/rust/pull/69227/
2155 [69548]: https://github.com/rust-lang/rust/pull/69548/
2156 [69256]: https://github.com/rust-lang/rust/pull/69256/
2157 [69361]: https://github.com/rust-lang/rust/pull/69361/
2158 [69366]: https://github.com/rust-lang/rust/pull/69366/
2159 [69538]: https://github.com/rust-lang/rust/pull/69538/
2160 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2161 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2162 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2163 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2164 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2165 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2166 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2167 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2168
2169
2170 Version 1.42.0 (2020-03-12)
2171 ==========================
2172
2173 Language
2174 --------
2175 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2176   ```rust
2177   fn foo(words: &[&str]) {
2178       match words {
2179           ["Hello", "World", "!", ..] => println!("Hello World!"),
2180           ["Foo", "Bar", ..] => println!("Baz"),
2181           rest => println!("{:?}", rest),
2182       }
2183   }
2184   ```
2185 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2186   that you can create an enum that has the exact layout and ABI of the type
2187   it contains.
2188 - [You can now use outer attribute procedural macros on inline modules.][64273]
2189 - [There are some *syntax-only* changes:][67131]
2190    - `default` is syntactically allowed before items in `trait` definitions.
2191    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2192      leave out their bodies in favor of `;`.
2193    - Bounds on associated types in `impl`s are now syntactically allowed
2194      (e.g. `type Foo: Ord;`).
2195    - `...` (the C-variadic type) may occur syntactically directly as the type of
2196       any function parameter.
2197
2198   These are still rejected *semantically*, so you will likely receive an error
2199   but these changes can be seen and parsed by procedural macros and
2200   conditional compilation.
2201
2202 Compiler
2203 --------
2204 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2205 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2206 - [`Option::{expect,unwrap}` and
2207    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2208    pointing to the location where they were called, rather than
2209    `core`'s internals. ][67887]
2210
2211 \* Refer to Rust's [platform support page][platform-support-doc] for more
2212 information on Rust's tiered platform support.
2213
2214 Libraries
2215 ---------
2216 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2217 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2218    to implement `Sized`.][67935]
2219 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2220 - [`Layout::new` is now `const`.][66254]
2221 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2222
2223
2224 Stabilized APIs
2225 ---------------
2226 - [`CondVar::wait_while`]
2227 - [`CondVar::wait_timeout_while`]
2228 - [`DebugMap::key`]
2229 - [`DebugMap::value`]
2230 - [`ManuallyDrop::take`]
2231 - [`matches!`]
2232 - [`ptr::slice_from_raw_parts_mut`]
2233 - [`ptr::slice_from_raw_parts`]
2234
2235 Cargo
2236 -----
2237 - [You no longer need to include `extern crate proc_macro;` to be able to
2238   `use proc_macro;` in the `2018` edition.][cargo/7700]
2239
2240 Compatibility Notes
2241 -------------------
2242 - [`Error::description` has been deprecated, and its use will now produce a
2243   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2244
2245 [68253]: https://github.com/rust-lang/rust/pull/68253/
2246 [68348]: https://github.com/rust-lang/rust/pull/68348/
2247 [67935]: https://github.com/rust-lang/rust/pull/67935/
2248 [68339]: https://github.com/rust-lang/rust/pull/68339/
2249 [68122]: https://github.com/rust-lang/rust/pull/68122/
2250 [64273]: https://github.com/rust-lang/rust/pull/64273/
2251 [67712]: https://github.com/rust-lang/rust/pull/67712/
2252 [67887]: https://github.com/rust-lang/rust/pull/67887/
2253 [67131]: https://github.com/rust-lang/rust/pull/67131/
2254 [67233]: https://github.com/rust-lang/rust/pull/67233/
2255 [66899]: https://github.com/rust-lang/rust/pull/66899/
2256 [66919]: https://github.com/rust-lang/rust/pull/66919/
2257 [66254]: https://github.com/rust-lang/rust/pull/66254/
2258 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2259 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2260 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2261 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2262 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2263 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2264 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2265 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2266 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2267
2268
2269 Version 1.41.1 (2020-02-27)
2270 ===========================
2271
2272 * [Always check types of static items][69145]
2273 * [Always check lifetime bounds of `Copy` impls][69145]
2274 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2275
2276 [69225]: https://github.com/rust-lang/rust/issues/69225
2277 [69145]: https://github.com/rust-lang/rust/pull/69145
2278
2279
2280 Version 1.41.0 (2020-01-30)
2281 ===========================
2282
2283 Language
2284 --------
2285
2286 - [You can now pass type parameters to foreign items when implementing
2287   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2288 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2289   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2290   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2291 - [You can now use any valid identifier in a `format_args` macro.][66847]
2292   Previously identifiers starting with an underscore were not allowed.
2293 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2294   enum variants.][66183] These are still rejected semantically, but
2295   can be seen and parsed by procedural macros and conditional compilation.
2296
2297 Compiler
2298 --------
2299
2300 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2301 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2302 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2303 - [You can now pass an arguments file passing the `@path` syntax
2304   to rustc.][66172] Note that the format differs somewhat from what is
2305   found in other tooling; please see [the documentation][argfile-docs] for
2306   more information.
2307 - [You can now provide `--extern` flag without a path, indicating that it is
2308   available from the search path or specified with an `-L` flag.][64882]
2309
2310 \* Refer to Rust's [platform support page][platform-support-doc] for more
2311 information on Rust's tiered platform support.
2312
2313 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2314
2315 Libraries
2316 ---------
2317
2318 - [The `core::panic` module is now stable.][66771] It was already stable
2319   through `std`.
2320 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2321   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2322 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2323
2324 Stabilized APIs
2325 ---------------
2326
2327 - [`Result::map_or`]
2328 - [`Result::map_or_else`]
2329 - [`std::rc::Weak::weak_count`]
2330 - [`std::rc::Weak::strong_count`]
2331 - [`std::sync::Weak::weak_count`]
2332 - [`std::sync::Weak::strong_count`]
2333
2334 Cargo
2335 -----
2336
2337 - [Cargo will now document all the private items for binary crates
2338   by default.][cargo/7593]
2339 - [`cargo-install` will now reinstall the package if it detects that it is out
2340   of date.][cargo/7560]
2341 - [Cargo.lock now uses a more git friendly format that should help to reduce
2342   merge conflicts.][cargo/7579]
2343 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2344   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2345   optimisation level to `2` for debug builds. You can also use
2346   `[profile.<profile>.build-override]` to override build scripts and
2347   their dependencies.
2348
2349 Misc
2350 ----
2351
2352 - [You can now specify `edition` in documentation code blocks to compile the block
2353   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2354   should be compiled the 2018 edition of Rust.
2355 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2356   current theme with `--check-theme`.][54733]
2357 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2358
2359 Compatibility Notes
2360 -------------------
2361
2362 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2363   Apple targets.][apple-32bit-drop] This means that the source code is still
2364   available to build, but the targets are no longer being tested and release
2365   binaries for those platforms will no longer be distributed by the Rust project.
2366   Please refer to the linked blog post for more information.
2367
2368 [54733]: https://github.com/rust-lang/rust/pull/54733/
2369 [61351]: https://github.com/rust-lang/rust/pull/61351/
2370 [67255]: https://github.com/rust-lang/rust/pull/67255/
2371 [66661]: https://github.com/rust-lang/rust/pull/66661/
2372 [66771]: https://github.com/rust-lang/rust/pull/66771/
2373 [66847]: https://github.com/rust-lang/rust/pull/66847/
2374 [66238]: https://github.com/rust-lang/rust/pull/66238/
2375 [66277]: https://github.com/rust-lang/rust/pull/66277/
2376 [66325]: https://github.com/rust-lang/rust/pull/66325/
2377 [66172]: https://github.com/rust-lang/rust/pull/66172/
2378 [66183]: https://github.com/rust-lang/rust/pull/66183/
2379 [65879]: https://github.com/rust-lang/rust/pull/65879/
2380 [65013]: https://github.com/rust-lang/rust/pull/65013/
2381 [64882]: https://github.com/rust-lang/rust/pull/64882/
2382 [64325]: https://github.com/rust-lang/rust/pull/64325/
2383 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2384 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2385 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2386 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2387 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2388 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2389 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2390 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2391 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2392 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2393 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2394
2395 Version 1.40.0 (2019-12-19)
2396 ===========================
2397
2398 Language
2399 --------
2400 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2401   `const` contexts.][65188] e.g.
2402
2403   ```rust
2404   pub struct Point(i32, i32);
2405
2406   const ORIGIN: Point = {
2407       let constructor = Point;
2408
2409       constructor(0, 0)
2410   };
2411   ```
2412
2413 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2414   indicate that there may be variants or fields added in the future.][64639]
2415   For example this requires adding a wild-card branch (`_ => {}`) to any match
2416   statements on a non-exhaustive `enum`. [(RFC 2008)]
2417 - [You can now use function-like procedural macros in `extern` blocks and in
2418   type positions.][63931] e.g. `type Generated = macro!();`
2419 - [Function-like and attribute procedural macros can now emit
2420   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2421 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2422   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2423   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2424
2425 Compiler
2426 --------
2427 - [Added tier 3 support\* for the
2428   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2429 - [Added tier 3 support for the
2430   `aarch64-unknown-none-softfloat` target.][64589]
2431 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2432   `mips64el-unknown-linux-muslabi64` targets.][65843]
2433
2434 \* Refer to Rust's [platform support page][platform-support-doc] for more
2435   information on Rust's tiered platform support.
2436
2437 Libraries
2438 ---------
2439 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2440
2441 Stabilized APIs
2442 ---------------
2443 - [`BTreeMap::get_key_value`]
2444 - [`HashMap::get_key_value`]
2445 - [`Option::as_deref_mut`]
2446 - [`Option::as_deref`]
2447 - [`Option::flatten`]
2448 - [`UdpSocket::peer_addr`]
2449 - [`f32::to_be_bytes`]
2450 - [`f32::to_le_bytes`]
2451 - [`f32::to_ne_bytes`]
2452 - [`f64::to_be_bytes`]
2453 - [`f64::to_le_bytes`]
2454 - [`f64::to_ne_bytes`]
2455 - [`f32::from_be_bytes`]
2456 - [`f32::from_le_bytes`]
2457 - [`f32::from_ne_bytes`]
2458 - [`f64::from_be_bytes`]
2459 - [`f64::from_le_bytes`]
2460 - [`f64::from_ne_bytes`]
2461 - [`mem::take`]
2462 - [`slice::repeat`]
2463 - [`todo!`]
2464
2465 Cargo
2466 -----
2467 - [Cargo will now always display warnings, rather than only on
2468   fresh builds.][cargo/7450]
2469 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2470   now produce an error.][cargo/7507] Previously these flags were ignored.
2471 - [You can now publish `dev-dependencies` without including
2472   a `version`.][cargo/7333]
2473
2474 Misc
2475 ----
2476 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2477   when running documentation tests with `rustdoc`.][63803]
2478
2479 Compatibility Notes
2480 -------------------
2481 - [As previously announced, any previous NLL warnings in the 2015 edition are
2482   now hard errors.][64221]
2483 - [The `include!` macro will now warn if it failed to include the
2484   entire file.][64284] The `include!` macro unintentionally only includes the
2485   first _expression_ in a file, and this can be unintuitive. This will become
2486   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2487 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2488   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2489   or `extern` blocks now correctly emits a hard error.
2490
2491 [65294]: https://github.com/rust-lang/rust/pull/65294/
2492 [66103]: https://github.com/rust-lang/rust/pull/66103/
2493 [65843]: https://github.com/rust-lang/rust/pull/65843/
2494 [65188]: https://github.com/rust-lang/rust/pull/65188/
2495 [65092]: https://github.com/rust-lang/rust/pull/65092/
2496 [64589]: https://github.com/rust-lang/rust/pull/64589/
2497 [64639]: https://github.com/rust-lang/rust/pull/64639/
2498 [64221]: https://github.com/rust-lang/rust/pull/64221/
2499 [64284]: https://github.com/rust-lang/rust/pull/64284/
2500 [63931]: https://github.com/rust-lang/rust/pull/63931/
2501 [64035]: https://github.com/rust-lang/rust/pull/64035/
2502 [63674]: https://github.com/rust-lang/rust/pull/63674/
2503 [63803]: https://github.com/rust-lang/rust/pull/63803/
2504 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2505 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2506 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2507 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2508 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2509 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2510 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2511 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2512 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2513 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2514 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2515 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2516 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2517 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2518 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2519 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2520 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2521 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2522 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2523 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2524 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2525 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2526 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2527 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2528 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2529 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2530
2531
2532 Version 1.39.0 (2019-11-07)
2533 ===========================
2534
2535 Language
2536 --------
2537 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2538   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2539 - [You can now use certain attributes on function, closure, and function pointer
2540   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2541   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2542   attributes applied to items. e.g.
2543   ```rust
2544   fn len(
2545       #[cfg(windows)] slice: &[u16],
2546       #[cfg(not(windows))] slice: &[u8],
2547   ) -> usize {
2548       slice.len()
2549   }
2550   ```
2551 - [You can now take shared references to bind-by-move patterns in the `if` guards
2552   of `match` arms.][63118] e.g.
2553   ```rust
2554   fn main() {
2555       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2556
2557       match array {
2558           nums
2559   //      ---- `nums` is bound by move.
2560               if nums.iter().sum::<u8>() == 10
2561   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2562           => {
2563               drop(nums);
2564   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2565           }
2566           _ => unreachable!(),
2567       }
2568   }
2569   ```
2570
2571
2572
2573 Compiler
2574 --------
2575 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2576 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2577 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2578   **Note** Cargo currently doesn't use this feature. Refer to
2579   [cargo#7315][cargo/7315] to track this feature's progress.
2580 - [You can now pass `--show-output` argument to test binaries to print the
2581   output of successful tests.][62600]
2582
2583
2584 \* Refer to Rust's [platform support page][platform-support-doc] for more
2585 information on Rust's tiered platform support.
2586
2587 Libraries
2588 ---------
2589 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2590 - [`LinkedList::new` is now a `const` function.][63684]
2591 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2592 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2593   now `const`.][63786]
2594
2595 Stabilized APIs
2596 ---------------
2597 - [`Pin::into_inner`]
2598 - [`Instant::checked_duration_since`]
2599 - [`Instant::saturating_duration_since`]
2600
2601 Cargo
2602 -----
2603 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2604 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2605   `--all` is now deprecated.
2606
2607 Misc
2608 ----
2609 - [You can now pass `-Clinker` to rustdoc to control the linker used
2610   for compiling doctests.][63834]
2611
2612 Compatibility Notes
2613 -------------------
2614 - [Code that was previously accepted by the old borrow checker, but rejected by
2615   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2616   previously a warning, and will also become a hard error in the Rust 2015
2617   edition in the 1.40.0 release.
2618 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2619   run tests.][63827] This should improve performance when running a large
2620   amount of doctests.
2621 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2622   recommended to use the `?` operator instead.
2623 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2624   returned `0.0`.
2625
2626 [62600]: https://github.com/rust-lang/rust/pull/62600/
2627 [62672]: https://github.com/rust-lang/rust/pull/62672/
2628 [63118]: https://github.com/rust-lang/rust/pull/63118/
2629 [63209]: https://github.com/rust-lang/rust/pull/63209/
2630 [63402]: https://github.com/rust-lang/rust/pull/63402/
2631 [63565]: https://github.com/rust-lang/rust/pull/63565/
2632 [63595]: https://github.com/rust-lang/rust/pull/63595/
2633 [63684]: https://github.com/rust-lang/rust/pull/63684/
2634 [63698]: https://github.com/rust-lang/rust/pull/63698/
2635 [63770]: https://github.com/rust-lang/rust/pull/63770/
2636 [63786]: https://github.com/rust-lang/rust/pull/63786/
2637 [63827]: https://github.com/rust-lang/rust/pull/63827/
2638 [63834]: https://github.com/rust-lang/rust/pull/63834/
2639 [63927]: https://github.com/rust-lang/rust/pull/63927/
2640 [63933]: https://github.com/rust-lang/rust/pull/63933/
2641 [63934]: https://github.com/rust-lang/rust/pull/63934/
2642 [63938]: https://github.com/rust-lang/rust/pull/63938/
2643 [63940]: https://github.com/rust-lang/rust/pull/63940/
2644 [63941]: https://github.com/rust-lang/rust/pull/63941/
2645 [63945]: https://github.com/rust-lang/rust/pull/63945/
2646 [64010]: https://github.com/rust-lang/rust/pull/64010/
2647 [64028]: https://github.com/rust-lang/rust/pull/64028/
2648 [64334]: https://github.com/rust-lang/rust/pull/64334/
2649 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2650 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2651 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2652 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2653 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2654 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2655
2656 Version 1.38.0 (2019-09-26)
2657 ==========================
2658
2659 Language
2660 --------
2661 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2662 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2663
2664 Compiler
2665 --------
2666 - [Added pipelined compilation support to `rustc`.][62766] This will
2667   improve compilation times in some cases. For further information please refer
2668   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2669 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2670   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2671   `x86_64-uwp-windows-msvc` targets.][60260]
2672 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2673   `armv7-unknown-linux-musleabi` targets.][63107]
2674 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2675 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2676 - [Upgraded to LLVM 9.][62592]
2677
2678 \* Refer to Rust's [platform support page][platform-support-doc] for more
2679 information on Rust's tiered platform support.
2680
2681 Libraries
2682 ---------
2683 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2684 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2685   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2686   is available at `std::clone::Clone`). This also makes all built-in macros
2687   available in `std`/`core` root. e.g. `std::include_bytes!`.
2688 - [`str::Chars` now implements `Debug`.][63000]
2689 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2690 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2691 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2692 - [Added euclidean remainder and division operations (`div_euclid`,
2693   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2694   `overflowing`, and `wrapping` versions are available for all
2695   integer primitives.
2696 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2697   `PartialEq`.][61491]
2698 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2699
2700 Stabilized APIs
2701 ---------------
2702 - [`<*const T>::cast`]
2703 - [`<*mut T>::cast`]
2704 - [`Duration::as_secs_f32`]
2705 - [`Duration::as_secs_f64`]
2706 - [`Duration::div_f32`]
2707 - [`Duration::div_f64`]
2708 - [`Duration::from_secs_f32`]
2709 - [`Duration::from_secs_f64`]
2710 - [`Duration::mul_f32`]
2711 - [`Duration::mul_f64`]
2712 - [`any::type_name`]
2713
2714 Cargo
2715 -----
2716 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2717 - [You can now pass the `--features` option multiple times to enable
2718   multiple features.][cargo/7084]
2719
2720 Rustdoc
2721 -------
2722
2723 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2724
2725 Misc
2726 ----
2727 - [`rustc` will now warn about some incorrect uses of
2728   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2729
2730 Compatibility Notes
2731 -------------------
2732 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2733   1.38.0.
2734 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2735   issues][62896] with certain crates such as libc.
2736
2737 [60260]: https://github.com/rust-lang/rust/pull/60260/
2738 [61457]: https://github.com/rust-lang/rust/pull/61457/
2739 [61491]: https://github.com/rust-lang/rust/pull/61491/
2740 [61884]: https://github.com/rust-lang/rust/pull/61884/
2741 [61953]: https://github.com/rust-lang/rust/pull/61953/
2742 [62042]: https://github.com/rust-lang/rust/pull/62042/
2743 [62528]: https://github.com/rust-lang/rust/pull/62528/
2744 [62583]: https://github.com/rust-lang/rust/pull/62583/
2745 [62735]: https://github.com/rust-lang/rust/pull/62735/
2746 [62766]: https://github.com/rust-lang/rust/pull/62766/
2747 [62784]: https://github.com/rust-lang/rust/pull/62784/
2748 [62592]: https://github.com/rust-lang/rust/pull/62592/
2749 [62785]: https://github.com/rust-lang/rust/issues/62785/
2750 [62814]: https://github.com/rust-lang/rust/pull/62814/
2751 [62896]: https://github.com/rust-lang/rust/issues/62896/
2752 [63000]: https://github.com/rust-lang/rust/pull/63000/
2753 [63056]: https://github.com/rust-lang/rust/pull/63056/
2754 [63107]: https://github.com/rust-lang/rust/pull/63107/
2755 [63346]: https://github.com/rust-lang/rust/pull/63346/
2756 [63421]: https://github.com/rust-lang/rust/pull/63421/
2757 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2758 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2759 [63048]: https://github.com/rust-lang/rust/pull/63048
2760 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2761 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2762 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2763 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2764 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2765 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2766 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2767 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2768 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2769 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2770 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2771 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2772 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2773
2774 Version 1.37.0 (2019-08-15)
2775 ==========================
2776
2777 Language
2778 --------
2779 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2780   [`Box`][62228], or an [array][62235] and unused.
2781 - [You can now use the `cfg` and `cfg_attr` attributes on
2782   generic parameters.][61547]
2783 - [You can now use enum variants through type alias.][61682] e.g. You can
2784   write the following:
2785   ```rust
2786   type MyOption = Option<u8>;
2787
2788   fn increment_or_zero(x: MyOption) -> u8 {
2789       match x {
2790           MyOption::Some(y) => y + 1,
2791           MyOption::None => 0,
2792       }
2793   }
2794   ```
2795 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2796   `const _: u32 = 5;`.
2797 - [You can now use `#[repr(align(X)]` on enums.][61229]
2798 - [The  `?` Kleene macro operator is now available in the
2799   2015 edition.][60932]
2800
2801 Compiler
2802 --------
2803 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2804   and `-C profile-use` flags.][61268] For more information on how to use profile
2805   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2806 - [The `rust-lldb` wrapper script should now work again.][61827]
2807
2808 Libraries
2809 ---------
2810 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2811
2812 Stabilized APIs
2813 ---------------
2814 - [`BufReader::buffer`]
2815 - [`BufWriter::buffer`]
2816 - [`Cell::from_mut`]
2817 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2818 - [`DoubleEndedIterator::nth_back`]
2819 - [`Option::xor`]
2820 - [`Wrapping::reverse_bits`]
2821 - [`i128::reverse_bits`]
2822 - [`i16::reverse_bits`]
2823 - [`i32::reverse_bits`]
2824 - [`i64::reverse_bits`]
2825 - [`i8::reverse_bits`]
2826 - [`isize::reverse_bits`]
2827 - [`slice::copy_within`]
2828 - [`u128::reverse_bits`]
2829 - [`u16::reverse_bits`]
2830 - [`u32::reverse_bits`]
2831 - [`u64::reverse_bits`]
2832 - [`u8::reverse_bits`]
2833 - [`usize::reverse_bits`]
2834
2835 Cargo
2836 -----
2837 - [`Cargo.lock` files are now included by default when publishing executable crates
2838   with executables.][cargo/7026]
2839 - [You can now specify `default-run="foo"` in `[package]` to specify the
2840   default executable to use for `cargo run`.][cargo/7056]
2841
2842 Misc
2843 ----
2844
2845 Compatibility Notes
2846 -------------------
2847 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2848   Please transition your code to using the `..=` syntax for inclusive
2849   ranges instead.
2850 - [Using a trait object without the `dyn` will now warn by default.][61203]
2851   Please transition your code to use `dyn Trait` for trait objects instead.
2852
2853 [62228]: https://github.com/rust-lang/rust/pull/62228/
2854 [62235]: https://github.com/rust-lang/rust/pull/62235/
2855 [61802]: https://github.com/rust-lang/rust/pull/61802/
2856 [61827]: https://github.com/rust-lang/rust/pull/61827/
2857 [61547]: https://github.com/rust-lang/rust/pull/61547/
2858 [61682]: https://github.com/rust-lang/rust/pull/61682/
2859 [61268]: https://github.com/rust-lang/rust/pull/61268/
2860 [61342]: https://github.com/rust-lang/rust/pull/61342/
2861 [61347]: https://github.com/rust-lang/rust/pull/61347/
2862 [61100]: https://github.com/rust-lang/rust/pull/61100/
2863 [61203]: https://github.com/rust-lang/rust/pull/61203/
2864 [61229]: https://github.com/rust-lang/rust/pull/61229/
2865 [60932]: https://github.com/rust-lang/rust/pull/60932/
2866 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2867 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2868 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2869 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2870 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2871 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2872 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2873 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2874 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2875 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2876 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2877 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2878 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2879 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2880 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2881 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2882 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2883 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2884 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2885 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2886 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2887 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2888 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2889 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2890
2891
2892 Version 1.36.0 (2019-07-04)
2893 ==========================
2894
2895 Language
2896 --------
2897 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2898 - [The order of traits in trait objects no longer affects the semantics of that
2899   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2900   `dyn fmt::Debug + Send`, where this was previously not the case.
2901
2902 Libraries
2903 ---------
2904 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2905 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2906 - [`mem::needs_drop` is now available as a const fn.][60364]
2907 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2908 - [`String` now implements `BorrowMut<str>`.][60404]
2909 - [`io::Cursor` now implements `Default`.][60234]
2910 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2911 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2912   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2913   environment has access to heap memory allocation.
2914 - [`String` now implements `From<&String>`.][59825]
2915 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2916   return a tuple of each argument when there is multiple arguments.
2917 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2918   not used.][59648]
2919
2920 Stabilized APIs
2921 ---------------
2922 - [`VecDeque::rotate_left`]
2923 - [`VecDeque::rotate_right`]
2924 - [`Iterator::copied`]
2925 - [`io::IoSlice`]
2926 - [`io::IoSliceMut`]
2927 - [`Read::read_vectored`]
2928 - [`Write::write_vectored`]
2929 - [`str::as_mut_ptr`]
2930 - [`mem::MaybeUninit`]
2931 - [`pointer::align_offset`]
2932 - [`future::Future`]
2933 - [`task::Context`]
2934 - [`task::RawWaker`]
2935 - [`task::RawWakerVTable`]
2936 - [`task::Waker`]
2937 - [`task::Poll`]
2938
2939 Cargo
2940 -----
2941 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2942 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2943
2944 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2945
2946 Clippy
2947 ------
2948 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2949
2950 Misc
2951 ----
2952
2953 Compatibility Notes
2954 -------------------
2955 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2956   longer recommended, and will be deprecated in 1.39.0.
2957
2958 [60318]: https://github.com/rust-lang/rust/pull/60318/
2959 [60364]: https://github.com/rust-lang/rust/pull/60364/
2960 [60370]: https://github.com/rust-lang/rust/pull/60370/
2961 [60404]: https://github.com/rust-lang/rust/pull/60404/
2962 [60234]: https://github.com/rust-lang/rust/pull/60234/
2963 [60244]: https://github.com/rust-lang/rust/pull/60244/
2964 [58623]: https://github.com/rust-lang/rust/pull/58623/
2965 [59648]: https://github.com/rust-lang/rust/pull/59648/
2966 [59675]: https://github.com/rust-lang/rust/pull/59675/
2967 [59825]: https://github.com/rust-lang/rust/pull/59825/
2968 [59826]: https://github.com/rust-lang/rust/pull/59826/
2969 [59445]: https://github.com/rust-lang/rust/pull/59445/
2970 [59114]: https://github.com/rust-lang/rust/pull/59114/
2971 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2972 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2973 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2974 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2975 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2976 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2977 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2978 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2979 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2980 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2981 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2982 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2983 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2984 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2985 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2986 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2987 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2988 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2989 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2990 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2991
2992
2993 Version 1.35.0 (2019-05-23)
2994 ==========================
2995
2996 Language
2997 --------
2998 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2999   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3000 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3001   ```rust
3002   unsafe fn call_unsafe(func: unsafe fn()) {
3003       func()
3004   }
3005
3006   pub fn main() {
3007       unsafe { call_unsafe(|| {}); }
3008   }
3009   ```
3010
3011
3012 Compiler
3013 --------
3014 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3015   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3016 - [Added the `wasm32-unknown-wasi` target.][59464]
3017
3018
3019 Libraries
3020 ---------
3021 - [`Thread` will now show its ID in `Debug` output.][59460]
3022 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3023 - [`alloc::System` now implements `Default`.][59451]
3024 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3025   last field.][59076]
3026 - [`char::{ToLowercase, ToUppercase}` now
3027   implement `ExactSizeIterator`.][58778]
3028 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3029 - [Removed the `Read` trait bounds
3030   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3031 - [You can now call the `dbg!` macro without any parameters to print the file
3032   and line where it is called.][57847]
3033 - [In place ASCII case conversions are now up to 4× faster.][59283]
3034   e.g. `str::make_ascii_lowercase`
3035 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3036   and `Send`.][58369]
3037
3038 Stabilized APIs
3039 ---------------
3040 - [`f32::copysign`]
3041 - [`f64::copysign`]
3042 - [`RefCell::replace_with`]
3043 - [`RefCell::map_split`]
3044 - [`ptr::hash`]
3045 - [`Range::contains`]
3046 - [`RangeFrom::contains`]
3047 - [`RangeTo::contains`]
3048 - [`RangeInclusive::contains`]
3049 - [`RangeToInclusive::contains`]
3050 - [`Option::copied`]
3051
3052 Cargo
3053 -----
3054 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3055   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3056   platform specific.
3057
3058 Misc
3059 ----
3060 - [The Rust toolchain is now available natively for musl based distros.][58575]
3061
3062 [59460]: https://github.com/rust-lang/rust/pull/59460/
3063 [59464]: https://github.com/rust-lang/rust/pull/59464/
3064 [59500]: https://github.com/rust-lang/rust/pull/59500/
3065 [59512]: https://github.com/rust-lang/rust/pull/59512/
3066 [59580]: https://github.com/rust-lang/rust/pull/59580/
3067 [59283]: https://github.com/rust-lang/rust/pull/59283/
3068 [59451]: https://github.com/rust-lang/rust/pull/59451/
3069 [59076]: https://github.com/rust-lang/rust/pull/59076/
3070 [58778]: https://github.com/rust-lang/rust/pull/58778/
3071 [58717]: https://github.com/rust-lang/rust/pull/58717/
3072 [58369]: https://github.com/rust-lang/rust/pull/58369/
3073 [58423]: https://github.com/rust-lang/rust/pull/58423/
3074 [58080]: https://github.com/rust-lang/rust/pull/58080/
3075 [57847]: https://github.com/rust-lang/rust/pull/57847/
3076 [58575]: https://github.com/rust-lang/rust/pull/58575
3077 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3078 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3079 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3080 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3081 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3082 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3083 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3084 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3085 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3086 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3087 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3088 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3089
3090 Version 1.34.2 (2019-05-14)
3091 ===========================
3092
3093 * [Destabilize the `Error::type_id` function due to a security
3094    vulnerability][60785] ([CVE-2019-12083])
3095
3096 [60785]: https://github.com/rust-lang/rust/pull/60785
3097 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3098
3099 Version 1.34.1 (2019-04-25)
3100 ===========================
3101
3102 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3103 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3104 * [Fix Clippy panic when checking some macros][clippy/3805]
3105
3106 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3107 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3108 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3109
3110 Version 1.34.0 (2019-04-11)
3111 ==========================
3112
3113 Language
3114 --------
3115 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3116   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3117   but had no effect.
3118 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3119   `#[attr{}]` procedural macros.][57367]
3120 - [You can now write `extern crate self as foo;`][57407] to import your
3121   crate's root into the extern prelude.
3122
3123
3124 Compiler
3125 --------
3126 - [You can now target `riscv64imac-unknown-none-elf` and
3127   `riscv64gc-unknown-none-elf`.][58406]
3128 - [You can now enable linker plugin LTO optimisations with
3129   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3130   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3131   boundaries.
3132 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3133
3134
3135 Libraries
3136 ---------
3137 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3138   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3139   the `Hash` trait to create an iterator.
3140 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3141   methods.][58421] Most notably you no longer require the `Ord` trait to create
3142   an iterator.
3143 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3144   for all numeric types.][58044]
3145 - [Indexing a `str` is now generic over all types that
3146   implement `SliceIndex<str>`.][57604]
3147 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3148   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3149   produce a warning if their returning type is unused.
3150 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3151   `overflowing_pow` are now available for all numeric types.][57873] These are
3152   equivalent to methods such as `wrapping_add` for the `pow` operation.
3153
3154
3155 Stabilized APIs
3156 ---------------
3157
3158 #### std & core
3159 * [`Any::type_id`]
3160 * [`Error::type_id`]
3161 * [`atomic::AtomicI16`]
3162 * [`atomic::AtomicI32`]
3163 * [`atomic::AtomicI64`]
3164 * [`atomic::AtomicI8`]
3165 * [`atomic::AtomicU16`]
3166 * [`atomic::AtomicU32`]
3167 * [`atomic::AtomicU64`]
3168 * [`atomic::AtomicU8`]
3169 * [`convert::Infallible`]
3170 * [`convert::TryFrom`]
3171 * [`convert::TryInto`]
3172 * [`iter::from_fn`]
3173 * [`iter::successors`]
3174 * [`num::NonZeroI128`]
3175 * [`num::NonZeroI16`]
3176 * [`num::NonZeroI32`]
3177 * [`num::NonZeroI64`]
3178 * [`num::NonZeroI8`]
3179 * [`num::NonZeroIsize`]
3180 * [`slice::sort_by_cached_key`]
3181 * [`str::escape_debug`]
3182 * [`str::escape_default`]
3183 * [`str::escape_unicode`]
3184 * [`str::split_ascii_whitespace`]
3185
3186 #### std
3187 * [`Instant::checked_add`]
3188 * [`Instant::checked_sub`]
3189 * [`SystemTime::checked_add`]
3190 * [`SystemTime::checked_sub`]
3191
3192 Cargo
3193 -----
3194 - [You can now use alternative registries to crates.io.][cargo/6654]
3195
3196 Misc
3197 ----
3198 - [You can now use the `?` operator in your documentation tests without manually
3199   adding `fn main() -> Result<(), _> {}`.][56470]
3200
3201 Compatibility Notes
3202 -------------------
3203 - [`Command::before_exec` is being replaced by the unsafe method
3204   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3205 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3206   can now use `const` functions in `static` variables.
3207
3208 [58370]: https://github.com/rust-lang/rust/pull/58370/
3209 [58406]: https://github.com/rust-lang/rust/pull/58406/
3210 [58421]: https://github.com/rust-lang/rust/pull/58421/
3211 [58166]: https://github.com/rust-lang/rust/pull/58166/
3212 [58044]: https://github.com/rust-lang/rust/pull/58044/
3213 [58057]: https://github.com/rust-lang/rust/pull/58057/
3214 [58059]: https://github.com/rust-lang/rust/pull/58059/
3215 [57809]: https://github.com/rust-lang/rust/pull/57809/
3216 [57873]: https://github.com/rust-lang/rust/pull/57873/
3217 [57604]: https://github.com/rust-lang/rust/pull/57604/
3218 [57367]: https://github.com/rust-lang/rust/pull/57367/
3219 [57407]: https://github.com/rust-lang/rust/pull/57407/
3220 [57425]: https://github.com/rust-lang/rust/pull/57425/
3221 [57106]: https://github.com/rust-lang/rust/pull/57106/
3222 [56470]: https://github.com/rust-lang/rust/pull/56470/
3223 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3224 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3225 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3226 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3227 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3228 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3229 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3230 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3231 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3232 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3233 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3234 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3235 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3236 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3237 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3238 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3239 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3240 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3241 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3242 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3243 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3244 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3245 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3246 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3247 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3248 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3249 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3250 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3251 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3252 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3253 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3254
3255
3256 Version 1.33.0 (2019-02-28)
3257 ==========================
3258
3259 Language
3260 --------
3261 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3262   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3263 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3264   E.g. You can have match statement on a `u8` that covers `0..=255` and
3265   you would no longer be required to have a `_ => unreachable!()` case.
3266 - [You can now have multiple patterns in `if let` and `while let`
3267   expressions.][57532] You can do this with the same syntax as a `match`
3268   expression. E.g.
3269   ```rust
3270   enum Creature {
3271       Crab(String),
3272       Lobster(String),
3273       Person(String),
3274   }
3275
3276   fn main() {
3277       let state = Creature::Crab("Ferris");
3278
3279       if let Creature::Crab(name) | Creature::Person(name) = state {
3280           println!("This creature's name is: {}", name);
3281       }
3282   }
3283   ```
3284 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3285   this feature will by default produce a warning as this behaviour can be
3286   unintuitive. E.g. `if let _ = 5 {}`
3287 - [You can now use `let` bindings, assignments, expression statements,
3288   and irrefutable pattern destructuring in const functions.][57175]
3289 - [You can now call unsafe const functions.][57067] E.g.
3290   ```rust
3291   const unsafe fn foo() -> i32 { 5 }
3292   const fn bar() -> i32 {
3293       unsafe { foo() }
3294   }
3295   ```
3296 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3297   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3298 - [You can now specify a specific alignment with the `#[repr(packed)]`
3299   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3300   with an alignment of 2 bytes and a size of 6 bytes.
3301 - [You can now import an item from a module as an `_`.][56303] This allows you to
3302   import a trait's impls, and not have the name in the namespace. E.g.
3303   ```rust
3304   use std::io::Read as _;
3305
3306   // Allowed as there is only one `Read` in the module.
3307   pub trait Read {}
3308   ```
3309 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3310
3311 Compiler
3312 --------
3313 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3314   command line argument.][56351]
3315 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3316 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3317 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3318   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3319   information on Rust's platform support.
3320 - [Added support for the `thumbv7neon-linux-androideabi` and
3321   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3322 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3323
3324 Libraries
3325 ---------
3326 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3327   functions for all numeric types.][57566]
3328 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3329   are now `const` functions for all numeric types.][57105]
3330 - [The methods `is_positive` and `is_negative` are now `const` functions for
3331   all signed numeric types.][57105]
3332 - [The `get` method for all `NonZero` types is now `const`.][57167]
3333 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3334   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3335   numeric types.][57234]
3336 - [`Ipv4Addr::new` is now a `const` function][57234]
3337
3338 Stabilized APIs
3339 ---------------
3340 - [`unix::FileExt::read_exact_at`]
3341 - [`unix::FileExt::write_all_at`]
3342 - [`Option::transpose`]
3343 - [`Result::transpose`]
3344 - [`convert::identity`]
3345 - [`pin::Pin`]
3346 - [`marker::Unpin`]
3347 - [`marker::PhantomPinned`]
3348 - [`Vec::resize_with`]
3349 - [`VecDeque::resize_with`]
3350 - [`Duration::as_millis`]
3351 - [`Duration::as_micros`]
3352 - [`Duration::as_nanos`]
3353
3354
3355 Cargo
3356 -----
3357 - [You can now publish crates that require a feature flag to compile with
3358   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3359 - [Cargo should now rebuild a crate if a file was modified during the initial
3360   build.][cargo/6484]
3361
3362 Compatibility Notes
3363 -------------------
3364 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3365   are now deprecated in the standard library, and their usage will now produce a warning.
3366   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3367   methods instead.
3368 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3369   downcasting.
3370 - [Libtest no longer creates a new thread for each test when
3371   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3372
3373 [55982]: https://github.com/rust-lang/rust/pull/55982/
3374 [56243]: https://github.com/rust-lang/rust/pull/56243
3375 [56303]: https://github.com/rust-lang/rust/pull/56303/
3376 [56351]: https://github.com/rust-lang/rust/pull/56351/
3377 [56362]: https://github.com/rust-lang/rust/pull/56362
3378 [56642]: https://github.com/rust-lang/rust/pull/56642/
3379 [56769]: https://github.com/rust-lang/rust/pull/56769/
3380 [56805]: https://github.com/rust-lang/rust/pull/56805
3381 [56947]: https://github.com/rust-lang/rust/pull/56947/
3382 [57049]: https://github.com/rust-lang/rust/pull/57049/
3383 [57067]: https://github.com/rust-lang/rust/pull/57067/
3384 [57105]: https://github.com/rust-lang/rust/pull/57105
3385 [57130]: https://github.com/rust-lang/rust/pull/57130/
3386 [57167]: https://github.com/rust-lang/rust/pull/57167/
3387 [57175]: https://github.com/rust-lang/rust/pull/57175/
3388 [57234]: https://github.com/rust-lang/rust/pull/57234/
3389 [57332]: https://github.com/rust-lang/rust/pull/57332/
3390 [57465]: https://github.com/rust-lang/rust/pull/57465/
3391 [57532]: https://github.com/rust-lang/rust/pull/57532/
3392 [57535]: https://github.com/rust-lang/rust/pull/57535/
3393 [57566]: https://github.com/rust-lang/rust/pull/57566/
3394 [57615]: https://github.com/rust-lang/rust/pull/57615/
3395 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3396 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3397 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3398 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3399 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3400 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3401 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3402 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3403 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3404 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3405 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3406 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3407 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3408 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3409 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3410 [platform-support]: https://forge.rust-lang.org/platform-support.html
3411
3412 Version 1.32.0 (2019-01-17)
3413 ==========================
3414
3415 Language
3416 --------
3417 #### 2018 edition
3418 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3419   operator allows you to specify zero or one repetitions similar to the `*` and
3420   `+` operators.
3421 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3422   now always resolve to the item (`enum`, `struct`, etc.) available in the
3423   module if present, before resolving to a external crate or an item the prelude.][56759]
3424   E.g.
3425   ```rust
3426   enum Color { Red, Green, Blue }
3427
3428   use Color::*;
3429   ```
3430
3431 #### All editions
3432 - [You can now match against `PhantomData<T>` types.][55837]
3433 - [You can now match against literals in macros with the `literal`
3434   specifier.][56072] This will match against a literal of any type.
3435   E.g. `1`, `'A'`, `"Hello World"`
3436 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3437   ```rust
3438   struct Point(i32, i32);
3439
3440   impl Point {
3441       pub fn new(x: i32, y: i32) -> Self {
3442           Self(x, y)
3443       }
3444
3445       pub fn is_origin(&self) -> bool {
3446           match self {
3447               Self(0, 0) => true,
3448               _ => false,
3449           }
3450       }
3451   }
3452   ```
3453 - [Self can also now be used in type definitions.][56366] E.g.
3454   ```rust
3455   enum List<T>
3456   where
3457       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3458   {
3459       Nil,
3460       Cons(T, Box<Self>) // likewise here
3461   }
3462   ```
3463 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3464   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3465
3466 Compiler
3467 --------
3468 - [The default allocator has changed from jemalloc to the default allocator on
3469   your system.][55238] The compiler itself on Linux & macOS will still use
3470   jemalloc, but programs compiled with it will use the system allocator.
3471 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3472
3473 Libraries
3474 ---------
3475 - [`PathBuf` now implements `FromStr`.][55148]
3476 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3477 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3478   easily debug expressions in your rust program. E.g.
3479   ```rust
3480   let a = 2;
3481   let b = dbg!(a * 2) + 1;
3482   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3483   assert_eq!(b, 5);
3484   ```
3485
3486 The following APIs are now `const` functions and can be used in a
3487 `const` context.
3488
3489 - [`Cell::as_ptr`]
3490 - [`UnsafeCell::get`]
3491 - [`char::is_ascii`]
3492 - [`iter::empty`]
3493 - [`ManuallyDrop::new`]
3494 - [`ManuallyDrop::into_inner`]
3495 - [`RangeInclusive::start`]
3496 - [`RangeInclusive::end`]
3497 - [`NonNull::as_ptr`]
3498 - [`slice::as_ptr`]
3499 - [`str::as_ptr`]
3500 - [`Duration::as_secs`]
3501 - [`Duration::subsec_millis`]
3502 - [`Duration::subsec_micros`]
3503 - [`Duration::subsec_nanos`]
3504 - [`CStr::as_ptr`]
3505 - [`Ipv4Addr::is_unspecified`]
3506 - [`Ipv6Addr::new`]
3507 - [`Ipv6Addr::octets`]
3508
3509 Stabilized APIs
3510 ---------------
3511 - [`i8::to_be_bytes`]
3512 - [`i8::to_le_bytes`]
3513 - [`i8::to_ne_bytes`]
3514 - [`i8::from_be_bytes`]
3515 - [`i8::from_le_bytes`]
3516 - [`i8::from_ne_bytes`]
3517 - [`i16::to_be_bytes`]
3518 - [`i16::to_le_bytes`]
3519 - [`i16::to_ne_bytes`]
3520 - [`i16::from_be_bytes`]
3521 - [`i16::from_le_bytes`]
3522 - [`i16::from_ne_bytes`]
3523 - [`i32::to_be_bytes`]
3524 - [`i32::to_le_bytes`]
3525 - [`i32::to_ne_bytes`]
3526 - [`i32::from_be_bytes`]
3527 - [`i32::from_le_bytes`]
3528 - [`i32::from_ne_bytes`]
3529 - [`i64::to_be_bytes`]
3530 - [`i64::to_le_bytes`]
3531 - [`i64::to_ne_bytes`]
3532 - [`i64::from_be_bytes`]
3533 - [`i64::from_le_bytes`]
3534 - [`i64::from_ne_bytes`]
3535 - [`i128::to_be_bytes`]
3536 - [`i128::to_le_bytes`]
3537 - [`i128::to_ne_bytes`]
3538 - [`i128::from_be_bytes`]
3539 - [`i128::from_le_bytes`]
3540 - [`i128::from_ne_bytes`]
3541 - [`isize::to_be_bytes`]
3542 - [`isize::to_le_bytes`]
3543 - [`isize::to_ne_bytes`]
3544 - [`isize::from_be_bytes`]
3545 - [`isize::from_le_bytes`]
3546 - [`isize::from_ne_bytes`]
3547 - [`u8::to_be_bytes`]
3548 - [`u8::to_le_bytes`]
3549 - [`u8::to_ne_bytes`]
3550 - [`u8::from_be_bytes`]
3551 - [`u8::from_le_bytes`]
3552 - [`u8::from_ne_bytes`]
3553 - [`u16::to_be_bytes`]
3554 - [`u16::to_le_bytes`]
3555 - [`u16::to_ne_bytes`]
3556 - [`u16::from_be_bytes`]
3557 - [`u16::from_le_bytes`]
3558 - [`u16::from_ne_bytes`]
3559 - [`u32::to_be_bytes`]
3560 - [`u32::to_le_bytes`]
3561 - [`u32::to_ne_bytes`]
3562 - [`u32::from_be_bytes`]
3563 - [`u32::from_le_bytes`]
3564 - [`u32::from_ne_bytes`]
3565 - [`u64::to_be_bytes`]
3566 - [`u64::to_le_bytes`]
3567 - [`u64::to_ne_bytes`]
3568 - [`u64::from_be_bytes`]
3569 - [`u64::from_le_bytes`]
3570 - [`u64::from_ne_bytes`]
3571 - [`u128::to_be_bytes`]
3572 - [`u128::to_le_bytes`]
3573 - [`u128::to_ne_bytes`]
3574 - [`u128::from_be_bytes`]
3575 - [`u128::from_le_bytes`]
3576 - [`u128::from_ne_bytes`]
3577 - [`usize::to_be_bytes`]
3578 - [`usize::to_le_bytes`]
3579 - [`usize::to_ne_bytes`]
3580 - [`usize::from_be_bytes`]
3581 - [`usize::from_le_bytes`]
3582 - [`usize::from_ne_bytes`]
3583
3584 Cargo
3585 -----
3586 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3587 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3588
3589 Misc
3590 ----
3591 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3592
3593 Compatibility Notes
3594 -------------------
3595 - [The argument types for AVX's
3596   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3597   been changed from `*const` to `*mut` as the previous implementation
3598   was unsound.
3599
3600
3601 [55148]: https://github.com/rust-lang/rust/pull/55148/
3602 [55238]: https://github.com/rust-lang/rust/pull/55238/
3603 [55280]: https://github.com/rust-lang/rust/pull/55280/
3604 [55610]: https://github.com/rust-lang/rust/pull/55610/
3605 [55663]: https://github.com/rust-lang/rust/pull/55663/
3606 [55702]: https://github.com/rust-lang/rust/pull/55702/
3607 [55837]: https://github.com/rust-lang/rust/pull/55837/
3608 [55843]: https://github.com/rust-lang/rust/pull/55843/
3609 [56072]: https://github.com/rust-lang/rust/pull/56072/
3610 [56245]: https://github.com/rust-lang/rust/pull/56245/
3611 [56365]: https://github.com/rust-lang/rust/pull/56365/
3612 [56366]: https://github.com/rust-lang/rust/pull/56366/
3613 [56395]: https://github.com/rust-lang/rust/pull/56395/
3614 [56759]: https://github.com/rust-lang/rust/pull/56759/
3615 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3616 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3617 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3618 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3619 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3620 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3621 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3622 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3623 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3624 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3625 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3626 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3627 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3628 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3629 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3630 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3631 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3632 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3633 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3634 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3635 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3636 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3637 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3638 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3639 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3640 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3641 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3642 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3643 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3644 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3645 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3646 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3647 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3648 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3649 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3650 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3651 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3652 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3653 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3654 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3655 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3656 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3657 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3658 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3659 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3660 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3661 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3662 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3663 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3664 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3665 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3666 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3667 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3668 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3669 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3670 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3671 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3672 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3673 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3674 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3675 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3676 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3677 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3678 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3679 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3680 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3681 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3682 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3683 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3684 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3685 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3686 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3687 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3688 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3689 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3690 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3691 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3692 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3693 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3694 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3695 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3696 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3697 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3698 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3699 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3700 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3701 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3702 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3703 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3704 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3705 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3706 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3707 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3708
3709
3710 Version 1.31.1 (2018-12-20)
3711 ===========================
3712
3713 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3714 - [Fix broken go-to-definition in RLS][rls/1171]
3715 - [Fix infinite loop on hover in RLS][rls/1170]
3716
3717 [56562]: https://github.com/rust-lang/rust/pull/56562
3718 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3719 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3720
3721 Version 1.31.0 (2018-12-06)
3722 ==========================
3723
3724 Language
3725 --------
3726 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3727 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3728   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3729   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3730   in structs.
3731 - [You can now define and use `const` functions.][54835] These are currently
3732   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3733   [language reference][const-reference] for what exactly is available.
3734 - [You can now use tool lints, which allow you to scope lints from external
3735   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3736 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3737   a crate, not just in exported functions.][54451]
3738 - [You can now use parentheses in pattern matches.][54497]
3739
3740 Compiler
3741 --------
3742 - [Updated musl to 1.1.20][54430]
3743
3744 Libraries
3745 ---------
3746 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3747   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3748 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3749   into `Option<&mut T>` using the `From` trait.][53218]
3750 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3751
3752
3753 Stabilized APIs
3754 ---------------
3755 - [`slice::align_to`]
3756 - [`slice::align_to_mut`]
3757 - [`slice::chunks_exact`]
3758 - [`slice::chunks_exact_mut`]
3759 - [`slice::rchunks`]
3760 - [`slice::rchunks_mut`]
3761 - [`slice::rchunks_exact`]
3762 - [`slice::rchunks_exact_mut`]
3763 - [`Option::replace`]
3764
3765 Cargo
3766 -----
3767 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3768 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3769   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3770
3771 [52813]: https://github.com/rust-lang/rust/pull/52813/
3772 [53218]: https://github.com/rust-lang/rust/pull/53218/
3773 [53555]: https://github.com/rust-lang/rust/issues/53555/
3774 [54057]: https://github.com/rust-lang/rust/pull/54057/
3775 [54240]: https://github.com/rust-lang/rust/pull/54240/
3776 [54430]: https://github.com/rust-lang/rust/pull/54430/
3777 [54451]: https://github.com/rust-lang/rust/pull/54451/
3778 [54497]: https://github.com/rust-lang/rust/pull/54497/
3779 [54778]: https://github.com/rust-lang/rust/pull/54778/
3780 [54835]: https://github.com/rust-lang/rust/pull/54835/
3781 [54870]: https://github.com/rust-lang/rust/pull/54870/
3782 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3783 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3784 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3785 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3786 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3787 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3788 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3789 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3790 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3791 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3792 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3793 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3794 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3795 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3796
3797 Version 1.30.1 (2018-11-08)
3798 ===========================
3799
3800 - [Fixed overflow ICE in rustdoc][54199]
3801 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3802
3803 [54199]: https://github.com/rust-lang/rust/pull/54199
3804 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3805
3806 Version 1.30.0 (2018-10-25)
3807 ==========================
3808
3809 Language
3810 --------
3811 - [Procedural macros are now available.][52081] These kinds of macros allow for
3812   more powerful code generation. There is a [new chapter available][proc-macros]
3813   in the Rust Programming Language book that goes further in depth.
3814 - [You can now use keywords as identifiers using the raw identifiers
3815   syntax (`r#`),][53236] e.g. `let r#for = true;`
3816 - [Using anonymous parameters in traits is now deprecated with a warning and
3817   will be a hard error in the 2018 edition.][53272]
3818 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3819   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3820 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3821   Previously, using a external crate in a module without a use statement
3822   required `let json = ::serde_json::from_str(foo);` but can now be written
3823   as `let json = serde_json::from_str(foo);`.
3824 - [You can now apply the `#[used]` attribute to static items to prevent the
3825   compiler from optimising them away, even if they appear to be unused,][51363]
3826   e.g. `#[used] static FOO: u32 = 1;`
3827 - [You can now import and reexport macros from other crates with the `use`
3828   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3829   the root module of the crate. If your macro relies on calling other local
3830   macros, it is recommended to export with the
3831   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3832   those macros.
3833 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3834   using the `vis` specifier.][53370]
3835 - [Non-macro attributes now allow all forms of literals, not just
3836   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3837   write `#[attr(true)]`.
3838 - [You can now specify a function to handle a panic in the Rust runtime with the
3839   `#[panic_handler]` attribute.][51366]
3840
3841 Compiler
3842 --------
3843 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3844 - [Added the `aarch64-unknown-netbsd` target][53165]
3845 - [Upgraded to LLVM 8.][53611]
3846
3847 Libraries
3848 ---------
3849 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3850
3851 Stabilized APIs
3852 ---------------
3853 - [`Ipv4Addr::BROADCAST`]
3854 - [`Ipv4Addr::LOCALHOST`]
3855 - [`Ipv4Addr::UNSPECIFIED`]
3856 - [`Ipv6Addr::LOCALHOST`]
3857 - [`Ipv6Addr::UNSPECIFIED`]
3858 - [`Iterator::find_map`]
3859
3860   The following methods are replacement methods for `trim_left`, `trim_right`,
3861   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3862   in 1.33.0:
3863 - [`str::trim_end_matches`]
3864 - [`str::trim_end`]
3865 - [`str::trim_start_matches`]
3866 - [`str::trim_start`]
3867
3868 Cargo
3869 ----
3870 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3871 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3872   equivalent to calling `rustdoc --error-format=json`.
3873 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3874
3875 Misc
3876 ----
3877 - [`rustdoc` allows you to specify what edition to treat your code as with the
3878   `--edition` option.][54057]
3879 - [`rustdoc` now has the `--color` (specify whether to output color) and
3880   `--error-format` (specify error format, e.g. `json`) options.][53003]
3881 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3882   debug symbols.][53774]
3883 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3884   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3885
3886 [50911]: https://github.com/rust-lang/rust/pull/50911/
3887 [51363]: https://github.com/rust-lang/rust/pull/51363/
3888 [51366]: https://github.com/rust-lang/rust/pull/51366/
3889 [52081]: https://github.com/rust-lang/rust/pull/52081/
3890 [53003]: https://github.com/rust-lang/rust/pull/53003/
3891 [53033]: https://github.com/rust-lang/rust/pull/53033/
3892 [53044]: https://github.com/rust-lang/rust/pull/53044/
3893 [53165]: https://github.com/rust-lang/rust/pull/53165/
3894 [53611]: https://github.com/rust-lang/rust/pull/53611/
3895 [53213]: https://github.com/rust-lang/rust/pull/53213/
3896 [53236]: https://github.com/rust-lang/rust/pull/53236/
3897 [53272]: https://github.com/rust-lang/rust/pull/53272/
3898 [53370]: https://github.com/rust-lang/rust/pull/53370/
3899 [53459]: https://github.com/rust-lang/rust/pull/53459/
3900 [53774]: https://github.com/rust-lang/rust/pull/53774/
3901 [53822]: https://github.com/rust-lang/rust/pull/53822/
3902 [54057]: https://github.com/rust-lang/rust/pull/54057/
3903 [54146]: https://github.com/rust-lang/rust/pull/54146/
3904 [54404]: https://github.com/rust-lang/rust/pull/54404/
3905 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3906 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3907 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3908 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3909
3910 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3911 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3912 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3913 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3914 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3915 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3916 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3917 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3918 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3919 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3920
3921
3922 Version 1.29.2 (2018-10-11)
3923 ===========================
3924
3925 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3926 - The `rls-preview` component on the windows-gnu targets has been restored.
3927
3928 [54639]: https://github.com/rust-lang/rust/pull/54639
3929
3930
3931 Version 1.29.1 (2018-09-25)
3932 ===========================
3933
3934 Security Notes
3935 --------------
3936
3937 - The standard library's `str::repeat` function contained an out of bounds write
3938   caused by an integer overflow. This has been fixed by deterministically
3939   panicking when an overflow happens.
3940
3941   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3942   us.
3943
3944
3945 Version 1.29.0 (2018-09-13)
3946 ==========================
3947
3948 Compiler
3949 --------
3950 - [Bumped minimum LLVM version to 5.0.][51899]
3951 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3952 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3953 - [Upgraded to LLVM 7.][51966]
3954
3955 Libraries
3956 ---------
3957 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3958 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3959 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3960 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3961   for `&str`.][51178]
3962 - [`Cell<T>` now allows `T` to be unsized.][50494]
3963 - [`SocketAddr` is now stable on Redox.][52656]
3964
3965 Stabilized APIs
3966 ---------------
3967 - [`Arc::downcast`]
3968 - [`Iterator::flatten`]
3969 - [`Rc::downcast`]
3970
3971 Cargo
3972 -----
3973 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3974   `--locked` to disable this behavior.
3975 - [`cargo-install` will now allow you to cross compile an install
3976   using `--target`.][cargo/5614]
3977 - [Added the `cargo-fix` subcommand to automatically move project code from
3978   2015 edition to 2018.][cargo/5723]
3979 - [`cargo doc` can now optionally document private types using the
3980   `--document-private-items` flag.][cargo/5543]
3981
3982 Misc
3983 ----
3984 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3985   the specified level to that level.][52354] For example `--cap-lints warn`
3986   will demote `deny` and `forbid` lints to `warn`.
3987 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3988   fails and `101` if there is a panic.][52197]
3989 - [A preview of clippy has been made available through rustup.][51122]
3990   You can install the preview with `rustup component add clippy-preview`.
3991
3992 Compatibility Notes
3993 -------------------
3994 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3995   Use `str::get_unchecked(begin..end)` instead.
3996 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3997   Consider using the `home_dir` function from
3998   https://crates.io/crates/dirs instead.
3999 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4000 - [`cfg` attributes and `--cfg` command line flags are now more
4001   strictly validated.][53893]
4002
4003 [53893]: https://github.com/rust-lang/rust/pull/53893/
4004 [52861]: https://github.com/rust-lang/rust/pull/52861/
4005 [51966]: https://github.com/rust-lang/rust/pull/51966/
4006 [52656]: https://github.com/rust-lang/rust/pull/52656/
4007 [52239]: https://github.com/rust-lang/rust/pull/52239/
4008 [52330]: https://github.com/rust-lang/rust/pull/52330/
4009 [52354]: https://github.com/rust-lang/rust/pull/52354/
4010 [52402]: https://github.com/rust-lang/rust/pull/52402/
4011 [52103]: https://github.com/rust-lang/rust/pull/52103/
4012 [52197]: https://github.com/rust-lang/rust/pull/52197/
4013 [51807]: https://github.com/rust-lang/rust/pull/51807/
4014 [51899]: https://github.com/rust-lang/rust/pull/51899/
4015 [51912]: https://github.com/rust-lang/rust/pull/51912/
4016 [51511]: https://github.com/rust-lang/rust/pull/51511/
4017 [51619]: https://github.com/rust-lang/rust/pull/51619/
4018 [51656]: https://github.com/rust-lang/rust/pull/51656/
4019 [51178]: https://github.com/rust-lang/rust/pull/51178/
4020 [51122]: https://github.com/rust-lang/rust/pull/51122
4021 [50494]: https://github.com/rust-lang/rust/pull/50494/
4022 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4023 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4024 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4025 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4026 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4027 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4028 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4029
4030
4031 Version 1.28.0 (2018-08-02)
4032 ===========================
4033
4034 Language
4035 --------
4036 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4037   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4038   the inner type across Foreign Function Interface (FFI) boundaries.
4039 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4040   and can now be used as identifiers.][51196]
4041 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4042   stable.][51241] This will allow users to specify a global allocator for
4043   their program.
4044 - [Unit test functions marked with the `#[test]` attribute can now return
4045   `Result<(), E: Debug>` in addition to `()`.][51298]
4046 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4047   allows macros to easily target lifetimes.
4048
4049 Compiler
4050 --------
4051 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4052   prioritise making smaller binary sizes. `z` is the same as `s` with the
4053   exception that it does not vectorise loops, which typically results in an even
4054   smaller binary.
4055 - [The short error format is now stable.][49546] Specified with
4056   `--error-format=short` this option will provide a more compressed output of
4057   rust error messages.
4058 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4059 - [Reduced the number of allocations in the macro parser.][50855] This can
4060   improve compile times of macro heavy crates on average by 5%.
4061
4062 Libraries
4063 ---------
4064 - [Implemented `Default` for `&mut str`.][51306]
4065 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4066 - [Implemented `Extend` for `()`.][50234]
4067 - [The `Debug` implementation of `time::Duration` should now be more easily
4068   human readable.][50364] Previously a `Duration` of one second would printed as
4069   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4070 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4071   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4072   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4073   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4074   for `PathBuf`.][50170]
4075 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4076   and `Wrapping<i128>`.][50465]
4077 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4078   possible.][51050] This can provide up to a 40% speed increase.
4079 - [Improved error messages when using `format!`.][50610]
4080
4081 Stabilized APIs
4082 ---------------
4083 - [`Iterator::step_by`]
4084 - [`Path::ancestors`]
4085 - [`SystemTime::UNIX_EPOCH`]
4086 - [`alloc::GlobalAlloc`]
4087 - [`alloc::Layout`]
4088 - [`alloc::LayoutErr`]
4089 - [`alloc::System`]
4090 - [`alloc::alloc`]
4091 - [`alloc::alloc_zeroed`]
4092 - [`alloc::dealloc`]
4093 - [`alloc::realloc`]
4094 - [`alloc::handle_alloc_error`]
4095 - [`btree_map::Entry::or_default`]
4096 - [`fmt::Alignment`]
4097 - [`hash_map::Entry::or_default`]
4098 - [`iter::repeat_with`]
4099 - [`num::NonZeroUsize`]
4100 - [`num::NonZeroU128`]
4101 - [`num::NonZeroU16`]
4102 - [`num::NonZeroU32`]
4103 - [`num::NonZeroU64`]
4104 - [`num::NonZeroU8`]
4105 - [`ops::RangeBounds`]
4106 - [`slice::SliceIndex`]
4107 - [`slice::from_mut`]
4108 - [`slice::from_ref`]
4109 - [`{Any + Send + Sync}::downcast_mut`]
4110 - [`{Any + Send + Sync}::downcast_ref`]
4111 - [`{Any + Send + Sync}::is`]
4112
4113 Cargo
4114 -----
4115 - [Cargo will now no longer allow you to publish crates with build scripts that
4116   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4117   considered to be immutable.
4118
4119 Misc
4120 ----
4121 - [The `suggestion_applicability` field in `rustc`'s json output is now
4122   stable.][50486] This will allow dev tools to check whether a code suggestion
4123   would apply to them.
4124
4125 Compatibility Notes
4126 -------------------
4127 - [Rust will consider trait objects with duplicated constraints to be the same
4128   type as without the duplicated constraint.][51276] For example the below code will
4129   now fail to compile.
4130   ```rust
4131   trait Trait {}
4132
4133   impl Trait + Send {
4134       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4135   }
4136
4137   impl Trait + Send + Send {
4138       fn test(&self) { println!("two"); }
4139   }
4140   ```
4141
4142 [49546]: https://github.com/rust-lang/rust/pull/49546/
4143 [50143]: https://github.com/rust-lang/rust/pull/50143/
4144 [50170]: https://github.com/rust-lang/rust/pull/50170/
4145 [50234]: https://github.com/rust-lang/rust/pull/50234/
4146 [50265]: https://github.com/rust-lang/rust/pull/50265/
4147 [50364]: https://github.com/rust-lang/rust/pull/50364/
4148 [50385]: https://github.com/rust-lang/rust/pull/50385/
4149 [50465]: https://github.com/rust-lang/rust/pull/50465/
4150 [50486]: https://github.com/rust-lang/rust/pull/50486/
4151 [50554]: https://github.com/rust-lang/rust/pull/50554/
4152 [50610]: https://github.com/rust-lang/rust/pull/50610/
4153 [50855]: https://github.com/rust-lang/rust/pull/50855/
4154 [51050]: https://github.com/rust-lang/rust/pull/51050/
4155 [51196]: https://github.com/rust-lang/rust/pull/51196/
4156 [51200]: https://github.com/rust-lang/rust/pull/51200/
4157 [51241]: https://github.com/rust-lang/rust/pull/51241/
4158 [51276]: https://github.com/rust-lang/rust/pull/51276/
4159 [51298]: https://github.com/rust-lang/rust/pull/51298/
4160 [51306]: https://github.com/rust-lang/rust/pull/51306/
4161 [51562]: https://github.com/rust-lang/rust/pull/51562/
4162 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4163 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4164 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4165 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4166 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4167 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4168 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4169 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4170 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4171 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4172 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4173 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4174 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4175 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4176 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4177 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4178 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4179 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4180 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4181 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4182 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4183 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4184 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4185 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4186 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4187 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4188 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4189 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4190 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4191 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4192
4193 Version 1.27.2 (2018-07-20)
4194 ===========================
4195
4196 Compatibility Notes
4197 -------------------
4198
4199 - The borrow checker was fixed to avoid potential unsoundness when using
4200   match ergonomics: [#52213][52213].
4201
4202 [52213]: https://github.com/rust-lang/rust/issues/52213
4203
4204 Version 1.27.1 (2018-07-10)
4205 ===========================
4206
4207 Security Notes
4208 --------------
4209
4210 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4211   when running, which enabled executing code as some other user on a
4212   given machine. This release fixes that vulnerability; you can read
4213   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4214
4215   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4216
4217 Compatibility Notes
4218 -------------------
4219
4220 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4221   match ergonomics: [#51415][51415], [#49534][49534].
4222
4223 [51415]: https://github.com/rust-lang/rust/issues/51415
4224 [49534]: https://github.com/rust-lang/rust/issues/49534
4225 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4226 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4227
4228 Version 1.27.0 (2018-06-21)
4229 ==========================
4230
4231 Language
4232 --------
4233 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4234   be used as an identifier.
4235 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4236   bare `Trait` syntax, and should make it clearer when being used in tandem with
4237   `impl Trait` because it is equivalent to the following syntax:
4238   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4239   `Box<Trait> == Box<dyn Trait>`.
4240 - [Attributes on generic parameters such as types and lifetimes are
4241   now stable.][48851] e.g.
4242   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4243 - [The `#[must_use]` attribute can now also be used on functions as well as
4244   types.][48925] It provides a lint that by default warns users when the
4245   value returned by a function has not been used.
4246
4247 Compiler
4248 --------
4249 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4250
4251 Libraries
4252 ---------
4253 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4254   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4255   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4256   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4257   the `cfg` attribute.
4258 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4259   std are now available in core.][49896]
4260 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4261   to `Self`.][49630]
4262 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4263   that the operation isn't done in place.
4264 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4265   the `#[must_use]` attribute][49533] to warn about unused potentially
4266   expensive allocations.
4267
4268 Stabilized APIs
4269 ---------------
4270 - [`DoubleEndedIterator::rfind`]
4271 - [`DoubleEndedIterator::rfold`]
4272 - [`DoubleEndedIterator::try_rfold`]
4273 - [`Duration::from_micros`]
4274 - [`Duration::from_nanos`]
4275 - [`Duration::subsec_micros`]
4276 - [`Duration::subsec_millis`]
4277 - [`HashMap::remove_entry`]
4278 - [`Iterator::try_fold`]
4279 - [`Iterator::try_for_each`]
4280 - [`NonNull::cast`]
4281 - [`Option::filter`]
4282 - [`String::replace_range`]
4283 - [`Take::set_limit`]
4284 - [`hint::unreachable_unchecked`]
4285 - [`os::unix::process::parent_id`]
4286 - [`ptr::swap_nonoverlapping`]
4287 - [`slice::rsplit_mut`]
4288 - [`slice::rsplit`]
4289 - [`slice::swap_with_slice`]
4290
4291 Cargo
4292 -----
4293 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4294   `readme`, and `repository` fields.][cargo/5386]
4295 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4296 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4297   a different directory than `target` for placing compilation artifacts.
4298 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4299   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4300   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4301   where cargo would infer a binary, Cargo will produce a warning. You can
4302   disable this feature ahead of time by setting any of the following to false:
4303   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4304 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4305   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4306
4307 Misc
4308 ----
4309 - [Added “The Rustc book” into the official documentation.][49707]
4310   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4311 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4312
4313 Compatibility Notes
4314 -------------------
4315 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4316   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4317   compile, `"".is_empty()` will still compile.
4318 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4319   will only print the inner type.][48553] E.g.
4320   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4321   not `AtomicBool(true)`.
4322 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4323   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4324   alignment should cover all use cases.
4325 - The `.description()` method on the `std::error::Error` trait
4326   [has been soft-deprecated][50163]. It is no longer required to implement it.
4327
4328 [48553]: https://github.com/rust-lang/rust/pull/48553/
4329 [48851]: https://github.com/rust-lang/rust/pull/48851/
4330 [48925]: https://github.com/rust-lang/rust/pull/48925/
4331 [49533]: https://github.com/rust-lang/rust/pull/49533/
4332 [49623]: https://github.com/rust-lang/rust/pull/49623/
4333 [49630]: https://github.com/rust-lang/rust/pull/49630/
4334 [49664]: https://github.com/rust-lang/rust/pull/49664/
4335 [49699]: https://github.com/rust-lang/rust/pull/49699/
4336 [49707]: https://github.com/rust-lang/rust/pull/49707/
4337 [49719]: https://github.com/rust-lang/rust/pull/49719/
4338 [49896]: https://github.com/rust-lang/rust/pull/49896/
4339 [49968]: https://github.com/rust-lang/rust/pull/49968/
4340 [50163]: https://github.com/rust-lang/rust/pull/50163
4341 [50177]: https://github.com/rust-lang/rust/pull/50177/
4342 [50378]: https://github.com/rust-lang/rust/pull/50378/
4343 [50398]: https://github.com/rust-lang/rust/pull/50398/
4344 [50423]: https://github.com/rust-lang/rust/pull/50423/
4345 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4346 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4347 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4348 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4349 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4350 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4351 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4352 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4353 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4354 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4355 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4356 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4357 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4358 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4359 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4360 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4361 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4362 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4363 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4364 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4365 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4366 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4367 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4368 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4369 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4370 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4371 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4372 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4373 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4374 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4375
4376
4377 Version 1.26.2 (2018-06-05)
4378 ==========================
4379
4380 Compatibility Notes
4381 -------------------
4382
4383 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4384
4385 [51117]: https://github.com/rust-lang/rust/issues/51117
4386
4387
4388 Version 1.26.1 (2018-05-29)
4389 ==========================
4390
4391 Tools
4392 -----
4393
4394 - [RLS now works on Windows.][50646]
4395 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4396
4397
4398 Compatibility Notes
4399 --------
4400
4401 - [`fn main() -> impl Trait` no longer works for non-Termination
4402   trait.][50656]
4403   This reverts an accidental stabilization.
4404 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4405 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4406
4407 [50646]: https://github.com/rust-lang/rust/issues/50646
4408 [50656]: https://github.com/rust-lang/rust/pull/50656
4409 [50812]: https://github.com/rust-lang/rust/pull/50812
4410 [50950]: https://github.com/rust-lang/rust/issues/50950
4411 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4412
4413 Version 1.26.0 (2018-05-10)
4414 ==========================
4415
4416 Language
4417 --------
4418 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4419   implement either or both traits.][49299]
4420 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4421 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4422   lifetime can be elided.][49458]
4423 - [`impl Trait` is now stable allowing you to have abstract types in returns
4424    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4425   `fn open(path: impl AsRef<Path>)`.
4426 - [Pattern matching will now automatically apply dereferences.][49394]
4427 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4428 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4429 - [A lot of operations are now available in a const context.][46882] E.g. You
4430   can now index into constant arrays, reference and dereference into constants,
4431   and use tuple struct constructors.
4432 - [Fixed entry slice patterns are now stable.][48516] E.g.
4433   ```rust
4434   let points = [1, 2, 3, 4];
4435   match points {
4436       [1, 2, 3, 4] => println!("All points were sequential."),
4437       _ => println!("Not all points were sequential."),
4438   }
4439   ```
4440
4441
4442 Compiler
4443 --------
4444 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4445 - [Fixed exponential projection complexity on nested types.][48296]
4446   This can provide up to a ~12% reduction in compile times for certain crates.
4447 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4448   to remap path prefixes outputted by the compiler.
4449 - [Added `powerpc-unknown-netbsd` target.][48281]
4450
4451 Libraries
4452 ---------
4453 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4454 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4455   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4456 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4457 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4458 - [`ascii::escape_default` is now available in libcore.][48735]
4459 - [Trailing commas are now supported in std and core macros.][48056]
4460 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4461 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4462
4463 Stabilized APIs
4464 ---------------
4465 - [`*const T::add`]
4466 - [`*const T::copy_to_nonoverlapping`]
4467 - [`*const T::copy_to`]
4468 - [`*const T::read_unaligned`]
4469 - [`*const T::read_volatile`]
4470 - [`*const T::read`]
4471 - [`*const T::sub`]
4472 - [`*const T::wrapping_add`]
4473 - [`*const T::wrapping_sub`]
4474 - [`*mut T::add`]
4475 - [`*mut T::copy_to_nonoverlapping`]
4476 - [`*mut T::copy_to`]
4477 - [`*mut T::read_unaligned`]
4478 - [`*mut T::read_volatile`]
4479 - [`*mut T::read`]
4480 - [`*mut T::replace`]
4481 - [`*mut T::sub`]
4482 - [`*mut T::swap`]
4483 - [`*mut T::wrapping_add`]
4484 - [`*mut T::wrapping_sub`]
4485 - [`*mut T::write_bytes`]
4486 - [`*mut T::write_unaligned`]
4487 - [`*mut T::write_volatile`]
4488 - [`*mut T::write`]
4489 - [`Box::leak`]
4490 - [`FromUtf8Error::as_bytes`]
4491 - [`LocalKey::try_with`]
4492 - [`Option::cloned`]
4493 - [`btree_map::Entry::and_modify`]
4494 - [`fs::read_to_string`]
4495 - [`fs::read`]
4496 - [`fs::write`]
4497 - [`hash_map::Entry::and_modify`]
4498 - [`iter::FusedIterator`]
4499 - [`ops::RangeInclusive`]
4500 - [`ops::RangeToInclusive`]
4501 - [`process::id`]
4502 - [`slice::rotate_left`]
4503 - [`slice::rotate_right`]
4504 - [`String::retain`]
4505
4506
4507 Cargo
4508 -----
4509 - [Cargo will now output path to custom commands when `-v` is
4510   passed with `--list`][cargo/5041]
4511 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4512
4513 Misc
4514 ----
4515 - [The second edition of "The Rust Programming Language" book is now recommended
4516   over the first.][48404]
4517
4518 Compatibility Notes
4519 -------------------
4520
4521 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4522   syntax is now invalid.
4523   ```
4524   use std::ops::Fn as dyn;
4525   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4526   ```
4527 - [The result of dereferences are no longer promoted to `'static`.][47408]
4528   e.g.
4529   ```rust
4530   fn main() {
4531       const PAIR: &(i32, i32) = &(0, 1);
4532       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4533   }
4534   ```
4535 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4536 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4537   an error.][48235]
4538 - [Removed hoedown from rustdoc.][48274]
4539 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4540
4541 [46882]: https://github.com/rust-lang/rust/pull/46882
4542 [47379]: https://github.com/rust-lang/rust/pull/47379
4543 [47408]: https://github.com/rust-lang/rust/pull/47408
4544 [47813]: https://github.com/rust-lang/rust/pull/47813
4545 [48056]: https://github.com/rust-lang/rust/pull/48056
4546 [48125]: https://github.com/rust-lang/rust/pull/48125
4547 [48166]: https://github.com/rust-lang/rust/pull/48166
4548 [48235]: https://github.com/rust-lang/rust/pull/48235
4549 [48274]: https://github.com/rust-lang/rust/pull/48274
4550 [48281]: https://github.com/rust-lang/rust/pull/48281
4551 [48296]: https://github.com/rust-lang/rust/pull/48296
4552 [48326]: https://github.com/rust-lang/rust/pull/48326
4553 [48359]: https://github.com/rust-lang/rust/pull/48359
4554 [48404]: https://github.com/rust-lang/rust/pull/48404
4555 [48481]: https://github.com/rust-lang/rust/pull/48481
4556 [48516]: https://github.com/rust-lang/rust/pull/48516
4557 [48628]: https://github.com/rust-lang/rust/pull/48628
4558 [48629]: https://github.com/rust-lang/rust/pull/48629
4559 [48657]: https://github.com/rust-lang/rust/pull/48657
4560 [48735]: https://github.com/rust-lang/rust/pull/48735
4561 [48978]: https://github.com/rust-lang/rust/pull/48978
4562 [49101]: https://github.com/rust-lang/rust/pull/49101
4563 [49109]: https://github.com/rust-lang/rust/pull/49109
4564 [49121]: https://github.com/rust-lang/rust/pull/49121
4565 [49162]: https://github.com/rust-lang/rust/pull/49162
4566 [49184]: https://github.com/rust-lang/rust/pull/49184
4567 [49234]: https://github.com/rust-lang/rust/pull/49234
4568 [49255]: https://github.com/rust-lang/rust/pull/49255
4569 [49299]: https://github.com/rust-lang/rust/pull/49299
4570 [49305]: https://github.com/rust-lang/rust/pull/49305
4571 [49394]: https://github.com/rust-lang/rust/pull/49394
4572 [49458]: https://github.com/rust-lang/rust/pull/49458
4573 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4574 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4575 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4576 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4577 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4578 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4579 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4580 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4581 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4582 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4583 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4584 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4585 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4586 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4587 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4588 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4589 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4590 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4591 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4592 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4593 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4594 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4595 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4596 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4597 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4598 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4599 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4600 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4601 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4602 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4603 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4604 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4605 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4606 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4607 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4608 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4609 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4610 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4611 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4612 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4613 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4614 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4615
4616
4617 Version 1.25.0 (2018-03-29)
4618 ==========================
4619
4620 Language
4621 --------
4622 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4623 - [You can now use nested groups of imports.][47948]
4624   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4625 - [You can now have `|` at the start of a match arm.][47947] e.g.
4626 ```rust
4627 enum Foo { A, B, C }
4628
4629 fn main() {
4630     let x = Foo::A;
4631     match x {
4632         | Foo::A
4633         | Foo::B => println!("AB"),
4634         | Foo::C => println!("C"),
4635     }
4636 }
4637 ```
4638
4639 Compiler
4640 --------
4641 - [Upgraded to LLVM 6.][47828]
4642 - [Added `-C lto=val` option.][47521]
4643 - [Added `i586-unknown-linux-musl` target][47282]
4644
4645 Libraries
4646 ---------
4647 - [Impl Send for `process::Command` on Unix.][47760]
4648 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4649 - [`UnsafeCell::into_inner` is now safe.][47204]
4650 - [Implement libstd for CloudABI.][47268]
4651 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4652 - [Implement `AsRef<Path>` for Component][46985]
4653 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4654 - [Moved `Duration` to libcore.][46666]
4655
4656 Stabilized APIs
4657 ---------------
4658 - [`Location::column`]
4659 - [`ptr::NonNull`]
4660
4661 The following functions can now be used in a constant expression.
4662 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4663 - [`Duration::new`][47300]
4664 - [`Duration::from_secs`][47300]
4665 - [`Duration::from_millis`][47300]
4666
4667 Cargo
4668 -----
4669 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4670 - [`cargo new` now defaults to creating a binary crate, instead of a
4671   library crate.][cargo/5029]
4672
4673 Misc
4674 ----
4675 - [Rust by example is now shipped with new releases][46196]
4676
4677 Compatibility Notes
4678 -------------------
4679 - [Deprecated `net::lookup_host`.][47510]
4680 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4681 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4682   around indexing operations (see [#47349][47349]). This has been fixed (which also
4683   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4684 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4685
4686 [33903]: https://github.com/rust-lang/rust/pull/33903
4687 [47947]: https://github.com/rust-lang/rust/pull/47947
4688 [47948]: https://github.com/rust-lang/rust/pull/47948
4689 [47760]: https://github.com/rust-lang/rust/pull/47760
4690 [47790]: https://github.com/rust-lang/rust/pull/47790
4691 [47828]: https://github.com/rust-lang/rust/pull/47828
4692 [47398]: https://github.com/rust-lang/rust/pull/47398
4693 [47510]: https://github.com/rust-lang/rust/pull/47510
4694 [47521]: https://github.com/rust-lang/rust/pull/47521
4695 [47204]: https://github.com/rust-lang/rust/pull/47204
4696 [47251]: https://github.com/rust-lang/rust/pull/47251
4697 [47268]: https://github.com/rust-lang/rust/pull/47268
4698 [47282]: https://github.com/rust-lang/rust/pull/47282
4699 [47300]: https://github.com/rust-lang/rust/pull/47300
4700 [47349]: https://github.com/rust-lang/rust/pull/47349
4701 [46931]: https://github.com/rust-lang/rust/pull/46931
4702 [46985]: https://github.com/rust-lang/rust/pull/46985
4703 [47006]: https://github.com/rust-lang/rust/pull/47006
4704 [46830]: https://github.com/rust-lang/rust/pull/46830
4705 [46095]: https://github.com/rust-lang/rust/pull/46095
4706 [46666]: https://github.com/rust-lang/rust/pull/46666
4707 [46196]: https://github.com/rust-lang/rust/pull/46196
4708 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4709 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4710 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4711 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4712 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4713
4714
4715 Version 1.24.1 (2018-03-01)
4716 ==========================
4717
4718  - [Do not abort when unwinding through FFI][48251]
4719  - [Emit UTF-16 files for linker arguments on Windows][48318]
4720  - [Make the error index generator work again][48308]
4721  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4722
4723 [48251]: https://github.com/rust-lang/rust/issues/48251
4724 [48308]: https://github.com/rust-lang/rust/issues/48308
4725 [48318]: https://github.com/rust-lang/rust/issues/48318
4726 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4727
4728
4729 Version 1.24.0 (2018-02-15)
4730 ==========================
4731
4732 Language
4733 --------
4734 - [External `sysv64` ffi is now available.][46528]
4735   eg. `extern "sysv64" fn foo () {}`
4736
4737 Compiler
4738 --------
4739 - [rustc now uses 16 codegen units by default for release builds.][46910]
4740   For the fastest builds, utilize `codegen-units=1`.
4741 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4742 - [Add `aarch64-unknown-openbsd` support][46760]
4743
4744 Libraries
4745 ---------
4746 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4747   improvement in performance in the majority of cases.
4748 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4749   with Windows.][46798]
4750 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4751 - [impl `From<bool>` for `AtomicBool`][46293]
4752 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4753 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4754 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4755 - [float::from_bits now just uses transmute.][46012] This provides
4756   some optimisations from LLVM.
4757 - [Copied `AsciiExt` methods onto `char`][46077]
4758 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4759 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4760 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4761 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4762
4763 Stabilized APIs
4764 ---------------
4765 - [`RefCell::replace`]
4766 - [`RefCell::swap`]
4767 - [`atomic::spin_loop_hint`]
4768
4769 The following functions can now be used in a constant expression.
4770 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4771
4772 - [`AtomicBool::new`][46287]
4773 - [`AtomicUsize::new`][46287]
4774 - [`AtomicIsize::new`][46287]
4775 - [`AtomicPtr::new`][46287]
4776 - [`Cell::new`][46287]
4777 - [`{integer}::min_value`][46287]
4778 - [`{integer}::max_value`][46287]
4779 - [`mem::size_of`][46287]
4780 - [`mem::align_of`][46287]
4781 - [`ptr::null`][46287]
4782 - [`ptr::null_mut`][46287]
4783 - [`RefCell::new`][46287]
4784 - [`UnsafeCell::new`][46287]
4785
4786 Cargo
4787 -----
4788 - [Added a `workspace.default-members` config that
4789   overrides implied `--all` in virtual workspaces.][cargo/4743]
4790 - [Enable incremental by default on development builds.][cargo/4817] Also added
4791   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4792   per-project or global basis respectively.
4793
4794 Misc
4795 ----
4796
4797 Compatibility Notes
4798 -------------------
4799 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4800 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4801   in accordance with IETF RFC 4291 §2.2.
4802 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4803 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4804   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4805 - [Leading zeros in tuple struct members is now an error][47084]
4806 - [`column!()` macro is one-based instead of zero-based][46977]
4807 - [`fmt::Arguments` can no longer be shared across threads][45198]
4808 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4809 - [Cargo sets a different working directory for the compiler][cargo/4788]
4810
4811 [44884]: https://github.com/rust-lang/rust/pull/44884
4812 [45198]: https://github.com/rust-lang/rust/pull/45198
4813 [45506]: https://github.com/rust-lang/rust/pull/45506
4814 [45904]: https://github.com/rust-lang/rust/pull/45904
4815 [45990]: https://github.com/rust-lang/rust/pull/45990
4816 [46012]: https://github.com/rust-lang/rust/pull/46012
4817 [46077]: https://github.com/rust-lang/rust/pull/46077
4818 [46094]: https://github.com/rust-lang/rust/pull/46094
4819 [46284]: https://github.com/rust-lang/rust/pull/46284
4820 [46287]: https://github.com/rust-lang/rust/pull/46287
4821 [46293]: https://github.com/rust-lang/rust/pull/46293
4822 [46528]: https://github.com/rust-lang/rust/pull/46528
4823 [46671]: https://github.com/rust-lang/rust/pull/46671
4824 [46713]: https://github.com/rust-lang/rust/pull/46713
4825 [46735]: https://github.com/rust-lang/rust/pull/46735
4826 [46749]: https://github.com/rust-lang/rust/pull/46749
4827 [46760]: https://github.com/rust-lang/rust/pull/46760
4828 [46798]: https://github.com/rust-lang/rust/pull/46798
4829 [46828]: https://github.com/rust-lang/rust/pull/46828
4830 [46831]: https://github.com/rust-lang/rust/pull/46831
4831 [46833]: https://github.com/rust-lang/rust/pull/46833
4832 [46910]: https://github.com/rust-lang/rust/pull/46910
4833 [46977]: https://github.com/rust-lang/rust/pull/46977
4834 [47018]: https://github.com/rust-lang/rust/pull/47018
4835 [47080]: https://github.com/rust-lang/rust/pull/47080
4836 [47084]: https://github.com/rust-lang/rust/pull/47084
4837 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4838 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4839 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4840 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4841 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4842 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4843
4844
4845 Version 1.23.0 (2018-01-04)
4846 ==========================
4847
4848 Language
4849 --------
4850 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4851 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4852   Which should fix some confusing errors in some operations.
4853
4854 Compiler
4855 --------
4856 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4857   undefined behavior.][45920]
4858 - [rustc now suggests renaming import if names clash.][45660]
4859 - [Display errors/warnings correctly when there are zero-width or
4860   wide characters.][45711]
4861 - [rustc now avoids unnecessary copies of arguments that are
4862   simple bindings][45380] This should improve memory usage on average by 5-10%.
4863 - [Updated musl used to build musl rustc to 1.1.17][45393]
4864
4865 Libraries
4866 ---------
4867 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4868 - [Implement Hash for raw pointers to unsized types][45483]
4869 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4870 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4871 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4872 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4873   and `<*mut T>::as_mut`][44932]
4874 - [Optimized `Thread::{park, unpark}` implementation][45524]
4875 - [Improved `SliceExt::binary_search` performance.][45333]
4876 - [impl `FromIterator<()>` for `()`][45379]
4877 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4878   is now deprecated.
4879
4880 Stabilized APIs
4881 ---------------
4882
4883 Cargo
4884 -----
4885 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4886   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4887 - [Added unit test checking to `cargo check`][cargo/4592]
4888 - [Cargo now lets you install a specific version
4889   using `cargo install --version`][cargo/4637]
4890
4891 Misc
4892 ----
4893 - [Releases now ship with the Cargo book documentation.][45692]
4894 - [rustdoc now prints rendering warnings on every run.][45324]
4895
4896 Compatibility Notes
4897 -------------------
4898 - [Changes have been made to type equality to make it more correct,
4899   in rare cases this could break some code.][45853] [Tracking issue for
4900   further information][45852]
4901 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4902 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4903   Android 9, the minimum supported version is Android 14.
4904 - [Bumped the minimum LLVM to 3.9][45326]
4905
4906 [44042]: https://github.com/rust-lang/rust/pull/44042
4907 [44932]: https://github.com/rust-lang/rust/pull/44932
4908 [45267]: https://github.com/rust-lang/rust/pull/45267
4909 [45324]: https://github.com/rust-lang/rust/pull/45324
4910 [45326]: https://github.com/rust-lang/rust/pull/45326
4911 [45333]: https://github.com/rust-lang/rust/pull/45333
4912 [45379]: https://github.com/rust-lang/rust/pull/45379
4913 [45380]: https://github.com/rust-lang/rust/pull/45380
4914 [45393]: https://github.com/rust-lang/rust/pull/45393
4915 [45435]: https://github.com/rust-lang/rust/pull/45435
4916 [45483]: https://github.com/rust-lang/rust/pull/45483
4917 [45524]: https://github.com/rust-lang/rust/pull/45524
4918 [45571]: https://github.com/rust-lang/rust/pull/45571
4919 [45580]: https://github.com/rust-lang/rust/pull/45580
4920 [45610]: https://github.com/rust-lang/rust/pull/45610
4921 [45660]: https://github.com/rust-lang/rust/pull/45660
4922 [45692]: https://github.com/rust-lang/rust/pull/45692
4923 [45711]: https://github.com/rust-lang/rust/pull/45711
4924 [45772]: https://github.com/rust-lang/rust/pull/45772
4925 [45852]: https://github.com/rust-lang/rust/issues/45852
4926 [45853]: https://github.com/rust-lang/rust/pull/45853
4927 [45887]: https://github.com/rust-lang/rust/pull/45887
4928 [45920]: https://github.com/rust-lang/rust/pull/45920
4929 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4930 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4931 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4932
4933
4934 Version 1.22.1 (2017-11-22)
4935 ==========================
4936
4937 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4938
4939 [46183]: https://github.com/rust-lang/rust/pull/46183
4940
4941 Version 1.22.0 (2017-11-22)
4942 ==========================
4943
4944 Language
4945 --------
4946 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4947 - [Now accepts underscores in unicode escapes][43716]
4948 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4949 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4950
4951 Compiler
4952 --------
4953 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4954 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4955   This should decrease compile times for debug builds.
4956 - [strict memory alignment now enabled on ARMv6][45094]
4957 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4958
4959 Libraries
4960 ---------
4961 - [Allow atomic operations up to 32 bits
4962   on `armv5te_unknown_linux_gnueabi`][44978]
4963 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4964 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4965 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4966 - [Properly detect overflow in `Instant += Duration`.][44220]
4967 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4968 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4969 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4970
4971 Stabilized APIs
4972 ---------------
4973
4974 Cargo
4975 -----
4976 - [Cargo will now build multi file examples in subdirectories of the `examples`
4977   folder that have a `main.rs` file.][cargo/4496]
4978 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4979   the old format will continue to work and can be updated with `cargo update`.
4980 - [Now supports vendoring git repositories][cargo/3992]
4981
4982 Misc
4983 ----
4984 - [`libbacktrace` is now available on Apple platforms.][44251]
4985 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4986   This now lets you specify that a given code example will fail to compile.
4987
4988 Compatibility Notes
4989 -------------------
4990 - [The minimum Android version that rustc can build for has been bumped
4991   to `4.0` from `2.3`][45656]
4992 - [Allowing `T op= &T` for numeric types has broken some type
4993   inference cases][45480]
4994
4995
4996 [42526]: https://github.com/rust-lang/rust/pull/42526
4997 [43017]: https://github.com/rust-lang/rust/pull/43017
4998 [43716]: https://github.com/rust-lang/rust/pull/43716
4999 [43949]: https://github.com/rust-lang/rust/pull/43949
5000 [44015]: https://github.com/rust-lang/rust/pull/44015
5001 [44220]: https://github.com/rust-lang/rust/pull/44220
5002 [44251]: https://github.com/rust-lang/rust/pull/44251
5003 [44287]: https://github.com/rust-lang/rust/pull/44287
5004 [44303]: https://github.com/rust-lang/rust/pull/44303
5005 [44456]: https://github.com/rust-lang/rust/pull/44456
5006 [44466]: https://github.com/rust-lang/rust/pull/44466
5007 [44895]: https://github.com/rust-lang/rust/pull/44895
5008 [44966]: https://github.com/rust-lang/rust/pull/44966
5009 [44978]: https://github.com/rust-lang/rust/pull/44978
5010 [45041]: https://github.com/rust-lang/rust/pull/45041
5011 [45064]: https://github.com/rust-lang/rust/pull/45064
5012 [45075]: https://github.com/rust-lang/rust/pull/45075
5013 [45094]: https://github.com/rust-lang/rust/pull/45094
5014 [45095]: https://github.com/rust-lang/rust/pull/45095
5015 [45480]: https://github.com/rust-lang/rust/issues/45480
5016 [45656]: https://github.com/rust-lang/rust/pull/45656
5017 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5018 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5019 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5020
5021
5022
5023
5024
5025
5026 Version 1.21.0 (2017-10-12)
5027 ==========================
5028
5029 Language
5030 --------
5031 - [You can now use static references for literals.][43838]
5032   Example:
5033   ```rust
5034   fn main() {
5035       let x: &'static u32 = &0;
5036   }
5037   ```
5038 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5039   Example:
5040   ```rust
5041   my_macro!(Vec<i32>::new); // Always worked
5042   my_macro!(Vec::<i32>::new); // Now works
5043   ```
5044
5045 Compiler
5046 --------
5047 - [Upgraded jemalloc to 4.5.0][43911]
5048 - [Enabled unwinding panics on Redox][43917]
5049 - [Now runs LLVM in parallel during translation phase.][43506]
5050   This should reduce peak memory usage.
5051
5052 Libraries
5053 ---------
5054 - [Generate builtin impls for `Clone` for all arrays and tuples that
5055   are `T: Clone`][43690]
5056 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5057 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5058   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5059
5060 Stabilized APIs
5061 ---------------
5062
5063 [`std::mem::discriminant`]
5064
5065 Cargo
5066 -----
5067 - [You can now call `cargo install` with multiple package names][cargo/4216]
5068 - [Cargo commands inside a virtual workspace will now implicitly
5069   pass `--all`][cargo/4335]
5070 - [Added a `[patch]` section to `Cargo.toml` to handle
5071   prepublication dependencies][cargo/4123] [RFC 1969]
5072 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5073   like patterns][cargo/4270]
5074 - [Added the `--all-targets` option][cargo/4400]
5075 - [Using required dependencies as a feature is now deprecated and emits
5076   a warning][cargo/4364]
5077
5078
5079 Misc
5080 ----
5081 - [Cargo docs are moving][43916]
5082   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5083 - [The rustdoc book is now available][43863]
5084   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5085 - [Added a preview of RLS has been made available through rustup][44204]
5086   Install with `rustup component add rls-preview`
5087 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5088   Previously only showed `std::os::unix`.
5089
5090 Compatibility Notes
5091 -------------------
5092 - [Changes in method matching against higher-ranked types][43880] This may cause
5093   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5094 - [rustc's JSON error output's byte position start at top of file.][42973]
5095   Was previously relative to the rustc's internal `CodeMap` struct which
5096   required the unstable library `libsyntax` to correctly use.
5097 - [`unused_results` lint no longer ignores booleans][43728]
5098
5099 [42565]: https://github.com/rust-lang/rust/pull/42565
5100 [42973]: https://github.com/rust-lang/rust/pull/42973
5101 [43348]: https://github.com/rust-lang/rust/pull/43348
5102 [43459]: https://github.com/rust-lang/rust/pull/43459
5103 [43506]: https://github.com/rust-lang/rust/pull/43506
5104 [43540]: https://github.com/rust-lang/rust/pull/43540
5105 [43690]: https://github.com/rust-lang/rust/pull/43690
5106 [43728]: https://github.com/rust-lang/rust/pull/43728
5107 [43838]: https://github.com/rust-lang/rust/pull/43838
5108 [43863]: https://github.com/rust-lang/rust/pull/43863
5109 [43880]: https://github.com/rust-lang/rust/pull/43880
5110 [43911]: https://github.com/rust-lang/rust/pull/43911
5111 [43916]: https://github.com/rust-lang/rust/pull/43916
5112 [43917]: https://github.com/rust-lang/rust/pull/43917
5113 [44204]: https://github.com/rust-lang/rust/pull/44204
5114 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5115 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5116 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5117 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5118 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5119 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5120 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5121 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5122 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5123
5124 Version 1.20.0 (2017-08-31)
5125 ===========================
5126
5127 Language
5128 --------
5129 - [Associated constants are now stabilised.][42809]
5130 - [A lot of macro bugs are now fixed.][42913]
5131
5132 Compiler
5133 --------
5134
5135 - [Struct fields are now properly coerced to the expected field type.][42807]
5136 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5137   `wasm32-experimental-emscripten` target.
5138 - [Changed some of the error messages to be more helpful.][42033]
5139 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5140   it.][43170]
5141 - [rustc now reports the total number of errors on compilation failure][43015]
5142   previously this was only the number of errors in the pass that failed.
5143 - [Expansion in rustc has been sped up 29x.][42533]
5144 - [added `msp430-none-elf` target.][43099]
5145 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5146   applicable][43178]
5147 - [Fixes backtraces on Redox][43228]
5148 - [rustc now identifies different versions of same crate when absolute paths of
5149   different types match in an error message.][42826]
5150
5151 Libraries
5152 ---------
5153
5154
5155 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5156 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5157   tuples.][43011]
5158 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5159   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5160 - [Impl `Clone` for `DefaultHasher`.][42799]
5161 - [Impl `Sync` for `SyncSender`.][42397]
5162 - [Impl `FromStr` for `char`][42271]
5163 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5164   NaN.][42431]
5165 - [allow messages in the `unimplemented!()` macro.][42155]
5166   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5167 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5168 - [Upgrade to Unicode 10.0.0][42999]
5169 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5170 - [Skip the main thread's manual stack guard on Linux][43072]
5171 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5172 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5173   previously 2^15.
5174 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5175
5176 Stabilized APIs
5177 ---------------
5178
5179 - [`CStr::into_c_string`]
5180 - [`CString::as_c_str`]
5181 - [`CString::into_boxed_c_str`]
5182 - [`Chain::get_mut`]
5183 - [`Chain::get_ref`]
5184 - [`Chain::into_inner`]
5185 - [`Option::get_or_insert_with`]
5186 - [`Option::get_or_insert`]
5187 - [`OsStr::into_os_string`]
5188 - [`OsString::into_boxed_os_str`]
5189 - [`Take::get_mut`]
5190 - [`Take::get_ref`]
5191 - [`Utf8Error::error_len`]
5192 - [`char::EscapeDebug`]
5193 - [`char::escape_debug`]
5194 - [`compile_error!`]
5195 - [`f32::from_bits`]
5196 - [`f32::to_bits`]
5197 - [`f64::from_bits`]
5198 - [`f64::to_bits`]
5199 - [`mem::ManuallyDrop`]
5200 - [`slice::sort_unstable_by_key`]
5201 - [`slice::sort_unstable_by`]
5202 - [`slice::sort_unstable`]
5203 - [`str::from_boxed_utf8_unchecked`]
5204 - [`str::as_bytes_mut`]
5205 - [`str::as_bytes_mut`]
5206 - [`str::from_utf8_mut`]
5207 - [`str::from_utf8_unchecked_mut`]
5208 - [`str::get_mut`]
5209 - [`str::get_unchecked_mut`]
5210 - [`str::get_unchecked`]
5211 - [`str::get`]
5212 - [`str::into_boxed_bytes`]
5213
5214
5215 Cargo
5216 -----
5217 - [Cargo API token location moved from `~/.cargo/config` to
5218   `~/.cargo/credentials`.][cargo/3978]
5219 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5220   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5221   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5222 - [You can now specify version of a binary when installed through
5223   `cargo install` using `--vers`.][cargo/4229]
5224 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5225   failure.][cargo/4248]
5226 - [Changed the convention around which file is the crate root.][cargo/4259]
5227 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5228   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5229
5230 Compatibility Notes
5231 -------------------
5232
5233 - [Functions with `'static` in their return types will now not be as usable as
5234   if they were using lifetime parameters instead.][42417]
5235 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5236   takes the sign of NaN into account where previously didn't.][42430]
5237
5238 [42033]: https://github.com/rust-lang/rust/pull/42033
5239 [42155]: https://github.com/rust-lang/rust/pull/42155
5240 [42271]: https://github.com/rust-lang/rust/pull/42271
5241 [42397]: https://github.com/rust-lang/rust/pull/42397
5242 [42417]: https://github.com/rust-lang/rust/pull/42417
5243 [42430]: https://github.com/rust-lang/rust/pull/42430
5244 [42431]: https://github.com/rust-lang/rust/pull/42431
5245 [42533]: https://github.com/rust-lang/rust/pull/42533
5246 [42571]: https://github.com/rust-lang/rust/pull/42571
5247 [42613]: https://github.com/rust-lang/rust/pull/42613
5248 [42799]: https://github.com/rust-lang/rust/pull/42799
5249 [42807]: https://github.com/rust-lang/rust/pull/42807
5250 [42809]: https://github.com/rust-lang/rust/pull/42809
5251 [42822]: https://github.com/rust-lang/rust/pull/42822
5252 [42826]: https://github.com/rust-lang/rust/pull/42826
5253 [42854]: https://github.com/rust-lang/rust/pull/42854
5254 [42913]: https://github.com/rust-lang/rust/pull/42913
5255 [42999]: https://github.com/rust-lang/rust/pull/42999
5256 [43011]: https://github.com/rust-lang/rust/pull/43011
5257 [43015]: https://github.com/rust-lang/rust/pull/43015
5258 [43072]: https://github.com/rust-lang/rust/pull/43072
5259 [43077]: https://github.com/rust-lang/rust/pull/43077
5260 [43097]: https://github.com/rust-lang/rust/pull/43097
5261 [43099]: https://github.com/rust-lang/rust/pull/43099
5262 [43170]: https://github.com/rust-lang/rust/pull/43170
5263 [43178]: https://github.com/rust-lang/rust/pull/43178
5264 [43185]: https://github.com/rust-lang/rust/pull/43185
5265 [43228]: https://github.com/rust-lang/rust/pull/43228
5266 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5267 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5268 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5269 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5270 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5271 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5272 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5273 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5274 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5275 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5276 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5277 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5278 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5279 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5280 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5281 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5282 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5283 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5284 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5285 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5286 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5287 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5288 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5289 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5290 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5291 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5292 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5293 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5294 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5295 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5296 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5297 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5298 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5299 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5300 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5301 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5302 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5303 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5304 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5305
5306
5307 Version 1.19.0 (2017-07-20)
5308 ===========================
5309
5310 Language
5311 --------
5312
5313 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5314   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5315 - [Macro recursion limit increased to 1024 from 64.][41676]
5316 - [Added lint for detecting unused macros.][41907]
5317 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5318   For example: `let x = loop { break 7; };`
5319 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5320   contain `Copy` types and cannot have a `Drop` implementation.
5321   Example: `union Foo { bar: u8, baz: usize }`
5322 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5323   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5324
5325 Compiler
5326 --------
5327
5328 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5329 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5330   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5331   you should use `--target armv7-linux-androideabi`.
5332 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5333 - [Minor optimisation of string operations.][42037]
5334 - [Compiler error message is now `aborting due to previous error(s)` instead of
5335   `aborting due to N previous errors`][42150] This was previously inaccurate and
5336   would only count certain kinds of errors.
5337 - [The compiler now supports Visual Studio 2017][42225]
5338 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5339 - [Added a lot][42264] of [new error codes][42302]
5340 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5341   libraries with C Run-time Libraries(CRT) to be statically linked.
5342 - [Fixed various ARM codegen bugs][42740]
5343
5344 Libraries
5345 ---------
5346
5347 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5348   `Extend<Cow<'a, str>>`][41449]
5349 - [`Vec` now implements `From<&mut [T]>`][41530]
5350 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5351 - [`SplitWhitespace` now implements `Clone`][41659]
5352 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5353   1.5x faster][41764]
5354 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5355   macros, but for printing to stderr.
5356
5357 Stabilized APIs
5358 ---------------
5359
5360 - [`OsString::shrink_to_fit`]
5361 - [`cmp::Reverse`]
5362 - [`Command::envs`]
5363 - [`thread::ThreadId`]
5364
5365 Cargo
5366 -----
5367
5368 - [Build scripts can now add environment variables to the environment
5369   the crate is being compiled in.
5370   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5371 - [Subcommands now replace the current process rather than spawning a new
5372   child process][cargo/3970]
5373 - [Workspace members can now accept glob file patterns][cargo/3979]
5374 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5375   the members in a given workspace.][cargo/3988]
5376 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5377 - [Target directory path is now in the cargo metadata][cargo/4022]
5378 - [Cargo no longer checks out a local working directory for the
5379   crates.io index][cargo/4026] This should provide smaller file size for the
5380   registry, and improve cloning times, especially on Windows machines.
5381 - [Added an `--exclude` option for excluding certain packages when using the
5382   `--all` option][cargo/4031]
5383 - [Cargo will now automatically retry when receiving a 5xx error
5384   from crates.io][cargo/4032]
5385 - [The `--features` option now accepts multiple comma or space
5386   delimited values.][cargo/4084]
5387 - [Added support for custom target specific runners][cargo/3954]
5388
5389 Misc
5390 ----
5391
5392 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5393   Windows Debugger.
5394 - [Rust will now release XZ compressed packages][rust-installer/57]
5395 - [rustup will now prefer to download rust packages with
5396   XZ compression][rustup/1100] over GZip packages.
5397 - [Added the ability to escape `#` in rust documentation][41785] By adding
5398   additional `#`'s ie. `##` is now `#`
5399
5400 Compatibility Notes
5401 -------------------
5402
5403 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5404 - [`-Z` flags are now no longer allowed to be used on the stable
5405   compiler.][41751] This has been a warning for a year previous to this.
5406 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5407   longer works][42844]. Users should migrate to the built-in `check`
5408   command, which has been available since 1.16.
5409 - [Ending a float literal with `._` is now a hard error.
5410   Example: `42._` .][41946]
5411 - [Any use of a private `extern crate` outside of its module is now a
5412   hard error.][36886] This was previously a warning.
5413 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5414   relative while the `::` prefix makes a path absolute, but was ignored and the
5415   path was relative regardless.
5416 - [Floating point constants in match patterns is now a hard error][36890]
5417   This was previously a warning.
5418 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5419   match patterns is now a hard error][36891] This was previously a warning.
5420 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5421   a warning.
5422 - [From the pound escape, lines consisting of multiple `#`s are
5423   now visible][41785]
5424 - [It is an error to re-export private enum variants][42460]. This is
5425   known to break a number of crates that depend on an older version of
5426   mustache.
5427 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5428   to use it to find the linker, and the build will fail where it did
5429   not previously][42607]
5430
5431 [36886]: https://github.com/rust-lang/rust/issues/36886
5432 [36888]: https://github.com/rust-lang/rust/issues/36888
5433 [36890]: https://github.com/rust-lang/rust/issues/36890
5434 [36891]: https://github.com/rust-lang/rust/issues/36891
5435 [36892]: https://github.com/rust-lang/rust/issues/36892
5436 [37406]: https://github.com/rust-lang/rust/issues/37406
5437 [39983]: https://github.com/rust-lang/rust/pull/39983
5438 [41145]: https://github.com/rust-lang/rust/pull/41145
5439 [41192]: https://github.com/rust-lang/rust/pull/41192
5440 [41258]: https://github.com/rust-lang/rust/pull/41258
5441 [41370]: https://github.com/rust-lang/rust/pull/41370
5442 [41449]: https://github.com/rust-lang/rust/pull/41449
5443 [41530]: https://github.com/rust-lang/rust/pull/41530
5444 [41624]: https://github.com/rust-lang/rust/pull/41624
5445 [41656]: https://github.com/rust-lang/rust/pull/41656
5446 [41659]: https://github.com/rust-lang/rust/pull/41659
5447 [41676]: https://github.com/rust-lang/rust/pull/41676
5448 [41751]: https://github.com/rust-lang/rust/pull/41751
5449 [41764]: https://github.com/rust-lang/rust/pull/41764
5450 [41785]: https://github.com/rust-lang/rust/pull/41785
5451 [41873]: https://github.com/rust-lang/rust/pull/41873
5452 [41907]: https://github.com/rust-lang/rust/pull/41907
5453 [41946]: https://github.com/rust-lang/rust/pull/41946
5454 [42016]: https://github.com/rust-lang/rust/pull/42016
5455 [42037]: https://github.com/rust-lang/rust/pull/42037
5456 [42068]: https://github.com/rust-lang/rust/pull/42068
5457 [42150]: https://github.com/rust-lang/rust/pull/42150
5458 [42162]: https://github.com/rust-lang/rust/pull/42162
5459 [42225]: https://github.com/rust-lang/rust/pull/42225
5460 [42264]: https://github.com/rust-lang/rust/pull/42264
5461 [42302]: https://github.com/rust-lang/rust/pull/42302
5462 [42460]: https://github.com/rust-lang/rust/issues/42460
5463 [42607]: https://github.com/rust-lang/rust/issues/42607
5464 [42740]: https://github.com/rust-lang/rust/pull/42740
5465 [42844]: https://github.com/rust-lang/rust/issues/42844
5466 [42948]: https://github.com/rust-lang/rust/pull/42948
5467 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5468 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5469 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5470 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5471 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5472 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5473 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5474 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5475 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5476 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5477 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5478 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5479 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5480 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5481 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5482 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5483 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5484 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5485 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5486 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5487 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5488 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5489
5490
5491 Version 1.18.0 (2017-06-08)
5492 ===========================
5493
5494 Language
5495 --------
5496
5497 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5498   make the item visible to just that module tree. Also accepts the keyword
5499   `crate` to make something public to the whole crate but not users of the
5500   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5501 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5502   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5503 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5504   types like `Write + Send`, trailing `+` are now supported in trait objects,
5505   and better error reporting for trait objects starting with `?Sized`.
5506 - [0e+10 is now a valid floating point literal][40589]
5507 - [Now warns if you bind a lifetime parameter to 'static][40734]
5508 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5509   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5510   representation in some cases.][40377]
5511
5512 Compiler
5513 --------
5514
5515 - [rustc can now emit mir with `--emit mir`][39891]
5516 - [Improved LLVM IR for trivial functions][40367]
5517 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5518 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5519   opportunities found through profiling
5520 - [Improved backtrace formatting when panicking][38165]
5521
5522 Libraries
5523 ---------
5524
5525 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5526   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5527   iteration or reallocation.
5528 - [Simplified HashMap Bucket interface][40561] provides performance
5529   improvements for iterating and cloning.
5530 - [Specialize Vec::from_elem to use calloc][40409]
5531 - [Fixed Race condition in fs::create_dir_all][39799]
5532 - [No longer caching stdio on Windows][40516]
5533 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5534   2.50%~ faster and in one case now 12.50% faster.
5535 - [Optimized `AtomicBool::fetch_nand`][41143]
5536
5537 Stabilized APIs
5538 ---------------
5539
5540 - [`Child::try_wait`]
5541 - [`HashMap::retain`]
5542 - [`HashSet::retain`]
5543 - [`PeekMut::pop`]
5544 - [`TcpStream::peek`]
5545 - [`UdpSocket::peek`]
5546 - [`UdpSocket::peek_from`]
5547
5548 Cargo
5549 -----
5550
5551 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5552   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5553 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5554 - [Added Android build support][cargo/3885]
5555 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5556   of a certain type, for example `cargo build --bins` will build all
5557   binaries.
5558 - [Added support for haiku][cargo/3952]
5559
5560 Misc
5561 ----
5562
5563 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5564 - [Added rust-windbg script for better debugging on Windows][39983]
5565 - [Rust now uses the official cross compiler for NetBSD][40612]
5566 - [rustdoc now accepts `#` at the start of files][40828]
5567 - [Fixed jemalloc support for musl][41168]
5568
5569 Compatibility Notes
5570 -------------------
5571
5572 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5573   always placed after the sign if it exists and before the digits. With the `#`
5574   flag the zeroes are placed after the prefix and before the digits.
5575 - [Due to the struct field optimisation][40377], using `transmute` on structs
5576   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5577   always been undefined behavior, but is now more likely to break in practice.
5578 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5579   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5580   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5581 - [Overlapping inherent `impl`s are now a hard error][40728]
5582 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5583 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5584   `out.asm` and `out.ll` instead of only one of the filetypes.
5585 - [ calling a function that returns `Self` will no longer work][41805] when
5586   the size of `Self` cannot be statically determined.
5587 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5588   this has caused a few regressions namely:
5589
5590   - Changed the link order of local static/dynamic libraries (respecting the
5591     order on given rather than having the compiler reorder).
5592   - Changed how MinGW is linked, native code linked to dynamic libraries
5593     may require manually linking to the gcc support library (for the native
5594     code itself)
5595
5596 [38165]: https://github.com/rust-lang/rust/pull/38165
5597 [39799]: https://github.com/rust-lang/rust/pull/39799
5598 [39891]: https://github.com/rust-lang/rust/pull/39891
5599 [39983]: https://github.com/rust-lang/rust/pull/39983
5600 [40043]: https://github.com/rust-lang/rust/pull/40043
5601 [40241]: https://github.com/rust-lang/rust/pull/40241
5602 [40338]: https://github.com/rust-lang/rust/pull/40338
5603 [40367]: https://github.com/rust-lang/rust/pull/40367
5604 [40377]: https://github.com/rust-lang/rust/pull/40377
5605 [40409]: https://github.com/rust-lang/rust/pull/40409
5606 [40516]: https://github.com/rust-lang/rust/pull/40516
5607 [40556]: https://github.com/rust-lang/rust/pull/40556
5608 [40561]: https://github.com/rust-lang/rust/pull/40561
5609 [40589]: https://github.com/rust-lang/rust/pull/40589
5610 [40612]: https://github.com/rust-lang/rust/pull/40612
5611 [40723]: https://github.com/rust-lang/rust/pull/40723
5612 [40728]: https://github.com/rust-lang/rust/pull/40728
5613 [40731]: https://github.com/rust-lang/rust/pull/40731
5614 [40734]: https://github.com/rust-lang/rust/pull/40734
5615 [40805]: https://github.com/rust-lang/rust/pull/40805
5616 [40807]: https://github.com/rust-lang/rust/pull/40807
5617 [40828]: https://github.com/rust-lang/rust/pull/40828
5618 [40870]: https://github.com/rust-lang/rust/pull/40870
5619 [41085]: https://github.com/rust-lang/rust/pull/41085
5620 [41143]: https://github.com/rust-lang/rust/pull/41143
5621 [41168]: https://github.com/rust-lang/rust/pull/41168
5622 [41270]: https://github.com/rust-lang/rust/issues/41270
5623 [41469]: https://github.com/rust-lang/rust/pull/41469
5624 [41805]: https://github.com/rust-lang/rust/issues/41805
5625 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5626 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5627 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5628 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5629 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5630 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5631 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5632 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5633 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5634 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5635 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5636 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5637 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5638 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5639
5640
5641 Version 1.17.0 (2017-04-27)
5642 ===========================
5643
5644 Language
5645 --------
5646
5647 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5648 * [Fields of structs may be initialized without duplicating the field/variable
5649   names][39761]. [RFC 1682]
5650 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5651 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5652   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5653   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5654   `'b`. Soundness fix.
5655 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5656 * [Static variables may contain references to other statics][40027]
5657
5658 Compiler
5659 --------
5660
5661 * [Exit quickly on only `--emit dep-info`][40336]
5662 * [Make `-C relocation-model` more correctly determine whether the linker
5663   creates a position-independent executable][40245]
5664 * [Add `-C overflow-checks` to directly control whether integer overflow
5665   panics][40037]
5666 * [The rustc type checker now checks items on demand instead of in a single
5667   in-order pass][40008]. This is mostly an internal refactoring in support of
5668   future work, including incremental type checking, but also resolves [RFC
5669   1647], allowing `Self` to appear in `impl` `where` clauses.
5670 * [Optimize vtable loads][39995]
5671 * [Turn off vectorization for Emscripten targets][39990]
5672 * [Provide suggestions for unknown macros imported with `use`][39953]
5673 * [Fix ICEs in path resolution][39939]
5674 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5675 * [Add clearer error message using `&str + &str`][39116]
5676
5677 Stabilized APIs
5678 ---------------
5679
5680 * [`Arc::into_raw`]
5681 * [`Arc::from_raw`]
5682 * [`Arc::ptr_eq`]
5683 * [`Rc::into_raw`]
5684 * [`Rc::from_raw`]
5685 * [`Rc::ptr_eq`]
5686 * [`Ordering::then`]
5687 * [`Ordering::then_with`]
5688 * [`BTreeMap::range`]
5689 * [`BTreeMap::range_mut`]
5690 * [`collections::Bound`]
5691 * [`process::abort`]
5692 * [`ptr::read_unaligned`]
5693 * [`ptr::write_unaligned`]
5694 * [`Result::expect_err`]
5695 * [`Cell::swap`]
5696 * [`Cell::replace`]
5697 * [`Cell::into_inner`]
5698 * [`Cell::take`]
5699
5700 Libraries
5701 ---------
5702
5703 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5704 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5705 * [`String` implements `FromIterator<&char>`][40028]
5706 * `Box` [implements][40009] a number of new conversions:
5707   `From<Box<str>> for String`,
5708   `From<Box<[T]>> for Vec<T>`,
5709   `From<Box<CStr>> for CString`,
5710   `From<Box<OsStr>> for OsString`,
5711   `From<Box<Path>> for PathBuf`,
5712   `Into<Box<str>> for String`,
5713   `Into<Box<[T]>> for Vec<T>`,
5714   `Into<Box<CStr>> for CString`,
5715   `Into<Box<OsStr>> for OsString`,
5716   `Into<Box<Path>> for PathBuf`,
5717   `Default for Box<str>`,
5718   `Default for Box<CStr>`,
5719   `Default for Box<OsStr>`,
5720   `From<&CStr> for Box<CStr>`,
5721   `From<&OsStr> for Box<OsStr>`,
5722   `From<&Path> for Box<Path>`
5723 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5724 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5725 * [Slightly optimize `slice::sort`][39538]
5726 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5727 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5728   `Box<str>` implements `From<&str>`][39438]
5729 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5730   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5731 * [`format!` estimates the needed capacity before writing a string][39356]
5732 * [Support unprivileged symlink creation in Windows][38921]
5733 * [`PathBuf` implements `Default`][38764]
5734 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5735 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5736   and poor hash functions.
5737
5738 Cargo
5739 -----
5740
5741 * [Add `cargo check --all`][cargo/3731]
5742 * [Add an option to ignore SSL revocation checking][cargo/3699]
5743 * [Add `cargo run --package`][cargo/3691]
5744 * [Add `required_features`][cargo/3667]
5745 * [Assume `build.rs` is a build script][cargo/3664]
5746 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5747
5748 Misc
5749 ----
5750
5751 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5752   `rustbook`][39633]
5753 * [The "Unstable Book" documents nightly-only features][ubook]
5754 * [Improve the style of the sidebar in rustdoc output][40265]
5755 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5756 * [Fix MSP430 breakage due to `i128`][40257]
5757 * [Preliminary Solaris/SPARCv9 support][39903]
5758 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5759   run without installing the MSVC runtime.
5760 * [`rustdoc --test` includes file names in test names][39788]
5761 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5762   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5763 * [Initial support for `aarch64-unknown-freebsd`][39491]
5764 * [Initial support for `i686-unknown-netbsd`][39426]
5765 * [This release no longer includes the old makefile build system][39431]. Rust
5766   is built with a custom build system, written in Rust, and with Cargo.
5767 * [Add Debug implementations for libcollection structs][39002]
5768 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5769 * [`--test-threads=0` produces an error][38945]
5770 * [`rustup` installs documentation by default][40526]
5771 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5772   WinDbg and Visual Studio to improve the debugging experience.
5773
5774 Compatibility Notes
5775 -------------------
5776
5777 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5778   workaround, either use MSVC 2015 or run vcvars.bat.
5779 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5780   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5781   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5782   fix.
5783 * [`format!` and `Display::to_string` panic if an underlying formatting
5784   implementation returns an error][40117]. Previously the error was silently
5785   ignored. It is incorrect for `write_fmt` to return an error when writing
5786   to a string.
5787 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5788   crates were marked stable and could be accessed from the stable toolchain.
5789 * [Rust git source no longer includes vendored crates][39728]. Those that need
5790   to build with vendored crates should build from release tarballs.
5791 * [Fix inert attributes from `proc_macro_derives`][39572]
5792 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5793   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5794   build system.
5795 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5796   existing code generally ignores the type of dead-code unless a type-hint is
5797   provided; this can cause surprising inference interactions particularly around
5798   defaulting. The new code uniformly ignores the result type of dead-code.
5799 * [Tuple-struct constructors with private fields are no longer visible][38932]
5800 * [Lifetime parameters that do not appear in the arguments are now considered
5801   early-bound][38897], resolving a soundness bug (#[32330]). The
5802   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5803   April of 2016.
5804 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5805 * [Make transmuting from fn item types to pointer-sized types a hard
5806   error][34198]
5807
5808 [27787]: https://github.com/rust-lang/rust/issues/27787
5809 [32330]: https://github.com/rust-lang/rust/issues/32330
5810 [34198]: https://github.com/rust-lang/rust/pull/34198
5811 [38161]: https://github.com/rust-lang/rust/pull/38161
5812 [38368]: https://github.com/rust-lang/rust/pull/38368
5813 [38584]: https://github.com/rust-lang/rust/issues/38584
5814 [38661]: https://github.com/rust-lang/rust/pull/38661
5815 [38764]: https://github.com/rust-lang/rust/pull/38764
5816 [38864]: https://github.com/rust-lang/rust/issues/38864
5817 [38897]: https://github.com/rust-lang/rust/pull/38897
5818 [38921]: https://github.com/rust-lang/rust/pull/38921
5819 [38932]: https://github.com/rust-lang/rust/pull/38932
5820 [38945]: https://github.com/rust-lang/rust/pull/38945
5821 [38981]: https://github.com/rust-lang/rust/pull/38981
5822 [39002]: https://github.com/rust-lang/rust/pull/39002
5823 [39116]: https://github.com/rust-lang/rust/pull/39116
5824 [39193]: https://github.com/rust-lang/rust/pull/39193
5825 [39265]: https://github.com/rust-lang/rust/pull/39265
5826 [39356]: https://github.com/rust-lang/rust/pull/39356
5827 [39372]: https://github.com/rust-lang/rust/pull/39372
5828 [39426]: https://github.com/rust-lang/rust/pull/39426
5829 [39431]: https://github.com/rust-lang/rust/pull/39431
5830 [39438]: https://github.com/rust-lang/rust/pull/39438
5831 [39440]: https://github.com/rust-lang/rust/pull/39440
5832 [39485]: https://github.com/rust-lang/rust/pull/39485
5833 [39491]: https://github.com/rust-lang/rust/pull/39491
5834 [39518]: https://github.com/rust-lang/rust/pull/39518
5835 [39538]: https://github.com/rust-lang/rust/pull/39538
5836 [39572]: https://github.com/rust-lang/rust/pull/39572
5837 [39633]: https://github.com/rust-lang/rust/pull/39633
5838 [39642]: https://github.com/rust-lang/rust/pull/39642
5839 [39728]: https://github.com/rust-lang/rust/pull/39728
5840 [39761]: https://github.com/rust-lang/rust/pull/39761
5841 [39788]: https://github.com/rust-lang/rust/pull/39788
5842 [39793]: https://github.com/rust-lang/rust/pull/39793
5843 [39837]: https://github.com/rust-lang/rust/pull/39837
5844 [39843]: https://github.com/rust-lang/rust/pull/39843
5845 [39851]: https://github.com/rust-lang/rust/pull/39851
5846 [39903]: https://github.com/rust-lang/rust/pull/39903
5847 [39939]: https://github.com/rust-lang/rust/pull/39939
5848 [39953]: https://github.com/rust-lang/rust/pull/39953
5849 [39960]: https://github.com/rust-lang/rust/pull/39960
5850 [39990]: https://github.com/rust-lang/rust/pull/39990
5851 [39995]: https://github.com/rust-lang/rust/pull/39995
5852 [40008]: https://github.com/rust-lang/rust/pull/40008
5853 [40009]: https://github.com/rust-lang/rust/pull/40009
5854 [40027]: https://github.com/rust-lang/rust/pull/40027
5855 [40028]: https://github.com/rust-lang/rust/pull/40028
5856 [40037]: https://github.com/rust-lang/rust/pull/40037
5857 [40117]: https://github.com/rust-lang/rust/pull/40117
5858 [40166]: https://github.com/rust-lang/rust/pull/40166
5859 [40245]: https://github.com/rust-lang/rust/pull/40245
5860 [40257]: https://github.com/rust-lang/rust/pull/40257
5861 [40261]: https://github.com/rust-lang/rust/pull/40261
5862 [40265]: https://github.com/rust-lang/rust/pull/40265
5863 [40319]: https://github.com/rust-lang/rust/pull/40319
5864 [40336]: https://github.com/rust-lang/rust/pull/40336
5865 [40526]: https://github.com/rust-lang/rust/pull/40526
5866 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5867 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5868 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5869 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5870 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5871 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5872 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5873 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5874 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5875 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5876 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5877 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5878 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5879 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5880 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5881 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5882 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5883 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5884 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5885 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5886 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5887 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5888 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5889 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5890 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5891 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5892 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5893 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5894 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5895 [mdbook]: https://crates.io/crates/mdbook
5896 [ubook]: https://doc.rust-lang.org/unstable-book/
5897
5898
5899 Version 1.16.0 (2017-03-16)
5900 ===========================
5901
5902 Language
5903 --------
5904
5905 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5906 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5907   match patterns][38069]
5908 * [Clean up semantics of `self` in an import list][38313]
5909 * [`Self` may appear in `impl` headers][38920]
5910 * [`Self` may appear in struct expressions][39282]
5911
5912 Compiler
5913 --------
5914
5915 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5916   a `.rmeta` file containing only crate metadata][38571]. This can be
5917   used by tools like the Rust Language Service to perform
5918   metadata-only builds.
5919 * [Levenshtein based typo suggestions now work in most places, while
5920   previously they worked only for fields and sometimes for local
5921   variables][38927]. Together with the overhaul of "no
5922   resolution"/"unexpected resolution" errors (#[38154]) they result in
5923   large and systematic improvement in resolution diagnostics.
5924 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5925   `U`][38670]
5926 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5927 * [`rustc` no longer attempts to provide "consider using an explicit
5928   lifetime" suggestions][37057]. They were inaccurate.
5929
5930 Stabilized APIs
5931 ---------------
5932
5933 * [`VecDeque::truncate`]
5934 * [`VecDeque::resize`]
5935 * [`String::insert_str`]
5936 * [`Duration::checked_add`]
5937 * [`Duration::checked_sub`]
5938 * [`Duration::checked_div`]
5939 * [`Duration::checked_mul`]
5940 * [`str::replacen`]
5941 * [`str::repeat`]
5942 * [`SocketAddr::is_ipv4`]
5943 * [`SocketAddr::is_ipv6`]
5944 * [`IpAddr::is_ipv4`]
5945 * [`IpAddr::is_ipv6`]
5946 * [`Vec::dedup_by`]
5947 * [`Vec::dedup_by_key`]
5948 * [`Result::unwrap_or_default`]
5949 * [`<*const T>::wrapping_offset`]
5950 * [`<*mut T>::wrapping_offset`]
5951 * `CommandExt::creation_flags`
5952 * [`File::set_permissions`]
5953 * [`String::split_off`]
5954
5955 Libraries
5956 ---------
5957
5958 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5959   their argument by `Borrow` parameter][37761]
5960 * [All public types in std implement `Debug`][38006]
5961 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5962 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5963 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5964   Windows][38274]
5965 * [std: Fix partial writes in `LineWriter`][38062]
5966 * [std: Clamp max read/write sizes on Unix][38062]
5967 * [Use more specific panic message for `&str` slicing errors][38066]
5968 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5969   functionality cannot be achieved in std currently.
5970 * [`writeln!`, like `println!`, now accepts a form with no string
5971   or formatting arguments, to just print a newline][38469]
5972 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5973 * [Reduce the size of static data in `std_unicode::tables`][38781]
5974 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5975   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5976   `Display`][38909]
5977 * [`Duration` implements `Sum`][38712]
5978 * [`String` implements `ToSocketAddrs`][39048]
5979
5980 Cargo
5981 -----
5982
5983 * [The `cargo check` command does a type check of a project without
5984   building it][cargo/3296]
5985 * [crates.io will display CI badges from Travis and AppVeyor, if
5986   specified in Cargo.toml][cargo/3546]
5987 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5988 * [Compilation profiles accept integer values for `debug`, in addition
5989   to `true` and `false`. These are passed to `rustc` as the value to
5990   `-C debuginfo`][cargo/3534]
5991 * [Implement `cargo --version --verbose`][cargo/3604]
5992 * [All builds now output 'dep-info' build dependencies compatible with
5993   make and ninja][cargo/3557]
5994 * [Build all workspace members with `build --all`][cargo/3511]
5995 * [Document all workspace members with `doc --all`][cargo/3515]
5996 * [Path deps outside workspace are not members][cargo/3443]
5997
5998 Misc
5999 ----
6000
6001 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6002   the path to the Rust implementation][38589]
6003 * [The `armv7-linux-androideabi` target no longer enables NEON
6004   extensions, per Google's ABI guide][38413]
6005 * [The stock standard library can be compiled for Redox OS][38401]
6006 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6007   available.
6008 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6009   builds available.
6010 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6011
6012 Compatibility Notes
6013 -------------------
6014
6015 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6016   match patterns][38069]
6017 * In this release, references to uninhabited types can not be
6018   pattern-matched. This was accidentally allowed in 1.15.
6019 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6020 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6021   Windows][38274]
6022 * [Clean up semantics of `self` in an import list][38313]
6023 * Reimplemented lifetime elision. This change was almost entirely compatible
6024   with existing code, but it did close a number of small bugs and loopholes,
6025   as well as being more accepting in some other [cases][41105].
6026
6027 [37057]: https://github.com/rust-lang/rust/pull/37057
6028 [37761]: https://github.com/rust-lang/rust/pull/37761
6029 [38006]: https://github.com/rust-lang/rust/pull/38006
6030 [38051]: https://github.com/rust-lang/rust/pull/38051
6031 [38062]: https://github.com/rust-lang/rust/pull/38062
6032 [38062]: https://github.com/rust-lang/rust/pull/38622
6033 [38066]: https://github.com/rust-lang/rust/pull/38066
6034 [38069]: https://github.com/rust-lang/rust/pull/38069
6035 [38131]: https://github.com/rust-lang/rust/pull/38131
6036 [38154]: https://github.com/rust-lang/rust/pull/38154
6037 [38274]: https://github.com/rust-lang/rust/pull/38274
6038 [38304]: https://github.com/rust-lang/rust/pull/38304
6039 [38313]: https://github.com/rust-lang/rust/pull/38313
6040 [38314]: https://github.com/rust-lang/rust/pull/38314
6041 [38327]: https://github.com/rust-lang/rust/pull/38327
6042 [38401]: https://github.com/rust-lang/rust/pull/38401
6043 [38413]: https://github.com/rust-lang/rust/pull/38413
6044 [38469]: https://github.com/rust-lang/rust/pull/38469
6045 [38559]: https://github.com/rust-lang/rust/pull/38559
6046 [38571]: https://github.com/rust-lang/rust/pull/38571
6047 [38580]: https://github.com/rust-lang/rust/pull/38580
6048 [38589]: https://github.com/rust-lang/rust/pull/38589
6049 [38670]: https://github.com/rust-lang/rust/pull/38670
6050 [38712]: https://github.com/rust-lang/rust/pull/38712
6051 [38726]: https://github.com/rust-lang/rust/pull/38726
6052 [38781]: https://github.com/rust-lang/rust/pull/38781
6053 [38798]: https://github.com/rust-lang/rust/pull/38798
6054 [38909]: https://github.com/rust-lang/rust/pull/38909
6055 [38920]: https://github.com/rust-lang/rust/pull/38920
6056 [38927]: https://github.com/rust-lang/rust/pull/38927
6057 [39048]: https://github.com/rust-lang/rust/pull/39048
6058 [39282]: https://github.com/rust-lang/rust/pull/39282
6059 [39379]: https://github.com/rust-lang/rust/pull/39379
6060 [41105]: https://github.com/rust-lang/rust/issues/41105
6061 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6062 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6063 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6064 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6065 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6066 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6067 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6068 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6069 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6070 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6071 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6072 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6073 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6074 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6075 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6076 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6077 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6078 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6079 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6080 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6081 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6082 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6083 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6084 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6085 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6086 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6087 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6088 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6089 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6090 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6091
6092
6093 Version 1.15.1 (2017-02-09)
6094 ===========================
6095
6096 * [Fix IntoIter::as_mut_slice's signature][39466]
6097 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6098
6099 [39466]: https://github.com/rust-lang/rust/pull/39466
6100 [39523]: https://github.com/rust-lang/rust/pull/39523
6101
6102
6103 Version 1.15.0 (2017-02-02)
6104 ===========================
6105
6106 Language
6107 --------
6108
6109 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6110   stable. This allows popular code-generating crates like Serde and Diesel to
6111   work ergonomically. [RFC 1681].
6112 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6113   with curly braces][36868]. Part of [RFC 1506].
6114 * [A number of minor changes to name resolution have been activated][37127].
6115   They add up to more consistent semantics, allowing for future evolution of
6116   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6117   details of what is different. The breaking changes here have been transitioned
6118   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6119 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6120   bounds][38279]
6121 * [`?Sized` can be used in `where` clauses][37791]
6122 * [There is now a limit on the size of monomorphized types and it can be
6123   modified with the `#![type_size_limit]` crate attribute, similarly to
6124   the `#![recursion_limit]` attribute][37789]
6125
6126 Compiler
6127 --------
6128
6129 * [On Windows, the compiler will apply dllimport attributes when linking to
6130   extern functions][37973]. Additional attributes and flags can control which
6131   library kind is linked and its name. [RFC 1717].
6132 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6133 * [The `--test` flag works with procedural macro crates][38107]
6134 * [Fix `extern "aapcs" fn` ABI][37814]
6135 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6136 * [The `format!` expander recognizes incorrect `printf` and shell-style
6137   formatting directives and suggests the correct format][37613].
6138 * [Only report one error for all unused imports in an import list][37456]
6139
6140 Compiler Performance
6141 --------------------
6142
6143 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6144 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6145 * [Don't clone in `UnificationTable::probe`][37848]
6146 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6147 * [Use small vectors in type walker][37760]
6148 * [Macro expansion performance was improved][37701]
6149 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6150 * [Replace FNV with a faster hash function][37229]
6151
6152 Stabilized APIs
6153 ---------------
6154
6155 * [`std::iter::Iterator::min_by`]
6156 * [`std::iter::Iterator::max_by`]
6157 * [`std::os::*::fs::FileExt`]
6158 * [`std::sync::atomic::Atomic*::get_mut`]
6159 * [`std::sync::atomic::Atomic*::into_inner`]
6160 * [`std::vec::IntoIter::as_slice`]
6161 * [`std::vec::IntoIter::as_mut_slice`]
6162 * [`std::sync::mpsc::Receiver::try_iter`]
6163 * [`std::os::unix::process::CommandExt::before_exec`]
6164 * [`std::rc::Rc::strong_count`]
6165 * [`std::rc::Rc::weak_count`]
6166 * [`std::sync::Arc::strong_count`]
6167 * [`std::sync::Arc::weak_count`]
6168 * [`std::char::encode_utf8`]
6169 * [`std::char::encode_utf16`]
6170 * [`std::cell::Ref::clone`]
6171 * [`std::io::Take::into_inner`]
6172
6173 Libraries
6174 ---------
6175
6176 * [The standard sorting algorithm has been rewritten for dramatic performance
6177   improvements][38192]. It is a hybrid merge sort, drawing influences from
6178   Timsort. Previously it was a naive merge sort.
6179 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6180 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6181   performance.
6182 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6183   and `char_indices().last()`][37882]
6184 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6185 * [Chinese characters display correctly in `fmt::Debug`][37855]
6186 * [Derive `Default` for `Duration`][37699]
6187 * [Support creation of anonymous pipes on WinXP/2k][37677]
6188 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6189 * [Don't pass overlapped handles to processes][38835]
6190
6191 Cargo
6192 -----
6193
6194 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6195   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6196   should instead check the variable at runtime with `std::env`. That the value
6197   was set at build time was a bug, and incorrect when cross-compiling. This
6198   change is known to cause breakage.
6199 * [Add `--all` flag to `cargo test`][cargo/3221]
6200 * [Compile statically against the MSVC CRT][cargo/3363]
6201 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6202 * [Link OpenSSL statically on OSX][cargo/3311]
6203 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6204 * [Test for bad path overrides with summaries][cargo/3336]
6205 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6206 * [Fix retrying crate downloads for network errors][cargo/3348]
6207 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6208 * [Emit more info on --message-format=json][cargo/3319]
6209 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6210 * [Don't ignore errors in workspace manifest][cargo/3409]
6211 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6212
6213 Tooling
6214 -------
6215
6216 * [Test runners (binaries built with `--test`) now support a `--list` argument
6217   that lists the tests it contains][38185]
6218 * [Test runners now support a `--exact` argument that makes the test filter
6219   match exactly, instead of matching only a substring of the test name][38181]
6220 * [rustdoc supports a `--playground-url` flag][37763]
6221 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6222
6223 Misc
6224 ----
6225
6226 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6227   continue to be used in this release by passing `--disable-rustbuild` to the
6228   configure script, but they will be deleted soon. Note that the new build
6229   system uses a different on-disk layout that will likely affect any scripts
6230   building Rust.
6231 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6232   releases.
6233 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6234 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6235   releases.
6236
6237 Compatibility Notes
6238 -------------------
6239
6240 * [A number of minor changes to name resolution have been activated][37127].
6241   They add up to more consistent semantics, allowing for future evolution of
6242   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6243   details of what is different. The breaking changes here have been transitioned
6244   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6245 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6246   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6247   should instead check the variable at runtime with `std::env`. That the value
6248   was set at build time was a bug, and incorrect when cross-compiling. This
6249   change is known to cause breakage.
6250 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6251   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6252   1.10 and is now an error by default. It will become a hard error in the near
6253   future.
6254 * [The semantics relating modules to file system directories are changing in
6255   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6256   lint, which is a warning in this release, and will become a hard error in the
6257   future.
6258 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6259 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6260   the underlying iterator][37834]
6261
6262 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6263 [33685]: https://github.com/rust-lang/rust/issues/33685
6264 [36868]: https://github.com/rust-lang/rust/pull/36868
6265 [37127]: https://github.com/rust-lang/rust/pull/37127
6266 [37229]: https://github.com/rust-lang/rust/pull/37229
6267 [37456]: https://github.com/rust-lang/rust/pull/37456
6268 [37527]: https://github.com/rust-lang/rust/pull/37527
6269 [37602]: https://github.com/rust-lang/rust/pull/37602
6270 [37613]: https://github.com/rust-lang/rust/pull/37613
6271 [37615]: https://github.com/rust-lang/rust/pull/37615
6272 [37636]: https://github.com/rust-lang/rust/pull/37636
6273 [37627]: https://github.com/rust-lang/rust/pull/37627
6274 [37642]: https://github.com/rust-lang/rust/pull/37642
6275 [37677]: https://github.com/rust-lang/rust/pull/37677
6276 [37699]: https://github.com/rust-lang/rust/pull/37699
6277 [37701]: https://github.com/rust-lang/rust/pull/37701
6278 [37705]: https://github.com/rust-lang/rust/pull/37705
6279 [37749]: https://github.com/rust-lang/rust/pull/37749
6280 [37760]: https://github.com/rust-lang/rust/pull/37760
6281 [37763]: https://github.com/rust-lang/rust/pull/37763
6282 [37764]: https://github.com/rust-lang/rust/pull/37764
6283 [37789]: https://github.com/rust-lang/rust/pull/37789
6284 [37791]: https://github.com/rust-lang/rust/pull/37791
6285 [37814]: https://github.com/rust-lang/rust/pull/37814
6286 [37817]: https://github.com/rust-lang/rust/pull/37817
6287 [37834]: https://github.com/rust-lang/rust/pull/37834
6288 [37848]: https://github.com/rust-lang/rust/pull/37848
6289 [37855]: https://github.com/rust-lang/rust/pull/37855
6290 [37882]: https://github.com/rust-lang/rust/pull/37882
6291 [37888]: https://github.com/rust-lang/rust/pull/37888
6292 [37973]: https://github.com/rust-lang/rust/pull/37973
6293 [37979]: https://github.com/rust-lang/rust/pull/37979
6294 [38086]: https://github.com/rust-lang/rust/pull/38086
6295 [38107]: https://github.com/rust-lang/rust/pull/38107
6296 [38117]: https://github.com/rust-lang/rust/pull/38117
6297 [38134]: https://github.com/rust-lang/rust/pull/38134
6298 [38146]: https://github.com/rust-lang/rust/pull/38146
6299 [38181]: https://github.com/rust-lang/rust/pull/38181
6300 [38182]: https://github.com/rust-lang/rust/pull/38182
6301 [38185]: https://github.com/rust-lang/rust/pull/38185
6302 [38192]: https://github.com/rust-lang/rust/pull/38192
6303 [38279]: https://github.com/rust-lang/rust/pull/38279
6304 [38835]: https://github.com/rust-lang/rust/pull/38835
6305 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6306 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6307 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6308 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6309 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6310 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6311 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6312 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6313 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6314 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6315 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6316 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6317 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6318 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6319 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6320 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6321 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6322 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6323 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6324 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6325 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6326 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6327 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6328 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6329 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6330 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6331 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6332 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6333 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6334 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6335 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6336 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6337 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6338 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6339 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6340 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6341 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6342 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6343
6344
6345 Version 1.14.0 (2016-12-22)
6346 ===========================
6347
6348 Language
6349 --------
6350
6351 * [`..` matches multiple tuple fields in enum variants, structs
6352   and tuples][36843]. [RFC 1492].
6353 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6354 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6355 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6356   dereferencing][36822]
6357
6358 Compiler
6359 --------
6360
6361 * [Mark enums with non-zero discriminant as non-zero][37224]
6362 * [Lower-case `static mut` names are linted like other
6363   statics and consts][37162]
6364 * [Fix ICE on some macros in const integer positions
6365    (e.g. `[u8; m!()]`)][36819]
6366 * [Improve error message and snippet for "did you mean `x`"][36798]
6367 * [Add a panic-strategy field to the target specification][36794]
6368 * [Include LLVM version in `--version --verbose`][37200]
6369
6370 Compile-time Optimizations
6371 --------------------------
6372
6373 * [Improve macro expansion performance][37569]
6374 * [Shrink `Expr_::ExprInlineAsm`][37445]
6375 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6376 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6377 * [Avoid more allocations when compiling html5ever][37373]
6378 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6379 * [Avoid some allocations in the macro parser][37318]
6380 * [Use a faster deflate setting][37298]
6381 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6382   during interning of slices][37270]
6383 * [Optimize `write_metadata`][37267]
6384 * [Don't process obligation forest cycles when stalled][37231]
6385 * [Avoid many `CrateConfig` clones][37161]
6386 * [Optimize `Substs::super_fold_with`][37108]
6387 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6388 * [Speed up `plug_leaks`][36917]
6389
6390 Libraries
6391 ---------
6392
6393 * [`println!()`, with no arguments, prints newline][36825].
6394   Previously, an empty string was required to achieve the same.
6395 * [`Wrapping` impls standard binary and unary operators, as well as
6396    the `Sum` and `Product` iterators][37356]
6397 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6398   Vec<T>`][37326]
6399 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6400   `VecDeque` iterators][37315]
6401 * [Improve `SipHasher` performance on small values][37312]
6402 * [Add Iterator trait TrustedLen to enable better FromIterator /
6403   Extend][37306]
6404 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6405 * [`ReadDir` implements `Debug`][37221]
6406 * [Implement `RefUnwindSafe` for atomic types][37178]
6407 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6408 * [Avoid allocations in `Decoder::read_str`][37064]
6409 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6410 * [Impl `Debug` for raw pointers to unsized data][36880]
6411 * [Don't reuse `HashMap` random seeds][37470]
6412 * [The internal memory layout of `HashMap` is more cache-friendly, for
6413   significant improvements in some operations][36692]
6414 * [`HashMap` uses less memory on 32-bit architectures][36595]
6415 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6416
6417 Cargo
6418 -----
6419
6420 * [Expose rustc cfg values to build scripts][cargo/3243]
6421 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6422 * [Fix passing --features when testing multiple packages][cargo/3280]
6423 * [Use a single profile set per workspace][cargo/3249]
6424 * [Load `replace` sections from lock files][cargo/3220]
6425 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6426
6427 Tooling
6428 -------
6429
6430 * [rustup is the recommended Rust installation method][1.14rustup]
6431 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6432   S390x. These are [tier 2] platforms and may have major defects. Follow the
6433   instructions on the website to install, or add the targets to an existing
6434   installation with `rustup target add`. The new target triples are:
6435   - `mips-unknown-linux-gnu`
6436   - `mipsel-unknown-linux-gnu`
6437   - `mips64-unknown-linux-gnuabi64`
6438   - `mips64el-unknown-linux-gnuabi64 `
6439   - `powerpc-unknown-linux-gnu`
6440   - `powerpc64-unknown-linux-gnu`
6441   - `powerpc64le-unknown-linux-gnu`
6442   - `s390x-unknown-linux-gnu `
6443 * This release includes target (std) builds for ARM Linux running MUSL
6444   libc. These are [tier 2] platforms and may have major defects. Add the
6445   following triples to an existing rustup installation with `rustup target add`:
6446   - `arm-unknown-linux-musleabi`
6447   - `arm-unknown-linux-musleabihf`
6448   - `armv7-unknown-linux-musleabihf`
6449 * This release includes [experimental support for WebAssembly][1.14wasm], via
6450   the `wasm32-unknown-emscripten` target. This target is known to have major
6451   defects. Please test, report, and fix.
6452 * rustup no longer installs documentation by default. Run `rustup
6453   component add rust-docs` to install.
6454 * [Fix line stepping in debugger][37310]
6455 * [Enable line number debuginfo in releases][37280]
6456
6457 Misc
6458 ----
6459
6460 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6461 * [Add support for Fuchsia OS][37313]
6462 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6463
6464 Compatibility Notes
6465 -------------------
6466
6467 * [A number of forward-compatibility lints used by the compiler
6468   to gradually introduce language changes have been converted
6469   to deny by default][36894]:
6470   - ["use of inaccessible extern crate erroneously allowed"][36886]
6471   - ["type parameter default erroneously allowed in invalid location"][36887]
6472   - ["detects super or self keywords at the beginning of global path"][36888]
6473   - ["two overlapping inherent impls define an item with the same name
6474     were erroneously allowed"][36889]
6475   - ["floating-point constants cannot be used in patterns"][36890]
6476   - ["constants of struct or enum type can only be used in a pattern if
6477      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6478   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6479 * [Prohibit patterns in trait methods without bodies][37378]
6480 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6481 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6482 * [The `$crate` macro variable is accepted in fewer locations][37213]
6483 * [Impls specifying extra region requirements beyond the trait
6484   they implement are rejected][37167]
6485 * [Enums may not be unsized][37111]. Unsized enums are intended to
6486   work but never have. For now they are forbidden.
6487 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6488
6489 [tier 2]: https://forge.rust-lang.org/platform-support.html
6490 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6491 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6492 [36430]: https://github.com/rust-lang/rust/pull/36430
6493 [36595]: https://github.com/rust-lang/rust/pull/36595
6494 [36595]: https://github.com/rust-lang/rust/pull/36595
6495 [36692]: https://github.com/rust-lang/rust/pull/36692
6496 [36767]: https://github.com/rust-lang/rust/pull/36767
6497 [36794]: https://github.com/rust-lang/rust/pull/36794
6498 [36798]: https://github.com/rust-lang/rust/pull/36798
6499 [36819]: https://github.com/rust-lang/rust/pull/36819
6500 [36822]: https://github.com/rust-lang/rust/pull/36822
6501 [36825]: https://github.com/rust-lang/rust/pull/36825
6502 [36843]: https://github.com/rust-lang/rust/pull/36843
6503 [36880]: https://github.com/rust-lang/rust/pull/36880
6504 [36886]: https://github.com/rust-lang/rust/issues/36886
6505 [36887]: https://github.com/rust-lang/rust/issues/36887
6506 [36888]: https://github.com/rust-lang/rust/issues/36888
6507 [36889]: https://github.com/rust-lang/rust/issues/36889
6508 [36890]: https://github.com/rust-lang/rust/issues/36890
6509 [36891]: https://github.com/rust-lang/rust/issues/36891
6510 [36892]: https://github.com/rust-lang/rust/issues/36892
6511 [36894]: https://github.com/rust-lang/rust/pull/36894
6512 [36917]: https://github.com/rust-lang/rust/pull/36917
6513 [36993]: https://github.com/rust-lang/rust/pull/36993
6514 [37037]: https://github.com/rust-lang/rust/pull/37037
6515 [37064]: https://github.com/rust-lang/rust/pull/37064
6516 [37094]: https://github.com/rust-lang/rust/pull/37094
6517 [37108]: https://github.com/rust-lang/rust/pull/37108
6518 [37111]: https://github.com/rust-lang/rust/pull/37111
6519 [37161]: https://github.com/rust-lang/rust/pull/37161
6520 [37162]: https://github.com/rust-lang/rust/pull/37162
6521 [37167]: https://github.com/rust-lang/rust/pull/37167
6522 [37178]: https://github.com/rust-lang/rust/pull/37178
6523 [37200]: https://github.com/rust-lang/rust/pull/37200
6524 [37213]: https://github.com/rust-lang/rust/pull/37213
6525 [37221]: https://github.com/rust-lang/rust/pull/37221
6526 [37224]: https://github.com/rust-lang/rust/pull/37224
6527 [37230]: https://github.com/rust-lang/rust/pull/37230
6528 [37231]: https://github.com/rust-lang/rust/pull/37231
6529 [37247]: https://github.com/rust-lang/rust/pull/37247
6530 [37267]: https://github.com/rust-lang/rust/pull/37267
6531 [37270]: https://github.com/rust-lang/rust/pull/37270
6532 [37273]: https://github.com/rust-lang/rust/pull/37273
6533 [37280]: https://github.com/rust-lang/rust/pull/37280
6534 [37298]: https://github.com/rust-lang/rust/pull/37298
6535 [37306]: https://github.com/rust-lang/rust/pull/37306
6536 [37310]: https://github.com/rust-lang/rust/pull/37310
6537 [37312]: https://github.com/rust-lang/rust/pull/37312
6538 [37313]: https://github.com/rust-lang/rust/pull/37313
6539 [37315]: https://github.com/rust-lang/rust/pull/37315
6540 [37318]: https://github.com/rust-lang/rust/pull/37318
6541 [37322]: https://github.com/rust-lang/rust/pull/37322
6542 [37326]: https://github.com/rust-lang/rust/pull/37326
6543 [37351]: https://github.com/rust-lang/rust/pull/37351
6544 [37356]: https://github.com/rust-lang/rust/pull/37356
6545 [37367]: https://github.com/rust-lang/rust/pull/37367
6546 [37373]: https://github.com/rust-lang/rust/pull/37373
6547 [37378]: https://github.com/rust-lang/rust/pull/37378
6548 [37389]: https://github.com/rust-lang/rust/pull/37389
6549 [37392]: https://github.com/rust-lang/rust/pull/37392
6550 [37427]: https://github.com/rust-lang/rust/pull/37427
6551 [37439]: https://github.com/rust-lang/rust/pull/37439
6552 [37445]: https://github.com/rust-lang/rust/pull/37445
6553 [37470]: https://github.com/rust-lang/rust/pull/37470
6554 [37569]: https://github.com/rust-lang/rust/pull/37569
6555 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6556 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6557 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6558 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6559 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6560 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6561 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6562
6563
6564 Version 1.13.0 (2016-11-10)
6565 ===========================
6566
6567 Language
6568 --------
6569
6570 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6571   errors, like the `try!` macro, described in [RFC 0243].
6572 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6573 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6574 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6575 * [Fix lifetime rules for 'if' conditions][36029]
6576 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6577
6578 Compiler
6579 --------
6580
6581 * [Add the `-C link-arg` argument][36574]
6582 * [Remove the old AST-based backend from rustc_trans][35764]
6583 * [Don't enable NEON by default on armv7 Linux][35814]
6584 * [Fix debug line number info for macro expansions][35238]
6585 * [Do not emit "class method" debuginfo for types that are not
6586   DICompositeType][36008]
6587 * [Warn about multiple conflicting #[repr] hints][34623]
6588 * [When sizing DST, don't double-count nested struct prefixes][36351]
6589 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6590 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6591 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6592 * [Expand macros without recursing to avoid stack overflows][36214]
6593
6594 Diagnostics
6595 -----------
6596
6597 * [Replace macro backtraces with labeled local uses][35702]
6598 * [Improve error message for misplaced doc comments][33922]
6599 * [Buffer unix and lock windows to prevent message interleaving][35975]
6600 * [Update lifetime errors to specifically note temporaries][36171]
6601 * [Special case a few colors for Windows][36178]
6602 * [Suggest `use self` when such an import resolves][36289]
6603 * [Be more specific when type parameter shadows primitive type][36338]
6604 * Many minor improvements
6605
6606 Compile-time Optimizations
6607 --------------------------
6608
6609 * [Compute and cache HIR hashes at beginning][35854]
6610 * [Don't hash types in loan paths][36004]
6611 * [Cache projections in trans][35761]
6612 * [Optimize the parser's last token handling][36527]
6613 * [Only instantiate #[inline] functions in codegen units referencing
6614   them][36524]. This leads to big improvements in cases where crates export
6615   define many inline functions without using them directly.
6616 * [Lazily allocate TypedArena's first chunk][36592]
6617 * [Don't allocate during default HashSet creation][36734]
6618
6619 Stabilized APIs
6620 ---------------
6621
6622 * [`checked_abs`]
6623 * [`wrapping_abs`]
6624 * [`overflowing_abs`]
6625 * [`RefCell::try_borrow`]
6626 * [`RefCell::try_borrow_mut`]
6627
6628 Libraries
6629 ---------
6630
6631 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6632 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6633   covariant][35354]
6634 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6635 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6636 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6637 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6638 * [Use arc4rand on FreeBSD][35884]
6639 * [memrchr: Correct aligned offset computation][35969]
6640 * [Improve Demangling of Rust Symbols][36059]
6641 * [Use monotonic time in condition variables][35048]
6642 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6643 * [Implement conversion traits for `char`][35755]
6644 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6645 * [Zero first byte of CString on drop][36264]
6646 * [Inherit overflow checks for sum and product][36372]
6647 * [Add missing Eq implementations][36423]
6648 * [Implement `Debug` for `DirEntry`][36631]
6649 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6650   `errno`][36754]
6651 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6652 * [Implement more traits for `std::io::ErrorKind`][35911]
6653 * [Optimize BinaryHeap bounds checking][36072]
6654 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6655   `extend_with_element`][36355]
6656 * [Fix overflow checking in unsigned pow()][34942]
6657
6658 Cargo
6659 -----
6660
6661 * This release includes security fixes to both curl and OpenSSL.
6662 * [Fix transitive doctests when panic=abort][cargo/3021]
6663 * [Add --all-features flag to cargo][cargo/3038]
6664 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6665 * [Don't parse the home directory more than once][cargo/3078]
6666 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6667 * [Update OpenSSL to 1.0.2j][cargo/3121]
6668 * [Add license and license_file to cargo metadata output][cargo/3110]
6669 * [Make crates-io registry URL optional in config; ignore all changes to
6670   source.crates-io][cargo/3089]
6671 * [Don't download dependencies from other platforms][cargo/3123]
6672 * [Build transitive dev-dependencies when needed][cargo/3125]
6673 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6674 * [Avoid updating registry when adding existing deps][cargo/3144]
6675 * [Warn about path overrides that won't work][cargo/3136]
6676 * [Use workspaces during `cargo install`][cargo/3146]
6677 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6678 * [Add --message-format flag][cargo/3000]
6679 * [Pass target environment for rustdoc][cargo/3205]
6680 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6681 * [Update curl and curl-sys][cargo/3241]
6682 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6683
6684 Tooling
6685 -------
6686
6687 * [rustdoc: Add the `--sysroot` argument][36586]
6688 * [rustdoc: Fix a couple of issues with the search results][35655]
6689 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6690 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6691 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6692
6693 Misc
6694 ----
6695
6696 * [Remove unmaintained style guide][35124]
6697 * [Add s390x support][36369]
6698 * [Initial work at Haiku OS support][36727]
6699 * [Add mips-uclibc targets][35734]
6700 * [Crate-ify compiler-rt into compiler-builtins][35021]
6701 * [Add rustc version info (git hash + date) to dist tarball][36213]
6702 * Many documentation improvements
6703
6704 Compatibility Notes
6705 -------------------
6706
6707 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6708 * [Deny (by default) transmuting from fn item types to pointer-sized
6709   types][34923]. Continuing the long transition to zero-sized fn items,
6710   per [RFC 401].
6711 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6712   Part of [RFC 1506].
6713 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6714 * [Fix lifetime rules for 'if' conditions][36029].
6715 * [Inherit overflow checks for sum and product][36372].
6716 * [Forbid user-defined macros named "macro_rules"][36730].
6717
6718 [33922]: https://github.com/rust-lang/rust/pull/33922
6719 [34623]: https://github.com/rust-lang/rust/pull/34623
6720 [34923]: https://github.com/rust-lang/rust/pull/34923
6721 [34942]: https://github.com/rust-lang/rust/pull/34942
6722 [34982]: https://github.com/rust-lang/rust/pull/34982
6723 [35021]: https://github.com/rust-lang/rust/pull/35021
6724 [35048]: https://github.com/rust-lang/rust/pull/35048
6725 [35074]: https://github.com/rust-lang/rust/pull/35074
6726 [35124]: https://github.com/rust-lang/rust/pull/35124
6727 [35234]: https://github.com/rust-lang/rust/pull/35234
6728 [35238]: https://github.com/rust-lang/rust/pull/35238
6729 [35354]: https://github.com/rust-lang/rust/pull/35354
6730 [35559]: https://github.com/rust-lang/rust/pull/35559
6731 [35585]: https://github.com/rust-lang/rust/pull/35585
6732 [35627]: https://github.com/rust-lang/rust/pull/35627
6733 [35655]: https://github.com/rust-lang/rust/pull/35655
6734 [35702]: https://github.com/rust-lang/rust/pull/35702
6735 [35707]: https://github.com/rust-lang/rust/pull/35707
6736 [35728]: https://github.com/rust-lang/rust/pull/35728
6737 [35734]: https://github.com/rust-lang/rust/pull/35734
6738 [35755]: https://github.com/rust-lang/rust/pull/35755
6739 [35761]: https://github.com/rust-lang/rust/pull/35761
6740 [35764]: https://github.com/rust-lang/rust/pull/35764
6741 [35814]: https://github.com/rust-lang/rust/pull/35814
6742 [35854]: https://github.com/rust-lang/rust/pull/35854
6743 [35871]: https://github.com/rust-lang/rust/pull/35871
6744 [35884]: https://github.com/rust-lang/rust/pull/35884
6745 [35911]: https://github.com/rust-lang/rust/pull/35911
6746 [35969]: https://github.com/rust-lang/rust/pull/35969
6747 [35975]: https://github.com/rust-lang/rust/pull/35975
6748 [36004]: https://github.com/rust-lang/rust/pull/36004
6749 [36008]: https://github.com/rust-lang/rust/pull/36008
6750 [36014]: https://github.com/rust-lang/rust/pull/36014
6751 [36029]: https://github.com/rust-lang/rust/pull/36029
6752 [36059]: https://github.com/rust-lang/rust/pull/36059
6753 [36072]: https://github.com/rust-lang/rust/pull/36072
6754 [36101]: https://github.com/rust-lang/rust/pull/36101
6755 [36104]: https://github.com/rust-lang/rust/pull/36104
6756 [36171]: https://github.com/rust-lang/rust/pull/36171
6757 [36173]: https://github.com/rust-lang/rust/pull/36173
6758 [36178]: https://github.com/rust-lang/rust/pull/36178
6759 [36213]: https://github.com/rust-lang/rust/pull/36213
6760 [36214]: https://github.com/rust-lang/rust/pull/36214
6761 [36264]: https://github.com/rust-lang/rust/pull/36264
6762 [36266]: https://github.com/rust-lang/rust/pull/36266
6763 [36289]: https://github.com/rust-lang/rust/pull/36289
6764 [36338]: https://github.com/rust-lang/rust/pull/36338
6765 [36351]: https://github.com/rust-lang/rust/pull/36351
6766 [36355]: https://github.com/rust-lang/rust/pull/36355
6767 [36369]: https://github.com/rust-lang/rust/pull/36369
6768 [36372]: https://github.com/rust-lang/rust/pull/36372
6769 [36423]: https://github.com/rust-lang/rust/pull/36423
6770 [36482]: https://github.com/rust-lang/rust/pull/36482
6771 [36505]: https://github.com/rust-lang/rust/pull/36505
6772 [36524]: https://github.com/rust-lang/rust/pull/36524
6773 [36527]: https://github.com/rust-lang/rust/pull/36527
6774 [36551]: https://github.com/rust-lang/rust/pull/36551
6775 [36574]: https://github.com/rust-lang/rust/pull/36574
6776 [36586]: https://github.com/rust-lang/rust/pull/36586
6777 [36592]: https://github.com/rust-lang/rust/pull/36592
6778 [36631]: https://github.com/rust-lang/rust/pull/36631
6779 [36639]: https://github.com/rust-lang/rust/pull/36639
6780 [36721]: https://github.com/rust-lang/rust/pull/36721
6781 [36727]: https://github.com/rust-lang/rust/pull/36727
6782 [36730]: https://github.com/rust-lang/rust/pull/36730
6783 [36734]: https://github.com/rust-lang/rust/pull/36734
6784 [36754]: https://github.com/rust-lang/rust/pull/36754
6785 [36995]: https://github.com/rust-lang/rust/pull/36995
6786 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6787 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6788 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6789 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6790 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6791 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6792 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6793 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6794 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6795 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6796 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6797 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6798 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6799 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6800 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6801 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6802 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6803 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6804 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6805 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6806 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6807 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6808 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6809 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6810 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6811 [rustup]: https://www.rustup.rs
6812 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6813 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6814 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6815 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6816 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6817 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6818 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6819
6820
6821 Version 1.12.1 (2016-10-20)
6822 ===========================
6823
6824 Regression Fixes
6825 ----------------
6826
6827 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6828 * [Confusion with double negation and booleans][36856]
6829 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6830 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6831 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6832 * [Corrupted memory after updated to 1.12][36936]
6833 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6834 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6835 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6836
6837 [36381]: https://github.com/rust-lang/rust/issues/36381
6838 [36856]: https://github.com/rust-lang/rust/issues/36856
6839 [36875]: https://github.com/rust-lang/rust/issues/36875
6840 [36924]: https://github.com/rust-lang/rust/issues/36924
6841 [36926]: https://github.com/rust-lang/rust/issues/36926
6842 [36936]: https://github.com/rust-lang/rust/issues/36936
6843 [37026]: https://github.com/rust-lang/rust/issues/37026
6844 [37112]: https://github.com/rust-lang/rust/issues/37112
6845 [37153]: https://github.com/rust-lang/rust/issues/37153
6846
6847
6848 Version 1.12.0 (2016-09-29)
6849 ===========================
6850
6851 Highlights
6852 ----------
6853
6854 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6855   This translation pass is far simpler than the previous AST->LLVM pass, and
6856   creates opportunities to perform new optimizations directly on the MIR. It
6857   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6858 * [`rustc` presents a new, more readable error format, along with
6859   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6860   Most common editors supporting Rust have been updated to work with it. It was
6861   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6862
6863 Compiler
6864 --------
6865
6866 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6867   This translation pass is far simpler than the previous AST->LLVM pass, and
6868   creates opportunities to perform new optimizations directly on the MIR. It
6869   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6870 * [Print the Rust target name, not the LLVM target name, with
6871   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6872 * [The computation of `TypeId` is correct in some cases where it was previously
6873   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6874 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6875 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6876   `--print relocation-models`, and `--print code-models` print the available
6877   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6878   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6879 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6880   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6881   These targets produce statically-linked binaries. There are no binary release
6882   builds yet though.
6883
6884 Diagnostics
6885 -----------
6886
6887 * [`rustc` presents a new, more readable error format, along with
6888   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6889   Most common editors supporting Rust have been updated to work with it. It was
6890   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6891 * [In error descriptions, references are now described in plain English,
6892   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6893 * [In error type descriptions, unknown numeric types are named `{integer}` or
6894   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6895 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6896
6897 Language
6898 --------
6899
6900 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6901 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6902 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6903   useful](https://github.com/rust-lang/rust/pull/34908)
6904 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6905   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6906 * [Semicolons are properly required as statement delimiters inside
6907   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6908 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6909
6910 Stabilized APIs
6911 ---------------
6912
6913 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6914 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6915 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6916 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6917 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6918 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6919 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6920 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6921 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6922 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6923   Both on Unix and Windows.
6924 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6925 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6926 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6927 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6928 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6929 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6930 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6931 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6932
6933 Libraries
6934 ---------
6935
6936 * [The `format!` macro and friends now allow a single argument to be formatted
6937   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6938 * [The lifetime bounds on `[T]::binary_search_by` and
6939   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6940 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6941 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6942 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6943 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6944 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6945 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6946 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6947 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6948   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6949 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6950   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6951 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6952 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6953   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6954 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6955 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6956 * [`mpsc::sync_channel` `Receiver`s return any available message before
6957   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6958 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6959 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6960
6961 Cargo
6962 -----
6963
6964 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6965 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6966 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6967 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6968 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6969 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6970 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6971 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6972 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6973 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6974 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6975 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6976 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6977 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6978 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6979 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6980
6981 Performance
6982 -----------
6983
6984 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6985 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6986
6987 Tooling
6988 -------
6989
6990 * [Test binaries now support a `--test-threads` argument to specify the number
6991   of threads used to run tests, and which acts the same as the
6992   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6993 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6994 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6995 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6996 * [Rust releases now come with source packages that can be installed by rustup
6997   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6998   The resulting source code can be used by tools and IDES, located in the
6999   sysroot under `lib/rustlib/src`.
7000
7001 Misc
7002 ----
7003
7004 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7005 * Many minor improvements to the documentation.
7006 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7007
7008 Compatibility Notes
7009 -------------------
7010
7011 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7012   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7013 * [When formatting strings, if "precision" is specified, the "fill",
7014   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7015 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7016
7017
7018 Version 1.11.0 (2016-08-18)
7019 ===========================
7020
7021 Language
7022 --------
7023
7024 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7025 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7026 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7027 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7028
7029 Stabilized APIs
7030 ---------------
7031
7032 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7033 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7034 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7035 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7036 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7037 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7038   (in libcore - previously stabilized in libstd)
7039 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7040   (in libcore - previously stabilized in libstd)
7041 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7042   (in libcore - previously stabilized in libstd)
7043 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7044   (in libcore - previously stabilized in libstd)
7045 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7046 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7047 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7048 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7049
7050 Libraries
7051 ---------
7052
7053 * [The `thread_local!` macro supports multiple definitions in a single
7054    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7055 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7056 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7057   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7058 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7059 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7060 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7061 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7062
7063 Cargo
7064 -----
7065
7066 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7067 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7068 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7069 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7070 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7071   and `-vv` prints warnings for all crates.
7072 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7073 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7074   This provides room for expansion by arbitrary tools.
7075 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7076 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7077 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7078 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7079 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7080 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7081 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7082
7083 Performance
7084 -----------
7085
7086 * [Caching projections speeds up type check dramatically for some
7087   workloads](https://github.com/rust-lang/rust/pull/33816)
7088 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7089   This hasher is faster, but is believed to provide sufficient
7090   protection from collision attacks.
7091 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7092
7093 Rustdoc
7094 -------
7095
7096 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7097 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7098 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7099 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7100 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7101
7102 Tooling
7103 -------
7104
7105 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7106 * [When emitting debug info, rustc emits frame pointers for closures,
7107   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7108 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7109 * Many more errors have been given error codes and extended
7110   explanations
7111 * API documentation continues to be improved, with many new examples
7112
7113 Misc
7114 ----
7115
7116 * [rustc no longer hangs when dependencies recursively re-export
7117   submodules](https://github.com/rust-lang/rust/pull/34542)
7118 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7119 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7120   rewritten](https://github.com/rust-lang/rust/pull/33895)
7121 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7122   No targets use this yet, but it works toward AVR support.
7123
7124 Compatibility Notes
7125 -------------------
7126
7127 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7128 * [The new follow-set rules that place restrictions on `macro_rules!`
7129   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7130   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7131   and has been a warning since 1.10.
7132 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7133   This causes breakage in some corner cases.
7134
7135
7136 Version 1.10.0 (2016-07-07)
7137 ===========================
7138
7139 Language
7140 --------
7141
7142 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7143   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7144 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7145 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7146 * [`panic!` can be converted to a runtime abort with the
7147   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7148   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7149 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7150   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7151   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7152   Note that Cargo does not yet directly support cdylibs.
7153
7154 Stabilized APIs
7155 ---------------
7156
7157 * `os::windows::fs::OpenOptionsExt::access_mode`
7158 * `os::windows::fs::OpenOptionsExt::share_mode`
7159 * `os::windows::fs::OpenOptionsExt::custom_flags`
7160 * `os::windows::fs::OpenOptionsExt::attributes`
7161 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7162 * `os::unix::fs::OpenOptionsExt::custom_flags`
7163 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7164 * `Default for sync::Weak`
7165 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7166 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7167 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7168 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7169 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7170 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7171 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7172 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7173 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7174 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7175 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7176 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7177 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7178 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7179 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7180 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7181 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7182 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7183 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7184 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7185 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7186 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7187 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7188 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7189 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7190 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7191 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7192 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7193 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7194 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7195 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7196 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7197 * Read/Write/RawFd impls for `UnixStream`
7198 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7199 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7200 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7201 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7202 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7203 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7204 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7205 * RawFd impls for `UnixListener`
7206 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7207 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7208 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7209 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7210 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7211 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7212 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7213 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7214 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7215 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7216 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7217 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7218 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7219 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7220 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7221 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7222 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7223 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7224 * RawFd impls for `UnixDatagram`
7225 * `{BTree,Hash}Map::values_mut`
7226 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7227
7228 Libraries
7229 ---------
7230
7231 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7232   The semantics of this minor method are subtle and probably not what
7233   most people want.
7234 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7235 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7236   will fall back to `/dev/urandom` temporarily to avoid blocking
7237   during early boot](https://github.com/rust-lang/rust/pull/33086).
7238 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7239 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7240 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7241 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7242 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7243 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7244   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7245
7246 Cargo
7247 -----
7248 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7249   This controls the runtime behavior of the `panic!` macro
7250   and can be either "unwind" (the default), or "abort".
7251   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7252 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7253 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7254 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7255   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7256 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7257 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7258 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7259   By default they are retried twice, which can be customized with the
7260   `net.retry` value in `.cargo/config`.
7261 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7262 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7263 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7264 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7265   Makes it possible to install multiple crates in parallel.
7266 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7267 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7268 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7269 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7270 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7271 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7272
7273 Performance
7274 -----------
7275
7276 * [rustc memory usage was reduced by refactoring the context used for
7277   type checking](https://github.com/rust-lang/rust/pull/33425).
7278 * [Speed up creation of `HashMap`s by caching the random keys used
7279   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7280 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7281 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7282 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7283   10x faster than the previous lookup tables.
7284 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7285
7286 Usability
7287 ---------
7288
7289 * Many incremental improvements to documentation and rustdoc.
7290 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7291 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7292 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7293 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7294 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7295 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7296 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7297
7298 Misc
7299 ----
7300
7301 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7302 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7303 * [`std` no longer prints backtraces on platforms where the running
7304   module must be loaded with `env::current_exe`, which can't be relied
7305   on](https://github.com/rust-lang/rust/pull/33554).
7306 * This release includes std binaries for the i586-unknown-linux-gnu,
7307   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7308   i586 target is for old x86 hardware without SSE2, and the armv7
7309   target is for Android running on modern ARM architectures.
7310 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7311   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7312 * [On Unix the runtime aborts by calling `libc::abort` instead of
7313   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7314 * [Rust is now bootstrapped from the previous release of Rust,
7315   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7316
7317 Compatibility Notes
7318 -------------------
7319
7320 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7321 * [`target_env` for Linux ARM targets is just `gnu`, not
7322   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7323 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7324 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7325 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7326   Affects how macros are parsed.
7327 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7328 * [Feature-gated attributes on macro-generated macro invocations are
7329   now rejected](https://github.com/rust-lang/rust/pull/32791).
7330 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7331   This caused some minor changes to type inference.
7332
7333
7334 Version 1.9.0 (2016-05-26)
7335 ==========================
7336
7337 Language
7338 --------
7339
7340 * The `#[deprecated]` attribute when applied to an API will generate
7341   warnings when used. The warnings may be suppressed with
7342   `#[allow(deprecated)]`. [RFC 1270].
7343 * [`fn` item types are zero sized, and each `fn` names a unique
7344   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7345   `transmute` on a `fn` type will generate a warning for a few cycles,
7346   then will be converted to an error.
7347 * [Field and method resolution understand visibility, so private
7348   fields and methods cannot prevent the proper use of public fields
7349   and methods][1.9fv].
7350 * [The parser considers unicode codepoints in the
7351   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7352
7353 Stabilized APIs
7354 ---------------
7355
7356 * [`std::panic`]
7357 * [`std::panic::catch_unwind`] (renamed from `recover`)
7358 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7359 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7360 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7361 * [`str::is_char_boundary`]
7362 * [`<*const T>::as_ref`]
7363 * [`<*mut T>::as_ref`]
7364 * [`<*mut T>::as_mut`]
7365 * [`AsciiExt::make_ascii_uppercase`]
7366 * [`AsciiExt::make_ascii_lowercase`]
7367 * [`char::decode_utf16`]
7368 * [`char::DecodeUtf16`]
7369 * [`char::DecodeUtf16Error`]
7370 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7371 * [`BTreeSet::take`]
7372 * [`BTreeSet::replace`]
7373 * [`BTreeSet::get`]
7374 * [`HashSet::take`]
7375 * [`HashSet::replace`]
7376 * [`HashSet::get`]
7377 * [`OsString::with_capacity`]
7378 * [`OsString::clear`]
7379 * [`OsString::capacity`]
7380 * [`OsString::reserve`]
7381 * [`OsString::reserve_exact`]
7382 * [`OsStr::is_empty`]
7383 * [`OsStr::len`]
7384 * [`std::os::unix::thread`]
7385 * [`RawPthread`]
7386 * [`JoinHandleExt`]
7387 * [`JoinHandleExt::as_pthread_t`]
7388 * [`JoinHandleExt::into_pthread_t`]
7389 * [`HashSet::hasher`]
7390 * [`HashMap::hasher`]
7391 * [`CommandExt::exec`]
7392 * [`File::try_clone`]
7393 * [`SocketAddr::set_ip`]
7394 * [`SocketAddr::set_port`]
7395 * [`SocketAddrV4::set_ip`]
7396 * [`SocketAddrV4::set_port`]
7397 * [`SocketAddrV6::set_ip`]
7398 * [`SocketAddrV6::set_port`]
7399 * [`SocketAddrV6::set_flowinfo`]
7400 * [`SocketAddrV6::set_scope_id`]
7401 * [`slice::copy_from_slice`]
7402 * [`ptr::read_volatile`]
7403 * [`ptr::write_volatile`]
7404 * [`OpenOptions::create_new`]
7405 * [`TcpStream::set_nodelay`]
7406 * [`TcpStream::nodelay`]
7407 * [`TcpStream::set_ttl`]
7408 * [`TcpStream::ttl`]
7409 * [`TcpStream::set_only_v6`]
7410 * [`TcpStream::only_v6`]
7411 * [`TcpStream::take_error`]
7412 * [`TcpStream::set_nonblocking`]
7413 * [`TcpListener::set_ttl`]
7414 * [`TcpListener::ttl`]
7415 * [`TcpListener::set_only_v6`]
7416 * [`TcpListener::only_v6`]
7417 * [`TcpListener::take_error`]
7418 * [`TcpListener::set_nonblocking`]
7419 * [`UdpSocket::set_broadcast`]
7420 * [`UdpSocket::broadcast`]
7421 * [`UdpSocket::set_multicast_loop_v4`]
7422 * [`UdpSocket::multicast_loop_v4`]
7423 * [`UdpSocket::set_multicast_ttl_v4`]
7424 * [`UdpSocket::multicast_ttl_v4`]
7425 * [`UdpSocket::set_multicast_loop_v6`]
7426 * [`UdpSocket::multicast_loop_v6`]
7427 * [`UdpSocket::set_multicast_ttl_v6`]
7428 * [`UdpSocket::multicast_ttl_v6`]
7429 * [`UdpSocket::set_ttl`]
7430 * [`UdpSocket::ttl`]
7431 * [`UdpSocket::set_only_v6`]
7432 * [`UdpSocket::only_v6`]
7433 * [`UdpSocket::join_multicast_v4`]
7434 * [`UdpSocket::join_multicast_v6`]
7435 * [`UdpSocket::leave_multicast_v4`]
7436 * [`UdpSocket::leave_multicast_v6`]
7437 * [`UdpSocket::take_error`]
7438 * [`UdpSocket::connect`]
7439 * [`UdpSocket::send`]
7440 * [`UdpSocket::recv`]
7441 * [`UdpSocket::set_nonblocking`]
7442
7443 Libraries
7444 ---------
7445
7446 * [`std::sync::Once` is poisoned if its initialization function
7447   fails][1.9o].
7448 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7449 * [Most types implement `fmt::Debug`][1.9db].
7450 * [The default buffer size used by `BufReader` and `BufWriter` was
7451   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7452   used by other languages.
7453 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7454   `Duration` additionally implements `*=` and `/=`][1.9ta].
7455 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7456 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7457 * [`Chain` implements `BufRead`][1.9ch].
7458 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7459
7460 Cargo
7461 -----
7462
7463 * [Cargo can now run concurrently][1.9cc].
7464 * [Top-level overrides allow specific revisions of crates to be
7465   overridden through the entire crate graph][1.9ct].  This is intended
7466   to make upgrades easier for large projects, by allowing crates to be
7467   forked temporarily until they've been upgraded and republished.
7468 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7469 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7470   on the commandline][1.9cf]. `rustc` arguments can also be specified
7471   in the `build.rustflags` configuration key.
7472
7473 Performance
7474 -----------
7475
7476 * [The time complexity of comparing variables for equivalence during type
7477   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7478   to major compilation time improvement in some scenarios.
7479 * [`ToString` is specialized for `str`, giving it the same performance
7480   as `to_owned`][1.9ts].
7481 * [Spawning processes with `Command::output` no longer creates extra
7482   threads][1.9sp].
7483 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7484   for C-like enums][1.9cl].
7485
7486 Misc
7487 ----
7488
7489 * [Passing the `--quiet` flag to a test runner will produce
7490   much-abbreviated output][1.9q].
7491 * The Rust Project now publishes std binaries for the
7492   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7493   `i586-pc-windows-msvc` targets.
7494
7495 Compatibility Notes
7496 -------------------
7497
7498 * [`std::sync::Once` is poisoned if its initialization function
7499   fails][1.9o].
7500 * [It is illegal to define methods with the same name in overlapping
7501   inherent `impl` blocks][1.9sn].
7502 * [`fn` item types are zero sized, and each `fn` names a unique
7503   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7504   `transmute` on a `fn` type will generate a warning for a few cycles,
7505   then will be converted to an error.
7506 * [Improvements to const evaluation may trigger new errors when integer
7507   literals are out of range][1.9ce].
7508
7509
7510 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7511 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7512 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7513 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7514 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7515 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7516 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7517 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7518 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7519 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7520 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7521 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7522 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7523 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7524 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7525 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7526 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7527 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7528 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7529 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7530 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7531 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7532 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7533 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7534 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7535 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7536 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7537 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7538 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7539 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7540 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7541 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7542 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7543 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7544 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7545 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7546 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7547 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7548 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7549 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7550 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7551 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7552 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7553 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7554 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7555 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7556 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7557 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7558 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7559 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7560 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7561 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7562 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7563 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7564 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7565 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7566 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7567 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7568 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7569 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7570 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7571 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7572 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7573 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7574 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7575 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7576 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7577 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7578 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7579 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7580 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7581 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7582 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7583 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7584 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7585 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7586 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7587 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7588 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7589 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7590 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7591 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7592 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7593 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7594 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7595 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7596 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7597 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7598 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7599 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7600 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7601 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7602 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7603 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7604 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7605 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7606 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7607 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7608 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7609 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7610 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7611 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7612 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7613 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7614 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7615 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7616 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7617 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7618 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7619 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7620
7621
7622 Version 1.8.0 (2016-04-14)
7623 ==========================
7624
7625 Language
7626 --------
7627
7628 * Rust supports overloading of compound assignment statements like
7629   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7630   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7631   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7632   traits. [RFC 953].
7633 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7634   addition to the non-braced form, `struct Foo;`. [RFC 218].
7635
7636 Libraries
7637 ---------
7638
7639 * Stabilized APIs:
7640   * [`str::encode_utf16`] (renamed from `utf16_units`)
7641   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7642   * [`Ref::map`]
7643   * [`RefMut::map`]
7644   * [`ptr::drop_in_place`]
7645   * [`time::Instant`]
7646   * [`time::SystemTime`]
7647   * [`Instant::now`]
7648   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7649   * [`Instant::elapsed`]
7650   * [`SystemTime::now`]
7651   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7652   * [`SystemTime::elapsed`]
7653   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7654   * [`SystemTimeError`]
7655   * [`SystemTimeError::duration`]
7656   * Various impls for `SystemTimeError`
7657   * [`UNIX_EPOCH`]
7658   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7659     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7660     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7661 * [The `write!` and `writeln!` macros correctly emit errors if any of
7662   their arguments can't be formatted][1.8w].
7663 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7664 * [The Unix-specific `raw` modules, which contain a number of
7665   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7666   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7667   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7668   across platforms was making it difficult to implement `std`
7669   correctly. Those that need these definitions should use the `libc`
7670   crate. [RFC 1415].
7671 * The Unix-specific `MetadataExt` traits, including
7672   `os::unix::fs::MetadataExt`, which expose values such as inode
7673   numbers [no longer return platform-specific types][1.8r], but
7674   instead return widened integers. [RFC 1415].
7675 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7676 * [Atomic loads and stores are not volatile][1.8a].
7677 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7678
7679 Performance
7680 -----------
7681
7682 * [Inlining hash functions lead to a 3% compile-time improvement in
7683   some workloads][1.8h].
7684 * When using jemalloc, its symbols are [unprefixed so that it
7685   overrides the libc malloc implementation][1.8h]. This means that for
7686   rustc, LLVM is now using jemalloc, which results in a 6%
7687   compile-time improvement on a specific workload.
7688 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7689
7690 Misc
7691 ----
7692
7693 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7694   i686-pc-windows-msvc is now considered a tier-1 platform.
7695 * [The `--print targets` flag prints a list of supported targets][1.8t].
7696 * [The `--print cfg` flag prints the `cfg`s defined for the current
7697   target][1.8cf].
7698 * [`rustc` can be built with an new Cargo-based build system, written
7699   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7700   build system. To enable it configure with `configure --rustbuild`.
7701 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7702   variants while also indicating the total number of missing variants
7703   if more than 3][1.8m].
7704 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7705 * The Rust Project now publishes binary releases of the standard
7706   library for a number of tier-2 targets:
7707   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7708   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7709   `x86_64-rumprun-netbsd`. These can be installed with
7710   tools such as [multirust][1.8mr].
7711
7712 Cargo
7713 -----
7714
7715 * [`cargo init` creates a new Cargo project in the current
7716   directory][1.8ci].  It is otherwise like `cargo new`.
7717 * [Cargo has configuration keys for `-v` and
7718   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7719   `[term]` section of `.cargo/config`.
7720 * [Configuration keys that evaluate to strings or integers can be set
7721   via environment variables][1.8ce]. For example the `build.jobs` key
7722   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7723   precedence over config files.
7724 * [Target-specific dependencies support Rust `cfg` syntax for
7725   describing targets][1.8cfg] so that dependencies for multiple
7726   targets can be specified together. [RFC 1361].
7727 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7728   `RUSTDOC` take precedence over the `build.target-dir`,
7729   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7730 * [The child process tree is killed on Windows when Cargo is
7731   killed][1.8ck].
7732 * [The `build.target` configuration value sets the target platform,
7733   like `--target`][1.8ct].
7734
7735 Compatibility Notes
7736 -------------------
7737
7738 * [Unstable compiler flags have been further restricted][1.8u]. Since
7739   1.0 `-Z` flags have been considered unstable, and other flags that
7740   were considered unstable additionally required passing `-Z
7741   unstable-options` to access. Unlike unstable language and library
7742   features though, these options have been accessible on the stable
7743   release channel. Going forward, *new unstable flags will not be
7744   available on the stable release channel*, and old unstable flags
7745   will warn about their usage. In the future, all unstable flags will
7746   be unavailable on the stable release channel.
7747 * [It is no longer possible to `match` on empty enum variants using
7748   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7749 * The Unix-specific `MetadataExt` traits, including
7750   `os::unix::fs::MetadataExt`, which expose values such as inode
7751   numbers [no longer return platform-specific types][1.8r], but
7752   instead return widened integers. [RFC 1415].
7753 * [Modules sourced from the filesystem cannot appear within arbitrary
7754   blocks, but only within other modules][1.8mf].
7755 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7756 * On Unix, [stack overflow triggers a runtime abort instead of a
7757   SIGSEGV][1.8so].
7758 * [`Command::spawn` and its equivalents return an error if any of
7759   its command-line arguments contain interior `NUL`s][1.8n].
7760 * [Tuple and unit enum variants from other crates are in the type
7761   namespace][1.8tn].
7762 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7763   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7764   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7765   instead of `foo.lib`.
7766
7767
7768 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7769 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7770 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7771 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7772 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7773 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7774 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7775 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7776 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7777 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7778 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7779 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7780 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7781 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7782 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7783 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7784 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7785 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7786 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7787 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7788 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7789 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7790 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7791 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7792 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7793 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7794 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7795 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7796 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7797 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7798 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7799 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7800 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7801 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7802 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7803 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7804 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7805 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7806 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7807 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7808 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7809 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7810 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7811 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7812 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7813 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7814 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7815 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7816 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7817 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7818 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7819 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7820 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7821 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7822 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7823 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7824 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7825 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7826 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7827 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7828
7829
7830 Version 1.7.0 (2016-03-03)
7831 ==========================
7832
7833 Libraries
7834 ---------
7835
7836 * Stabilized APIs
7837   * `Path`
7838     * [`Path::strip_prefix`] (renamed from relative_from)
7839     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7840   * `Ipv4Addr`
7841     * [`Ipv4Addr::is_loopback`]
7842     * [`Ipv4Addr::is_private`]
7843     * [`Ipv4Addr::is_link_local`]
7844     * [`Ipv4Addr::is_multicast`]
7845     * [`Ipv4Addr::is_broadcast`]
7846     * [`Ipv4Addr::is_documentation`]
7847   * `Ipv6Addr`
7848     * [`Ipv6Addr::is_unspecified`]
7849     * [`Ipv6Addr::is_loopback`]
7850     * [`Ipv6Addr::is_multicast`]
7851   * `Vec`
7852     * [`Vec::as_slice`]
7853     * [`Vec::as_mut_slice`]
7854   * `String`
7855     * [`String::as_str`]
7856     * [`String::as_mut_str`]
7857   * Slices
7858     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7859     be the same length
7860     * `<[T]>::`[`sort_by_key`]
7861   * checked, saturated, and overflowing operations
7862     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7863     * [`i32::saturating_mul`]
7864     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7865     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7866     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7867     * [`u32::saturating_mul`]
7868     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7869     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7870     * and checked, saturated, and overflowing operations for other primitive types
7871   * FFI
7872     * [`ffi::IntoStringError`]
7873     * [`CString::into_string`]
7874     * [`CString::into_bytes`]
7875     * [`CString::into_bytes_with_nul`]
7876     * `From<CString> for Vec<u8>`
7877   * `IntoStringError`
7878     * [`IntoStringError::into_cstring`]
7879     * [`IntoStringError::utf8_error`]
7880     * `Error for IntoStringError`
7881   * Hashing
7882     * [`std::hash::BuildHasher`]
7883     * [`BuildHasher::Hasher`]
7884     * [`BuildHasher::build_hasher`]
7885     * [`std::hash::BuildHasherDefault`]
7886     * [`HashMap::with_hasher`]
7887     * [`HashMap::with_capacity_and_hasher`]
7888     * [`HashSet::with_hasher`]
7889     * [`HashSet::with_capacity_and_hasher`]
7890     * [`std::collections::hash_map::RandomState`]
7891     * [`RandomState::new`]
7892 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7893   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7894   from bytes is faster.
7895 * [The performance of `LineWriter` (and thus `io::stdout`) was
7896   improved by using `memchr` to search for newlines][1.7m].
7897 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7898   `f64` variants were stabilized previously.
7899 * [`BTreeMap` was rewritten to use less memory and improve the performance
7900   of insertion and iteration, the latter by as much as 5x][1.7bm].
7901 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7902   covariant over their contained type][1.7bt].
7903 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7904   over their contained type][1.7ll].
7905 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7906   searching methods.
7907 * [`Any` is implemented for unsized types][1.7a].
7908 * [`Hash` is implemented for `Duration`][1.7h].
7909
7910 Misc
7911 ----
7912
7913 * [When running tests with `--test`, rustdoc will pass `--cfg`
7914   arguments to the compiler][1.7dt].
7915 * [The compiler is built with RPATH information by default][1.7rpa].
7916   This means that it will be possible to run `rustc` when installed in
7917   unusual configurations without configuring the dynamic linker search
7918   path explicitly.
7919 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7920   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7921   over `LD_LIBRARY_PATH`.
7922
7923 Cargo
7924 -----
7925
7926 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7927   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7928 * [The `rerun-if-changed` build script directive no longer causes the
7929   build script to incorrectly run twice in certain scenarios][1.7rr].
7930
7931 Compatibility Notes
7932 -------------------
7933
7934 * Soundness fixes to the interactions between associated types and
7935   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7936   code that violates the new rules. This is a significant change that
7937   is known to break existing code, so it has emitted warnings for the
7938   new error cases since 1.4 to give crate authors time to adapt. The
7939   details of what is changing are subtle; read the RFC for more.
7940 * [Several bugs in the compiler's visibility calculations were
7941   fixed][1.7v]. Since this was found to break significant amounts of
7942   code, the new errors will be emitted as warnings for several release
7943   cycles, under the `private_in_public` lint.
7944 * Defaulted type parameters were accidentally accepted in positions
7945   that were not intended. In this release, [defaulted type parameters
7946   appearing outside of type definitions will generate a
7947   warning][1.7d], which will become an error in future releases.
7948 * [Parsing "." as a float results in an error instead of 0][1.7p].
7949   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7950 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7951
7952 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7953 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7954 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7955 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7956 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7957 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7958 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7959 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7960 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7961 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7962 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7963 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7964 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7965 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7966 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7967 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7968 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7969 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7970 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7971 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7972 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7973 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7974 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7975 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7976 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7977 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7978 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7979 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7980 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7981 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7982 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7983 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7984 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7985 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7986 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7987 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7988 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7989 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7990 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7991 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7992 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7993 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7994 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7995 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7996 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7997 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7998 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7999 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8000 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8001 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8002 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8003 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8004 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8005 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8006 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8007 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8008 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8009 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8010 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8011 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8012 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8013 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8014 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8015 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8016 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8017 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8018 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8019 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8020 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8021 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8022 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8023 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8024 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8025 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8026 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8027 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8028 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8029 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8030 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8031
8032
8033 Version 1.6.0 (2016-01-21)
8034 ==========================
8035
8036 Language
8037 --------
8038
8039 * The `#![no_std]` attribute causes a crate to not be linked to the
8040   standard library, but only the [core library][1.6co], as described
8041   in [RFC 1184]. The core library defines common types and traits but
8042   has no platform dependencies whatsoever, and is the basis for Rust
8043   software in environments that cannot support a full port of the
8044   standard library, such as operating systems. Most of the core
8045   library is now stable.
8046
8047 Libraries
8048 ---------
8049
8050 * Stabilized APIs:
8051   [`Read::read_exact`],
8052   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8053   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8054   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8055   [`os::unix::fs::DirBuilderExt`],
8056   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8057   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8058   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8059   [`collections::hash_map::Drain`],
8060   [`collections::hash_map::HashMap::drain`],
8061   [`collections::hash_set::Drain`],
8062   [`collections::hash_set::HashSet::drain`],
8063   [`collections::binary_heap::Drain`],
8064   [`collections::binary_heap::BinaryHeap::drain`],
8065   [`Vec::extend_from_slice`] (renamed from `push_all`),
8066   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8067   [`RwLock::into_inner`],
8068   [`Iterator::min_by_key`] (renamed from `min_by`),
8069   [`Iterator::max_by_key`] (renamed from `max_by`).
8070 * The [core library][1.6co] is stable, as are most of its APIs.
8071 * [The `assert_eq!` macro supports arguments that don't implement
8072   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8073   `assert!`.
8074 * Several timer functions that take duration in milliseconds [are
8075   deprecated in favor of those that take `Duration`][1.6ms]. These
8076   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8077   `thread::park_timeout_ms`.
8078 * The algorithm by which `Vec` reserves additional elements was
8079   [tweaked to not allocate excessive space][1.6a] while still growing
8080   exponentially.
8081 * `From` conversions are [implemented from integers to floats][1.6f]
8082   in cases where the conversion is lossless. Thus they are not
8083   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8084   or `f64`. They are also not implemented for `isize` and `usize`
8085   because the implementations would be platform-specific. `From` is
8086   also implemented from `f32` to `f64`.
8087 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8088 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8089 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8090 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8091   improvements.
8092 * Sorting slices that are already sorted [is 50% faster in some
8093   cases][1.6s].
8094
8095 Cargo
8096 -----
8097
8098 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8099 * Cargo build scripts can specify their dependencies by emitting the
8100   [`rerun-if-changed`][1.6rr] key.
8101 * crates.io will reject publication of crates with dependencies that
8102   have a wildcard version constraint. Crates with wildcard
8103   dependencies were seen to cause a variety of problems, as described
8104   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8105   warning.
8106 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8107   release folder.  A variety of artifacts that Cargo failed to clean
8108   are now correctly deleted.
8109
8110 Misc
8111 ----
8112
8113 * The `unreachable_code` lint [warns when a function call's argument
8114   diverges][1.6dv].
8115 * The parser indicates [failures that may be caused by
8116   confusingly-similar Unicode characters][1.6uc]
8117 * Certain macro errors [are reported at definition time][1.6m], not
8118   expansion.
8119
8120 Compatibility Notes
8121 -------------------
8122
8123 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8124   environment variable when locating crates. This was a pre-cargo
8125   feature for integrating with the package manager that was
8126   accidentally never removed.
8127 * [A number of bugs were fixed in the privacy checker][1.6p] that
8128   could cause previously-accepted code to break.
8129 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8130 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8131   struct pattern syntax (`Foo(..)`) can no longer be used to match
8132   unit structs. This is a warning now, but will become an error in
8133   future releases. Patterns that share the same name as a const are
8134   now an error.
8135 * A bug was fixed that causes [rustc not to apply default type
8136   parameters][1.6xc] when resolving certain method implementations of
8137   traits defined in other crates.
8138
8139 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8140 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8141 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8142 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8143 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8144 [1.6co]: http://doc.rust-lang.org/core/index.html
8145 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8146 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8147 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8148 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8149 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8150 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8151 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8152 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8153 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8154 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8155 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8156 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8157 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8158 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8159 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8160 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8161 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8162 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8163 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8164 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8165 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8166 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8167 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8168 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8169 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8170 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8171 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8172 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8173 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8174 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8175 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8176 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8177 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8178 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8179 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8180 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8181 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8182 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8183 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8184 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8185 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8186
8187
8188 Version 1.5.0 (2015-12-10)
8189 ==========================
8190
8191 * ~700 changes, numerous bugfixes
8192
8193 Highlights
8194 ----------
8195
8196 * Stabilized APIs:
8197   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8198   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8199   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8200   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8201   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8202   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8203   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8204   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8205   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8206   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8207   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8208   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8209   [`Path::read_link`], [`Path::symlink_metadata`],
8210   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8211   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8212   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8213   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8214   [`slice::split_first_mut`], [`slice::split_first`],
8215   [`slice::split_last_mut`], [`slice::split_last`],
8216   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8217   [`str::MatchIndices`], [`str::RMatchIndices`],
8218   [`str::match_indices`], [`str::rmatch_indices`],
8219   [`str::slice_mut_unchecked`], [`string::ParseError`].
8220 * Rust applications hosted on crates.io can be installed locally to
8221   `~/.cargo/bin` with the [`cargo install`] command. Among other
8222   things this makes it easier to augment Cargo with new subcommands:
8223   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8224   invoked as `cargo foo`.
8225 * Crates with wildcard (`*`) dependencies will [emit warnings when
8226   published][1.5w]. In 1.6 it will no longer be possible to publish
8227   crates with wildcard dependencies.
8228
8229 Breaking Changes
8230 ----------------
8231
8232 * The rules determining when a particular lifetime must outlive
8233   a particular value (known as '[dropck]') have been [modified
8234   to not rely on parametricity][1.5p].
8235 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8236   and `Arc`][1.5a]. Because these smart pointer types implement
8237   `Deref`, this causes breakage in cases where the interior type
8238   contains methods of the same name.
8239 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8240   that they could drop their content. Soundness fix.
8241 * All method invocations are [properly checked][1.5wf1] for
8242   [well-formedness][1.5wf2]. Soundness fix.
8243 * Traits whose supertraits contain `Self` are [not object
8244   safe][1.5o]. Soundness fix.
8245 * Target specifications support a [`no_default_libraries`][1.5nd]
8246   setting that controls whether `-nodefaultlibs` is passed to the
8247   linker, and in turn the `is_like_windows` setting no longer affects
8248   the `-nodefaultlibs` flag.
8249 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8250 * The `#[inline]` and `#[repr]` attributes [can only appear
8251   in valid locations][1.5at].
8252 * Native libraries linked from the local crate are [passed to
8253   the linker before native libraries from upstream crates][1.5nl].
8254 * Two rarely-used attributes, `#[no_debug]` and
8255   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8256 * Negation of unsigned integers, which has been a warning for
8257   several releases, [is now behind a feature gate and will
8258   generate errors][1.5nu].
8259 * The parser accidentally accepted visibility modifiers on
8260   enum variants, a bug [which has been fixed][1.5ev].
8261 * [A bug was fixed that allowed `use` statements to import unstable
8262   features][1.5use].
8263
8264 Language
8265 --------
8266
8267 * When evaluating expressions at compile-time that are not
8268   compile-time constants (const-evaluating expressions in non-const
8269   contexts), incorrect code such as overlong bitshifts and arithmetic
8270   overflow will [generate a warning instead of an error][1.5ce],
8271   delaying the error until runtime. This will allow the
8272   const-evaluator to be expanded in the future backwards-compatibly.
8273 * The `improper_ctypes` lint [no longer warns about using `isize` and
8274   `usize` in FFI][1.5ict].
8275
8276 Libraries
8277 ---------
8278
8279 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8280   invariant][1.5c].
8281 * `Default` is [implemented for mutable slices][1.5d].
8282 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8283 * There are now `From` conversions [between floating point
8284   types][1.5f] where the conversions are lossless.
8285 * There are now `From` conversions [between integer types][1.5i] where
8286   the conversions are lossless.
8287 * [`fs::Metadata` implements `Clone`][1.5fs].
8288 * The `parse` method [accepts a leading "+" when parsing
8289   integers][1.5pi].
8290 * [`AsMut` is implemented for `Vec`][1.5am].
8291 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8292   been optimized][1.5cf] and no longer rely on the default impl.
8293 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8294   `unsafe extern "C"` function types now [implement `Clone`,
8295   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8296   `fmt::Debug` for up to 12 arguments][1.5fp].
8297 * [Dropping `Vec`s is much faster in unoptimized builds when the
8298   element types don't implement `Drop`][1.5dv].
8299 * A bug that caused in incorrect behavior when [combining `VecDeque`
8300   with zero-sized types][1.5vdz] was resolved.
8301 * [`PartialOrd` for slices is faster][1.5po].
8302
8303 Miscellaneous
8304 -------------
8305
8306 * [Crate metadata size was reduced by 20%][1.5md].
8307 * [Improvements to code generation reduced the size of libcore by 3.3
8308   MB and rustc's memory usage by 18MB][1.5m].
8309 * [Improvements to deref translation increased performance in
8310   unoptimized builds][1.5dr].
8311 * Various errors in trait resolution [are deduplicated to only be
8312   reported once][1.5te].
8313 * Rust has preliminary [support for rumprun kernels][1.5rr].
8314 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8315
8316 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8317 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8318 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8319 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8320 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8321 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8322 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8323 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8324 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8325 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8326 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8327 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8328 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8329 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8330 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8331 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8332 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8333 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8334 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8335 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8336 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8337 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8338 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8339 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8340 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8341 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8342 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8343 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8344 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8345 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8346 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8347 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8348 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8349 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8350 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8351 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8352 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8353 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8354 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8355 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8356 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8357 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8358 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8359 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8360 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8361 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8362 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8363 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8364 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8365 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8366 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8367 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8368 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8369 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8370 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8371 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8372 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8373 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8374 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8375 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8376 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8377 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8378 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8379 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8380 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8381 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8382 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8383 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8384 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8385 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8386 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8387 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8388 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8389 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8390 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8391 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8392 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8393 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8394 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8395 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8396 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8397 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8398 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8399 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8400 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8401 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8402 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8403 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8404 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8405
8406 Version 1.4.0 (2015-10-29)
8407 ==========================
8408
8409 * ~1200 changes, numerous bugfixes
8410
8411 Highlights
8412 ----------
8413
8414 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8415   GNU) are now supported and recommended for use.
8416
8417 Breaking Changes
8418 ----------------
8419
8420 * [Several changes have been made to fix type soundness and improve
8421   the behavior of associated types][sound]. See [RFC 1214]. Although
8422   we have mostly introduced these changes as warnings this release, to
8423   become errors next release, there are still some scenarios that will
8424   see immediate breakage.
8425 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8426   line breaks in addition to `\n`][crlf].
8427 * [Loans of `'static` lifetime extend to the end of a function][stat].
8428 * [`str::parse` no longer introduces avoidable rounding error when
8429   parsing floating point numbers. Together with earlier changes to
8430   float formatting/output, "round trips" like f.to_string().parse()
8431   now preserve the value of f exactly. Additionally, leading plus
8432   signs are now accepted][fp3].
8433
8434
8435 Language
8436 --------
8437
8438 * `use` statements that import multiple items [can now rename
8439   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8440 * [Binops work correctly on fat pointers][binfat].
8441 * `pub extern crate`, which does not behave as expected, [issues a
8442   warning][pec] until a better solution is found.
8443
8444 Libraries
8445 ---------
8446
8447 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8448   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8449   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8450   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8451   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8452   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8453   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8454   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8455   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8456   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8457   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8458   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8459   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8460   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8461   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8462   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8463   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8464   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8465   [`thread::sleep`].
8466 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8467   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8468   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8469   `f64::from_str_radix`.
8470 * [Reverse-searching strings is faster with the 'two-way'
8471   algorithm][s].
8472 * [`std::io::copy` allows `?Sized` arguments][cc].
8473 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8474   [override `count`, `nth` and `last` with an *O*(1)
8475   implementation][it].
8476 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8477 * [`IntoRawFd` has been added to the Unix-specific prelude,
8478   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8479   prelude][pr].
8480 * [`Extend<String>` and `FromIterator<String` are both implemented for
8481   `String`][es].
8482 * [`IntoIterator` is implemented for references to `Option` and
8483   `Result`][into2].
8484 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8485   Copy`][ext] as part of [RFC 839]. This will cause type inference
8486   breakage in rare situations.
8487 * [`BinaryHeap` implements `Debug`][bh2].
8488 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8489   arrays][bm].
8490 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8491   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8492 * [String comparison is faster][faststr].
8493 * `&mut T` where `T: std::fmt::Write` [also implements
8494   `std::fmt::Write`][mutw].
8495 * [A stable regression in `VecDeque::push_back` and other
8496   capacity-altering methods that caused panics for zero-sized types
8497   was fixed][vd].
8498 * [Function pointers implement traits for up to 12 parameters][fp2].
8499
8500 Miscellaneous
8501 -------------
8502
8503 * The compiler [no longer uses the 'morestack' feature to prevent
8504   stack overflow][mm]. Instead it uses guard pages and stack
8505   probes (though stack probes are not yet implemented on any platform
8506   but Windows).
8507 * [The compiler matches traits faster when projections are involved][p].
8508 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8509   `usize`][ffi].
8510 * [Cargo now displays useful information about what its doing during
8511   `cargo update`][cu].
8512
8513 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8514 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8515 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8516 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8517 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8518 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8519 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8520 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8521 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8522 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8523 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8524 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8525 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8526 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8527 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8528 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8529 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8530 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8531 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8532 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8533 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8534 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8535 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8536 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8537 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8538 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8539 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8540 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8541 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8542 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8543 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8544 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8545 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8546 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8547 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8548 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8549 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8550 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8551 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8552 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8553 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8554 [bh2]: https://github.com/rust-lang/rust/pull/28156
8555 [binfat]: https://github.com/rust-lang/rust/pull/28270
8556 [bm]: https://github.com/rust-lang/rust/pull/28197
8557 [cc]: https://github.com/rust-lang/rust/pull/27531
8558 [crlf]: https://github.com/rust-lang/rust/pull/28034
8559 [cu]: https://github.com/rust-lang/cargo/pull/1931
8560 [d]: https://github.com/rust-lang/rust/pull/27825
8561 [dep]: https://github.com/rust-lang/rust/pull/28339
8562 [es]: https://github.com/rust-lang/rust/pull/27956
8563 [ext]: https://github.com/rust-lang/rust/pull/28094
8564 [faststr]: https://github.com/rust-lang/rust/pull/28338
8565 [ffi]: https://github.com/rust-lang/rust/pull/28779
8566 [fp]: https://github.com/rust-lang/rust/pull/28268
8567 [fp2]: https://github.com/rust-lang/rust/pull/28560
8568 [fp3]: https://github.com/rust-lang/rust/pull/27307
8569 [i]: https://github.com/rust-lang/rust/pull/27451
8570 [into2]: https://github.com/rust-lang/rust/pull/28039
8571 [it]: https://github.com/rust-lang/rust/pull/27652
8572 [mm]: https://github.com/rust-lang/rust/pull/27338
8573 [mutw]: https://github.com/rust-lang/rust/pull/28368
8574 [sound]: https://github.com/rust-lang/rust/pull/27641
8575 [p]: https://github.com/rust-lang/rust/pull/27866
8576 [pec]: https://github.com/rust-lang/rust/pull/28486
8577 [pr]: https://github.com/rust-lang/rust/pull/27896
8578 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8579 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8580 [s]: https://github.com/rust-lang/rust/pull/27474
8581 [stab]: https://github.com/rust-lang/rust/pull/28339
8582 [stat]: https://github.com/rust-lang/rust/pull/28321
8583 [vd]: https://github.com/rust-lang/rust/pull/28494
8584
8585 Version 1.3.0 (2015-09-17)
8586 ==============================
8587
8588 * ~900 changes, numerous bugfixes
8589
8590 Highlights
8591 ----------
8592
8593 * The [new object lifetime defaults][nold] have been [turned
8594   on][nold2] after a cycle of warnings about the change. Now types
8595   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8596   being interpreted as `&'a Box<Trait+'a>` to `&'a
8597   Box<Trait+'static>`.
8598 * [The Rustonomicon][nom] is a new book in the official documentation
8599   that dives into writing unsafe Rust.
8600 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8601   timekeeping is employed by other std APIs, as well as out-of-tree
8602   time crates.
8603
8604 Breaking Changes
8605 ----------------
8606
8607 * The [new object lifetime defaults][nold] have been [turned
8608   on][nold2] after a cycle of warnings about the change.
8609 * There is a known [regression][lr] in how object lifetime elision is
8610   interpreted, the proper solution for which is undetermined.
8611 * The `#[prelude_import]` attribute, an internal implementation
8612   detail, was accidentally stabilized previously. [It has been put
8613   behind the `prelude_import` feature gate][pi]. This change is
8614   believed to break no existing code.
8615 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8616   [more sane for dynamically sized types][dst3]. Code that relied on
8617   the previous behavior is thought to be broken.
8618 * The `dropck` rules, which checks that destructors can't access
8619   destroyed values, [have been updated][dropck] to match the
8620   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8621   cause some previously-compiling code to no longer build.
8622
8623 Language
8624 --------
8625
8626 * The [new object lifetime defaults][nold] have been [turned
8627   on][nold2] after a cycle of warnings about the change.
8628 * Semicolons may [now follow types and paths in
8629   macros](https://github.com/rust-lang/rust/pull/27000).
8630 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8631   [more sane for dynamically sized types][dst3]. Code that relied on
8632   the previous behavior is not known to exist, and suspected to be
8633   broken.
8634 * `'static` variables [may now be recursive][st].
8635 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8636   implementations correctly.
8637 * The `dropck` rules, which checks that destructors can't access
8638   destroyed values, [have been updated][dropck] to match the
8639   [RFC][dropckrfc].
8640
8641 Libraries
8642 ---------
8643
8644 * The [`Duration`] API, [has been stabilized][ds], as well as the
8645   `std::time` module, which presently contains only `Duration`.
8646 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8647 * The owned C string, [`CString`], implements [`Borrow`] and the
8648   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8649   these allow C strings to be borrowed and cloned in generic code.
8650 * [`CStr`] implements [`Debug`].
8651 * [`AtomicPtr`] implements [`Debug`].
8652 * [`Error`] trait objects [can be downcast to their concrete types][e]
8653   in many common configurations, using the [`is`], [`downcast`],
8654   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8655   [`Any`] trait.
8656 * Searching for substrings now [employs the two-way algorithm][search]
8657   instead of doing a naive search. This gives major speedups to a
8658   number of methods, including [`contains`][sc], [`find`][sf],
8659   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8660   [`ends_with`][sew] are also faster.
8661 * The performance of `PartialEq` for slices is [much faster][ps].
8662 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8663   is overridden and optimized by the implementations for scalars.
8664 * The [`Hasher`] trait now has a number of specialized `write_*`
8665   methods for primitive types, for efficiency.
8666 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8667   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8668   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8669   of [`std::error::Error::cause`][iec] also delegates to the inner
8670   error.
8671 * [`process::Child`][pc] gained the [`id`] method, which returns a
8672   `u32` representing the platform-specific process identifier.
8673 * The [`connect`] method on slices is deprecated, replaced by the new
8674   [`join`] method (note that both of these are on the *unstable*
8675   [`SliceConcatExt`] trait, but through the magic of the prelude are
8676   available to stable code anyway).
8677 * The [`Div`] operator is implemented for [`Wrapping`] types.
8678 * [`DerefMut` is implemented for `String`][dms].
8679 * Performance of SipHash (the default hasher for `HashMap`) is
8680   [better for long data][sh].
8681 * [`AtomicPtr`] implements [`Send`].
8682 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8683   are now [specialized to use uninitialized buffers for increased
8684   performance][rte].
8685 * Lifetime parameters of foreign functions [are now resolved
8686   properly][f].
8687
8688 Misc
8689 ----
8690
8691 * Rust can now, with some coercion, [produce programs that run on
8692   Windows XP][xp], though XP is not considered a supported platform.
8693 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8694   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8695   recommended for use in 1.3, though should be fully-functional
8696   in the [64-bit 1.4 beta][b14].
8697 * On Fedora-based systems installation will [properly configure the
8698   dynamic linker][fl].
8699 * The compiler gained many new extended error descriptions, which can
8700   be accessed with the `--explain` flag.
8701 * The `dropck` pass, which checks that destructors can't access
8702   destroyed values, [has been rewritten][dropck]. This fixes some
8703   soundness holes, and as such will cause some previously-compiling
8704   code to no longer build.
8705 * `rustc` now uses [LLVM to write archive files where possible][ar].
8706   Eventually this will eliminate the compiler's dependency on the ar
8707   utility.
8708 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8709   supported FreeBSD on x86_64).
8710 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8711   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8712   more strict.
8713 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8714   will kill the process instead of leaking][nlp].
8715
8716 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8717 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8718 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8719 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8720 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8721 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8722 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8723 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8724 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8725 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8726 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8727 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8728 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8729 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8730 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8731 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8732 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8733 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8734 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8735 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8736 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8737 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8738 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8739 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8740 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8741 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8742 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8743 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8744 [ar]: https://github.com/rust-lang/rust/pull/26926
8745 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8746 [dms]: https://github.com/rust-lang/rust/pull/26241
8747 [dropck]: https://github.com/rust-lang/rust/pull/27261
8748 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8749 [ds]: https://github.com/rust-lang/rust/pull/26818
8750 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8751 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8752 [dst3]: https://github.com/rust-lang/rust/pull/27351
8753 [e]: https://github.com/rust-lang/rust/pull/24793
8754 [f]: https://github.com/rust-lang/rust/pull/26588
8755 [fb]: https://github.com/rust-lang/rust/pull/26959
8756 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8757 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8758 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8759 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8760 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8761 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8762 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8763 [lic]: https://github.com/rust-lang/rust/pull/26583
8764 [lnu]: https://github.com/rust-lang/rust/pull/27026
8765 [lr]: https://github.com/rust-lang/rust/issues/27248
8766 [lum]: https://github.com/rust-lang/rust/pull/26378
8767 [lur]: https://github.com/rust-lang/rust/pull/26783
8768 [nlp]: https://github.com/rust-lang/rust/pull/27176
8769 [nold2]: https://github.com/rust-lang/rust/pull/27045
8770 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8771 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8772 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8773 [pi]: https://github.com/rust-lang/rust/pull/26699
8774 [ps]: https://github.com/rust-lang/rust/pull/26884
8775 [rte]: https://github.com/rust-lang/rust/pull/26950
8776 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8777 [search]: https://github.com/rust-lang/rust/pull/26327
8778 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8779 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8780 [sh]: https://github.com/rust-lang/rust/pull/27280
8781 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8782 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8783 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8784 [st]: https://github.com/rust-lang/rust/pull/26630
8785 [win1]: https://github.com/rust-lang/rust/pull/26569
8786 [win2]: https://github.com/rust-lang/rust/pull/26741
8787 [win3]: https://github.com/rust-lang/rust/pull/26741
8788 [win4]: https://github.com/rust-lang/rust/pull/27210
8789 [xp]: https://github.com/rust-lang/rust/pull/26569
8790
8791 Version 1.2.0 (2015-08-07)
8792 ==========================
8793
8794 * ~1200 changes, numerous bugfixes
8795
8796 Highlights
8797 ----------
8798
8799 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8800   like `Rc` to contain types without a fixed size, arrays and trait
8801   objects, finally enabling use of `Rc<[T]>` and completing the
8802   implementation of DST.
8803 * [Parallel codegen][parcodegen] is now working again, which can
8804   substantially speed up large builds in debug mode; It also gets
8805   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8806   jobs). It's not enabled by default, but will be "in the near
8807   future". It can be activated with the `-C codegen-units=N` flag to
8808   `rustc`.
8809 * This is the first release with [experimental support for linking
8810   with the MSVC linker and lib C on Windows (instead of using the GNU
8811   variants via MinGW)][win]. It is yet recommended only for the most
8812   intrepid Rustaceans.
8813 * Benchmark compilations are showing a 30% improvement in
8814   bootstrapping over 1.1.
8815
8816 Breaking Changes
8817 ----------------
8818
8819 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8820   unicode case mapping, which is a previously-planned change in
8821   behavior and considered a bugfix.
8822 * [`mem::align_of`] now specifies [the *minimum alignment* for
8823   T][align], which is usually the alignment programs are interested
8824   in, and the same value reported by clang's
8825   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8826   break real code.
8827 * [The `#[packed]` attribute is no longer silently accepted by the
8828   compiler][packed]. This attribute did nothing and code that
8829   mentioned it likely did not work as intended.
8830 * Associated type defaults are [now behind the
8831   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8832   defaults *did not work*, but could be mentioned syntactically. As
8833   such this breakage has minimal impact.
8834
8835 Language
8836 --------
8837
8838 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8839   matching against dereferenceable values.
8840
8841 Libraries
8842 ---------
8843
8844 * The [`Extend`] trait, which grows a collection from an iterator, is
8845   implemented over iterators of references, for `String`, `Vec`,
8846   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8847   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8848 * The [`iter::once`] function returns an iterator that yields a single
8849   element, and [`iter::empty`] returns an iterator that yields no
8850   elements.
8851 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8852   over substring matches.
8853 * [`Cell`] and [`RefCell`] both implement `Eq`.
8854 * A number of methods for wrapping arithmetic are added to the
8855   integral types, [`wrapping_div`], [`wrapping_rem`],
8856   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8857   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8858   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8859   type.. It is illegal for the default arithmetic operations in Rust
8860   to overflow; the desire to wrap must be explicit.
8861 * The `{:#?}` formatting specifier [displays the alternate,
8862   pretty-printed][debugfmt] form of the `Debug` formatter. This
8863   feature was actually introduced prior to 1.0 with little
8864   fanfare.
8865 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8866   for writing data to formatted strings, similar to [`io::Write`].
8867 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8868   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8869   are used by code generators to emit implementations of [`Debug`].
8870 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8871   methods that convert case, following Unicode case mapping.
8872 * It is now easier to handle poisoned locks. The [`PoisonError`]
8873   type, returned by failing lock operations, exposes `into_inner`,
8874   `get_ref`, and `get_mut`, which all give access to the inner lock
8875   guard, and allow the poisoned lock to continue to operate. The
8876   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8877   poisoned lock without attempting to take the lock.
8878 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8879   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8880   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8881   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8882   `ChildStderr`.
8883 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8884   malformed input.
8885
8886 Misc
8887 ----
8888
8889 * `rustc` employs smarter heuristics for guessing at [typos].
8890 * `rustc` emits more efficient code for [no-op conversions between
8891   unsafe pointers][nop].
8892 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8893   resulting in faster compile times and smaller code.
8894
8895 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8896 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8897 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8898 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8899 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8900 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8901 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8902 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8903 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8904 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8905 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8906 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8907 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8908 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8909 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8910 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8911 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8912 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8913 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8914 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8915 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8916 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8917 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8918 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8919 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8920 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8921 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8922 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8923 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8924 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8925 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8926 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8927 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8928 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8929 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8930 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8931 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8932 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8933 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8934 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8935 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8936 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8937 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8938 [align]: https://github.com/rust-lang/rust/pull/25646
8939 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8940 [typos]: https://github.com/rust-lang/rust/pull/26087
8941 [nop]: https://github.com/rust-lang/rust/pull/26336
8942 [fat]: https://github.com/rust-lang/rust/pull/26411
8943 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8944 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8945 [packed]: https://github.com/rust-lang/rust/pull/25541
8946 [ad]: https://github.com/rust-lang/rust/pull/27382
8947 [win]: https://github.com/rust-lang/rust/pull/25350
8948
8949 Version 1.1.0 (2015-06-25)
8950 =========================
8951
8952 * ~850 changes, numerous bugfixes
8953
8954 Highlights
8955 ----------
8956
8957 * The [`std::fs` module has been expanded][fs] to expand the set of
8958   functionality exposed:
8959   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8960     don't incur a syscall on some platforms.
8961   * A `symlink_metadata` function has been added.
8962   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8963     access to all underlying information.
8964 * The compiler now contains extended explanations of many errors. When an error
8965   with an explanation occurs the compiler suggests using the `--explain` flag
8966   to read the explanation. Error explanations are also [available online][err-index].
8967 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8968   well as other work, the time to bootstrap the compiler decreased by
8969   32%.
8970
8971 Libraries
8972 ---------
8973
8974 * The [`str::split_whitespace`] method splits a string on unicode
8975   whitespace boundaries.
8976 * On both Windows and Unix, new extension traits provide conversion of
8977   I/O types to and from the underlying system handles. On Unix, these
8978   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8979   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8980   `TcpListener`, and `UpdSocket`. Further implementations for
8981   `std::process` will be stabilized later.
8982 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8983   Windows, symlinks can be created with
8984   `std::os::windows::symlink_dir` and
8985   `std::os::windows::symlink_file`.
8986 * The `mpsc::Receiver` type can now be converted into an iterator with
8987   `into_iter` on the [`IntoIterator`] trait.
8988 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8989   implementation of the [`From`] trait.
8990 * The `Debug` implementation for `RangeFull` [creates output that is
8991   more consistent with other implementations][rf].
8992 * [`Debug` is implemented for `File`][file].
8993 * The `Default` implementation for `Arc` [no longer requires `Sync +
8994   Send`][arc].
8995 * [The `Iterator` methods `count`, `nth`, and `last` have been
8996   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
8997 * Incorrect handling of paths on Windows has been improved in both the
8998   compiler and the standard library.
8999 * [`AtomicPtr` gained a `Default` implementation][ap].
9000 * In accordance with Rust's policy on arithmetic overflow `abs` now
9001   [panics on overflow when debug assertions are enabled][abs].
9002 * The [`Cloned`] iterator, which was accidentally left unstable for
9003   1.0 [has been stabilized][c].
9004 * The [`Incoming`] iterator, which iterates over incoming TCP
9005   connections, and which was accidentally unnamable in 1.0, [is now
9006   properly exported][inc].
9007 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9008   `sift_up` or `sift_down` panic][bh].
9009 * The [`split_off`] method of `LinkedList` [no longer corrupts
9010   the list in certain scenarios][ll].
9011
9012 Misc
9013 ----
9014
9015 * Type checking performance [has improved notably][sk] with
9016   [multiple improvements][pre].
9017 * The compiler [suggests code changes][ch] for more errors.
9018 * rustc and it's build system have experimental support for [building
9019   toolchains against MUSL][m] instead of glibc on Linux.
9020 * The compiler defines the `target_env` cfg value, which is used for
9021   distinguishing toolchains that are otherwise for the same
9022   platform. Presently this is set to `gnu` for common GNU Linux
9023   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9024 * The [`cargo rustc`][crc] command invokes a build with custom flags
9025   to rustc.
9026 * [Android executables are always position independent][pie].
9027 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9028   with `Drop`][drop].
9029
9030 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9031 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9032 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9033 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9034 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9035 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9036 [rf]: https://github.com/rust-lang/rust/pull/24491
9037 [err-index]: https://doc.rust-lang.org/error-index.html
9038 [sk]: https://github.com/rust-lang/rust/pull/24615
9039 [pre]: https://github.com/rust-lang/rust/pull/25323
9040 [file]: https://github.com/rust-lang/rust/pull/24598
9041 [ch]: https://github.com/rust-lang/rust/pull/24683
9042 [arc]: https://github.com/rust-lang/rust/pull/24695
9043 [si]: https://github.com/rust-lang/rust/pull/24701
9044 [ap]: https://github.com/rust-lang/rust/pull/24834
9045 [m]: https://github.com/rust-lang/rust/pull/24777
9046 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9047 [crc]: https://github.com/rust-lang/cargo/pull/1568
9048 [pie]: https://github.com/rust-lang/rust/pull/24953
9049 [abs]: https://github.com/rust-lang/rust/pull/25441
9050 [c]: https://github.com/rust-lang/rust/pull/25496
9051 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9052 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9053 [inc]: https://github.com/rust-lang/rust/pull/25522
9054 [bh]: https://github.com/rust-lang/rust/pull/25856
9055 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9056 [ll]: https://github.com/rust-lang/rust/pull/26022
9057 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9058 [drop]: https://github.com/rust-lang/rust/pull/24935
9059
9060 Version 1.0.0 (2015-05-15)
9061 ========================
9062
9063 * ~1500 changes, numerous bugfixes
9064
9065 Highlights
9066 ----------
9067
9068 * The vast majority of the standard library is now `#[stable]`. It is
9069   no longer possible to use unstable features with a stable build of
9070   the compiler.
9071 * Many popular crates on [crates.io] now work on the stable release
9072   channel.
9073 * Arithmetic on basic integer types now [checks for overflow in debug
9074   builds][overflow].
9075
9076 Language
9077 --------
9078
9079 * Several [restrictions have been added to trait coherence][coh] in
9080   order to make it easier for upstream authors to change traits
9081   without breaking downstream code.
9082 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9083   improve error messages and macro behavior. For example, `0b1234` is
9084   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9085 * Trait bounds [are always invariant][inv], eliminating the need for
9086   the `PhantomFn` and `MarkerTrait` lang items, which have been
9087   removed.
9088 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9089   "foo" as bar` syntax has been replaced with `extern crate foo as
9090   bar`, and Cargo now automatically translates "-" in *package* names
9091   to underscore for the crate name.
9092 * [Lifetime shadowing is an error][lt].
9093 * [`Send` no longer implies `'static`][send-rfc].
9094 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9095   `MyType::default()`.
9096 * Primitive types [now have inherent methods][prim-inherent],
9097   obviating the need for extension traits like `SliceExt`.
9098 * Methods with `Self: Sized` in their `where` clause are [considered
9099   object-safe][self-sized], allowing many extension traits like
9100   `IteratorExt` to be merged into the traits they extended.
9101 * You can now [refer to associated types][assoc-where] whose
9102   corresponding trait bounds appear only in a `where` clause.
9103 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9104   like `Send` and `Sync` are now library-defined.
9105 * A [Reflect trait][reflect] was introduced, which means that
9106   downcasting via the `Any` trait is effectively limited to concrete
9107   types. This helps retain the potentially-important "parametricity"
9108   property: generic code cannot behave differently for different type
9109   arguments except in minor ways.
9110 * The `unsafe_destructor` feature is now deprecated in favor of the
9111   [new `dropck`][dropck]. This change is a major reduction in unsafe
9112   code.
9113
9114 Libraries
9115 ---------
9116
9117 * The `thread_local` module [has been renamed to `std::thread`][th].
9118 * The methods of `IteratorExt` [have been moved to the `Iterator`
9119   trait itself][ie].
9120 * Several traits that implement Rust's conventions for type
9121   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9122   [centralized in the `std::convert` module][con].
9123 * The `FromError` trait [was removed in favor of `From`][fe].
9124 * The basic sleep function [has moved to
9125   `std::thread::sleep_ms`][slp].
9126 * The `splitn` function now takes an `n` parameter that represents the
9127   number of items yielded by the returned iterator [instead of the
9128   number of 'splits'][spl].
9129 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9130 * [Derived implementations of `PartialOrd` now order enums according
9131   to their explicitly-assigned discriminants][po].
9132 * [Methods for searching strings are generic over `Pattern`s][pat],
9133   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9134   some others.
9135 * [In method resolution, object methods are resolved before inherent
9136   methods][meth].
9137 * [`String::from_str` has been deprecated in favor of the `From` impl,
9138   `String::from`][sf].
9139 * [`io::Error` implements `Sync`][ios].
9140 * [The `words` method on `&str` has been replaced with
9141   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9142   a word?'
9143 * The new path and IO modules are complete and `#[stable]`. This
9144   was the major library focus for this cycle.
9145 * The path API was [revised][path-normalize] to normalize `.`,
9146   adjusting the tradeoffs in favor of the most common usage.
9147 * A large number of remaining APIs in `std` were also stabilized
9148   during this cycle; about 75% of the non-deprecated API surface
9149   is now stable.
9150 * The new [string pattern API][string-pattern] landed, which makes
9151   the string slice API much more internally consistent and flexible.
9152 * A new set of [generic conversion traits][conversion] replaced
9153   many existing ad hoc traits.
9154 * Generic numeric traits were [completely removed][num-traits]. This
9155   was made possible thanks to inherent methods for primitive types,
9156   and the removal gives maximal flexibility for designing a numeric
9157   hierarchy in the future.
9158 * The `Fn` traits are now related via [inheritance][fn-inherit]
9159   and provide ergonomic [blanket implementations][fn-blanket].
9160 * The `Index` and `IndexMut` traits were changed to
9161   [take the index by value][index-value], enabling code like
9162   `hash_map["string"]` to work.
9163 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9164   `Copy` data is known to be `Clone` as well.
9165
9166 Misc
9167 ----
9168
9169 * Many errors now have extended explanations that can be accessed with
9170   the `--explain` flag to `rustc`.
9171 * Many new examples have been added to the standard library
9172   documentation.
9173 * rustdoc has received a number of improvements focused on completion
9174   and polish.
9175 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9176 * Much headway was made on ecosystem-wide CI, making it possible
9177   to [compare builds for breakage][ci-compare].
9178
9179
9180 [crates.io]: http://crates.io
9181 [clo]: https://github.com/rust-lang/rust/pull/24034
9182 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9183 [con]: https://github.com/rust-lang/rust/pull/23875
9184 [cr]: https://github.com/rust-lang/rust/pull/23419
9185 [fe]: https://github.com/rust-lang/rust/pull/23879
9186 [ie]: https://github.com/rust-lang/rust/pull/23300
9187 [inv]: https://github.com/rust-lang/rust/pull/23938
9188 [ios]: https://github.com/rust-lang/rust/pull/24133
9189 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9190 [lt]: https://github.com/rust-lang/rust/pull/24057
9191 [meth]: https://github.com/rust-lang/rust/pull/24056
9192 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9193 [po]: https://github.com/rust-lang/rust/pull/24270
9194 [sf]: https://github.com/rust-lang/rust/pull/24517
9195 [slp]: https://github.com/rust-lang/rust/pull/23949
9196 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9197 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9198 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9199 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9200 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9201 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9202 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9203 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9204 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9205 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9206 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9207 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9208 [reflect]: https://github.com/rust-lang/rust/pull/23712
9209 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9210 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9211 [index-value]: https://github.com/rust-lang/rust/pull/23601
9212 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9213 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9214 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9215 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9216 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9217 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9218
9219
9220 Version 1.0.0-alpha.2 (2015-02-20)
9221 =====================================
9222
9223 * ~1300 changes, numerous bugfixes
9224
9225 * Highlights
9226
9227     * The various I/O modules were [overhauled][io-rfc] to reduce
9228       unnecessary abstractions and provide better interoperation with
9229       the underlying platform. The old `io` module remains temporarily
9230       at `std::old_io`.
9231     * The standard library now [participates in feature gating][feat],
9232       so use of unstable libraries now requires a `#![feature(...)]`
9233       attribute. The impact of this change is [described on the
9234       forum][feat-forum]. [RFC][feat-rfc].
9235
9236 * Language
9237
9238     * `for` loops [now operate on the `IntoIterator` trait][into],
9239       which eliminates the need to call `.iter()`, etc. to iterate
9240       over collections. There are some new subtleties to remember
9241       though regarding what sort of iterators various types yield, in
9242       particular that `for foo in bar { }` yields values from a move
9243       iterator, destroying the original collection. [RFC][into-rfc].
9244     * Objects now have [default lifetime bounds][obj], so you don't
9245       have to write `Box<Trait+'static>` when you don't care about
9246       storing references. [RFC][obj-rfc].
9247     * In types that implement `Drop`, [lifetimes must outlive the
9248       value][drop]. This will soon make it possible to safely
9249       implement `Drop` for types where `#[unsafe_destructor]` is now
9250       required. Read the [gorgeous RFC][drop-rfc] for details.
9251     * The fully qualified <T as Trait>::X syntax lets you set the Self
9252       type for a trait method or associated type. [RFC][ufcs-rfc].
9253     * References to types that implement `Deref<U>` now [automatically
9254       coerce to references][deref] to the dereferenced type `U`,
9255       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9256       should eliminate many unsightly uses of `&*`, as when converting
9257       from references to vectors into references to
9258       slices. [RFC][deref-rfc].
9259     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9260       `|:|`) is obsolete and closure kind is inferred from context.
9261     * [`Self` is a keyword][Self].
9262
9263 * Libraries
9264
9265     * The `Show` and `String` formatting traits [have been
9266       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9267       their related purposes. Automatically getting a string
9268       conversion to use with `format!("{:?}", something_to_debug)` is
9269       now written `#[derive(Debug)]`.
9270     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9271       OsStr}`, provide strings in platform-specific encodings for easier
9272       interop with system APIs. [RFC][osstr-rfc].
9273     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9274       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9275       creating raw pointers.
9276
9277 * Tooling
9278
9279     * Certain long error messages of the form 'expected foo found bar'
9280       are now [split neatly across multiple
9281       lines][multiline]. Examples in the PR.
9282     * On Unix Rust can be [uninstalled][un] by running
9283       `/usr/local/lib/rustlib/uninstall.sh`.
9284     * The `#[rustc_on_unimplemented]` attribute, requiring the
9285       'on_unimplemented' feature, lets rustc [display custom error
9286       messages when a trait is expected to be implemented for a type
9287       but is not][onun].
9288
9289 * Misc
9290
9291     * Rust is tested against a [LALR grammar][lalr], which parses
9292       almost all the Rust files that rustc does.
9293
9294 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9295 [close]: https://github.com/rust-lang/rust/pull/21843
9296 [deref]: https://github.com/rust-lang/rust/pull/21351
9297 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9298 [drop]: https://github.com/rust-lang/rust/pull/21972
9299 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9300 [feat]: https://github.com/rust-lang/rust/pull/21248
9301 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9302 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9303 [fmt]: https://github.com/rust-lang/rust/pull/21457
9304 [into]: https://github.com/rust-lang/rust/pull/20790
9305 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9306 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9307 [lalr]: https://github.com/rust-lang/rust/pull/21452
9308 [multiline]: https://github.com/rust-lang/rust/pull/19870
9309 [obj]: https://github.com/rust-lang/rust/pull/22230
9310 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9311 [onun]: https://github.com/rust-lang/rust/pull/20889
9312 [osstr]: https://github.com/rust-lang/rust/pull/21488
9313 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9314 [Self]: https://github.com/rust-lang/rust/pull/22158
9315 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9316 [un]: https://github.com/rust-lang/rust/pull/22256
9317
9318
9319 Version 1.0.0-alpha (2015-01-09)
9320 ==================================
9321
9322   * ~2400 changes, numerous bugfixes
9323
9324   * Highlights
9325
9326     * The language itself is considered feature complete for 1.0,
9327       though there will be many usability improvements and bugfixes
9328       before the final release.
9329     * Nearly 50% of the public API surface of the standard library has
9330       been declared 'stable'. Those interfaces are unlikely to change
9331       before 1.0.
9332     * The long-running debate over integer types has been
9333       [settled][ints]: Rust will ship with types named `isize` and
9334       `usize`, rather than `int` and `uint`, for pointer-sized
9335       integers. Guidelines will be rolled out during the alpha cycle.
9336     * Most crates that are not `std` have been moved out of the Rust
9337       distribution into the Cargo ecosystem so they can evolve
9338       separately and don't need to be stabilized as quickly, including
9339       'time', 'getopts', 'num', 'regex', and 'term'.
9340     * Documentation continues to be expanded with more API coverage, more
9341       examples, and more in-depth explanations. The guides have been
9342       consolidated into [The Rust Programming Language][trpl].
9343     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9344     * All official Rust binary installers now come with [Cargo], the
9345       Rust package manager.
9346
9347 * Language
9348
9349     * Closures have been [completely redesigned][unboxed] to be
9350       implemented in terms of traits, can now be used as generic type
9351       bounds and thus monomorphized and inlined, or via an opaque
9352       pointer (boxed) as in the old system. The new system is often
9353       referred to as 'unboxed' closures.
9354     * Traits now support [associated types][assoc], allowing families
9355       of related types to be defined together and used generically in
9356       powerful ways.
9357     * Enum variants are [namespaced by their type names][enum].
9358     * [`where` clauses][where] provide a more versatile and attractive
9359       syntax for specifying generic bounds, though the previous syntax
9360       remains valid.
9361     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9362       numeric types.
9363     * Rust [no longer has a runtime][rt] of any description, and only
9364       supports OS threads, not green threads.
9365     * At long last, Rust has been overhauled for 'dynamically-sized
9366       types' ([DST]), which integrates 'fat pointers' (object types,
9367       arrays, and `str`) more deeply into the type system, making it
9368       more consistent.
9369     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9370       `..j` that produce range types and which, when combined with the
9371       `Index` operator and multidispatch, leads to a convenient slice
9372       notation, `[i..j]`.
9373     * The new range syntax revealed an ambiguity in the fixed-length
9374       array syntax, so now fixed length arrays [are written `[T;
9375       N]`][arrays].
9376     * The `Copy` trait is no longer implemented automatically. Unsafe
9377       pointers no longer implement `Sync` and `Send` so types
9378       containing them don't automatically either. `Sync` and `Send`
9379       are now 'unsafe traits' so one can "forcibly" implement them via
9380       `unsafe impl` if a type confirms to the requirements for them
9381       even though the internals do not (e.g. structs containing unsafe
9382       pointers like `Arc`). These changes are intended to prevent some
9383       footguns and are collectively known as [opt-in built-in
9384       traits][oibit] (though `Sync` and `Send` will soon become pure
9385       library types unknown to the compiler).
9386     * Operator traits now take their operands [by value][ops], and
9387       comparison traits can use multidispatch to compare one type
9388       against multiple other types, allowing e.g. `String` to be
9389       compared with `&str`.
9390     * `if let` and `while let` are no longer feature-gated.
9391     * Rust has adopted a more [uniform syntax for escaping unicode
9392       characters][unicode].
9393     * `macro_rules!` [has been declared stable][mac]. Though it is a
9394       flawed system it is sufficiently popular that it must be usable
9395       for 1.0. Effort has gone into [future-proofing][mac-future] it
9396       in ways that will allow other macro systems to be developed in
9397       parallel, and won't otherwise impact the evolution of the
9398       language.
9399     * The prelude has been [pared back significantly][prelude] such
9400       that it is the minimum necessary to support the most pervasive
9401       code patterns, and through [generalized where clauses][where]
9402       many of the prelude extension traits have been consolidated.
9403     * Rust's rudimentary reflection [has been removed][refl], as it
9404       incurred too much code generation for little benefit.
9405     * [Struct variants][structvars] are no longer feature-gated.
9406     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9407       known as 'higher-ranked trait bounds', this crucially allows
9408       unboxed closures to work.
9409     * Macros invocations surrounded by parens or square brackets and
9410       not terminated by a semicolon are [parsed as
9411       expressions][macros], which makes expressions like `vec![1i32,
9412       2, 3].len()` work as expected.
9413     * Trait objects now implement their traits automatically, and
9414       traits that can be coerced to objects now must be [object
9415       safe][objsafe].
9416     * Automatically deriving traits is now done with `#[derive(...)]`
9417       not `#[deriving(...)]` for [consistency with other naming
9418       conventions][derive].
9419     * Importing the containing module or enum at the same time as
9420       items or variants they contain is [now done with `self` instead
9421       of `mod`][self], as in use `foo::{self, bar}`
9422     * Glob imports are no longer feature-gated.
9423     * The `box` operator and `box` patterns have been feature-gated
9424       pending a redesign. For now unique boxes should be allocated
9425       like other containers, with `Box::new`.
9426
9427 * Libraries
9428
9429     * A [series][coll1] of [efforts][coll2] to establish
9430       [conventions][coll3] for collections types has resulted in API
9431       improvements throughout the standard library.
9432     * New [APIs for error handling][err] provide ergonomic interop
9433       between error types, and [new conventions][err-conv] describe
9434       more clearly the recommended error handling strategies in Rust.
9435     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9436       it is easier to discuss failure in the context of error handling
9437       without making clarifications as to whether you are referring to
9438       the 'fail' macro or failure more generally.
9439     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9440       syscall when available.
9441     * The 'serialize' crate has been renamed 'rustc-serialize' and
9442       moved out of the distribution to Cargo. Although it is widely
9443       used now, it is expected to be superseded in the near future.
9444     * The `Show` formatter, typically implemented with
9445       `#[derive(Show)]` is [now requested with the `{:?}`
9446       specifier][show] and is intended for use by all types, for uses
9447       such as `println!` debugging. The new `String` formatter must be
9448       implemented by hand, uses the `{}` specifier, and is intended
9449       for full-fidelity conversions of things that can logically be
9450       represented as strings.
9451
9452 * Tooling
9453
9454     * [Flexible target specification][flex] allows rustc's code
9455       generation to be configured to support otherwise-unsupported
9456       platforms.
9457     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9458       respective debuggers with Rust-appropriate pretty-printing.
9459     * The Windows installation of Rust is distributed with the
9460       MinGW components currently required to link binaries on that
9461       platform.
9462
9463 * Misc
9464
9465     * Nullable enum optimizations have been extended to more types so
9466       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9467       space than the inner types themselves.
9468     * Work has begun on supporting AArch64.
9469
9470 [Cargo]: https://crates.io
9471 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9472 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9473 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9474 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9475 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9476 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9477 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9478 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9479 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9480 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9481 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9482 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9483 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9484 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9485 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9486 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9487 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9488 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9489 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9490 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9491 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9492 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9493 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9494 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9495 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9496 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9497 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9498 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9499 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9500 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9501 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9502 [trpl]: https://doc.rust-lang.org/book/index.html
9503 [rbe]: http://rustbyexample.com/
9504
9505
9506 Version 0.12.0 (2014-10-09)
9507 =============================
9508
9509   * ~1900 changes, numerous bugfixes
9510
9511   * Highlights
9512
9513     * The introductory documentation (now called The Rust Guide) has
9514       been completely rewritten, as have a number of supplementary
9515       guides.
9516     * Rust's package manager, Cargo, continues to improve and is
9517       sometimes considered to be quite awesome.
9518     * Many API's in `std` have been reviewed and updated for
9519       consistency with the in-development Rust coding
9520       guidelines. The standard library documentation tracks
9521       stabilization progress.
9522     * Minor libraries have been moved out-of-tree to the rust-lang org
9523       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9524       be installed with Cargo.
9525     * Lifetime elision allows lifetime annotations to be left off of
9526       function declarations in many common scenarios.
9527     * Rust now works on 64-bit Windows.
9528
9529   * Language
9530     * Indexing can be overloaded with the `Index` and `IndexMut`
9531       traits.
9532     * The `if let` construct takes a branch only if the `let` pattern
9533       matches, currently behind the 'if_let' feature gate.
9534     * 'where clauses', a more flexible syntax for specifying trait
9535       bounds that is more aesthetic, have been added for traits and
9536       free functions. Where clauses will in the future make it
9537       possible to constrain associated types, which would be
9538       impossible with the existing syntax.
9539     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9540       the 'slicing_syntax' feature gate, and can be overloaded with
9541       the `Slice` or `SliceMut` traits.
9542     * The syntax for matching of sub-slices has been changed to use a
9543       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9544       consistency with other uses of `..` and to future-proof
9545       potential additional uses of the syntax.
9546     * The syntax for matching inclusive ranges in patterns has changed
9547       from `0..3` to `0...4` to be consistent with the exclusive range
9548       syntax for slicing.
9549     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9550       c]`) has been put behind the 'advanced_slice_patterns' feature
9551       gate and may be removed in the future.
9552     * Components of tuples and tuple structs can be extracted using
9553       the `value.0` syntax, currently behind the `tuple_indexing`
9554       feature gate.
9555     * The `#[crate_id]` attribute is no longer supported; versioning
9556       is handled by the package manager.
9557     * Renaming crate imports are now written `extern crate foo as bar`
9558       instead of `extern crate bar = foo`.
9559     * Renaming use statements are now written `use foo as bar` instead
9560       of `use bar = foo`.
9561     * `let` and `match` bindings and argument names in macros are now
9562       hygienic.
9563     * The new, more efficient, closure types ('unboxed closures') have
9564       been added under a feature gate, 'unboxed_closures'. These will
9565       soon replace the existing closure types, once higher-ranked
9566       trait lifetimes are added to the language.
9567     * `move` has been added as a keyword, for indicating closures
9568       that capture by value.
9569     * Mutation and assignment is no longer allowed in pattern guards.
9570     * Generic structs and enums can now have trait bounds.
9571     * The `Share` trait is now called `Sync` to free up the term
9572       'shared' to refer to 'shared reference' (the default reference
9573       type.
9574     * Dynamically-sized types have been mostly implemented,
9575       unifying the behavior of fat-pointer types with the rest of the
9576       type system.
9577     * As part of dynamically-sized types, the `Sized` trait has been
9578       introduced, which qualifying types implement by default, and
9579       which type parameters expect by default. To specify that a type
9580       parameter does not need to be sized, write `<Sized? T>`. Most
9581       types are `Sized`, notable exceptions being unsized arrays
9582       (`[T]`) and trait types.
9583     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9584     * Lifetime bounds can now be applied to type parameters and object
9585       types.
9586     * The old, reference counted GC type, `Gc<T>` which was once
9587       denoted by the `@` sigil, has finally been removed. GC will be
9588       revisited in the future.
9589
9590   * Libraries
9591     * Library documentation has been improved for a number of modules.
9592     * Bit-vectors, collections::bitv has been modernized.
9593     * The url crate is deprecated in favor of
9594       http://github.com/servo/rust-url, which can be installed with
9595       Cargo.
9596     * Most I/O stream types can be cloned and subsequently closed from
9597       a different thread.
9598     * A `std::time::Duration` type has been added for use in I/O
9599       methods that rely on timers, as well as in the 'time' crate's
9600       `Timespec` arithmetic.
9601     * The runtime I/O abstraction layer that enabled the green thread
9602       scheduler to do non-thread-blocking I/O has been removed, along
9603       with the libuv-based implementation employed by the green thread
9604       scheduler. This will greatly simplify the future I/O work.
9605     * `collections::btree` has been rewritten to have a more
9606       idiomatic and efficient design.
9607
9608   * Tooling
9609     * rustdoc output now indicates the stability levels of API's.
9610     * The `--crate-name` flag can specify the name of the crate
9611       being compiled, like `#[crate_name]`.
9612     * The `-C metadata` specifies additional metadata to hash into
9613       symbol names, and `-C extra-filename` specifies additional
9614       information to put into the output filename, for use by the
9615       package manager for versioning.
9616     * debug info generation has continued to improve and should be
9617       more reliable under both gdb and lldb.
9618     * rustc has experimental support for compiling in parallel
9619       using the `-C codegen-units` flag.
9620     * rustc no longer encodes rpath information into binaries by
9621       default.
9622
9623   * Misc
9624     * Stack usage has been optimized with LLVM lifetime annotations.
9625     * Official Rust binaries on Linux are more compatible with older
9626       kernels and distributions, built on CentOS 5.10.
9627
9628
9629 Version 0.11.0 (2014-07-02)
9630 ==========================
9631
9632   * ~1700 changes, numerous bugfixes
9633
9634   * Language
9635     * ~[T] has been removed from the language. This type is superseded by
9636       the Vec<T> type.
9637     * ~str has been removed from the language. This type is superseded by
9638       the String type.
9639     * ~T has been removed from the language. This type is superseded by the
9640       Box<T> type.
9641     * @T has been removed from the language. This type is superseded by the
9642       standard library's std::gc::Gc<T> type.
9643     * Struct fields are now all private by default.
9644     * Vector indices and shift amounts are both required to be a `uint`
9645       instead of any integral type.
9646     * Byte character, byte string, and raw byte string literals are now all
9647       supported by prefixing the normal literal with a `b`.
9648     * Multiple ABIs are no longer allowed in an ABI string
9649     * The syntax for lifetimes on closures/procedures has been tweaked
9650       slightly: `<'a>|A, B|: 'b + K -> T`
9651     * Floating point modulus has been removed from the language; however it
9652       is still provided by a library implementation.
9653     * Private enum variants are now disallowed.
9654     * The `priv` keyword has been removed from the language.
9655     * A closure can no longer be invoked through a &-pointer.
9656     * The `use foo, bar, baz;` syntax has been removed from the language.
9657     * The transmute intrinsic no longer works on type parameters.
9658     * Statics now allow blocks/items in their definition.
9659     * Trait bounds are separated from objects with + instead of : now.
9660     * Objects can no longer be read while they are mutably borrowed.
9661     * The address of a static is now marked as insignificant unless the
9662       #[inline(never)] attribute is placed it.
9663     * The #[unsafe_destructor] attribute is now behind a feature gate.
9664     * Struct literals are no longer allowed in ambiguous positions such as
9665       if, while, match, and for..in.
9666     * Declaration of lang items and intrinsics are now feature-gated by
9667       default.
9668     * Integral literals no longer default to `int`, and floating point
9669       literals no longer default to `f64`. Literals must be suffixed with an
9670       appropriate type if inference cannot determine the type of the
9671       literal.
9672     * The Box<T> type is no longer implicitly borrowed to &mut T.
9673     * Procedures are now required to not capture borrowed references.
9674
9675   * Libraries
9676     * The standard library is now a "facade" over a number of underlying
9677       libraries. This means that development on the standard library should
9678       be speedier due to smaller crates, as well as a clearer line between
9679       all dependencies.
9680     * A new library, libcore, lives under the standard library's facade
9681       which is Rust's "0-assumption" library, suitable for embedded and
9682       kernel development for example.
9683     * A regex crate has been added to the standard distribution. This crate
9684       includes statically compiled regular expressions.
9685     * The unwrap/unwrap_err methods on Result require a Show bound for
9686       better error messages.
9687     * The return types of the std::comm primitives have been centralized
9688       around the Result type.
9689     * A number of I/O primitives have gained the ability to time out their
9690       operations.
9691     * A number of I/O primitives have gained the ability to close their
9692       reading/writing halves to cancel pending operations.
9693     * Reverse iterator methods have been removed in favor of `rev()` on
9694       their forward-iteration counterparts.
9695     * A bitflags! macro has been added to enable easy interop with C and
9696       management of bit flags.
9697     * A debug_assert! macro is now provided which is disabled when
9698       `--cfg ndebug` is passed to the compiler.
9699     * A graphviz crate has been added for creating .dot files.
9700     * The std::cast module has been migrated into std::mem.
9701     * The std::local_data api has been migrated from freestanding functions
9702       to being based on methods.
9703     * The Pod trait has been renamed to Copy.
9704     * jemalloc has been added as the default allocator for types.
9705     * The API for allocating memory has been changed to use proper alignment
9706       and sized deallocation
9707     * Connecting a TcpStream or binding a TcpListener is now based on a
9708       string address and a u16 port. This allows connecting to a hostname as
9709       opposed to an IP.
9710     * The Reader trait now contains a core method, read_at_least(), which
9711       correctly handles many repeated 0-length reads.
9712     * The process-spawning API is now centered around a builder-style
9713       Command struct.
9714     * The :? printing qualifier has been moved from the standard library to
9715       an external libdebug crate.
9716     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9717       have been renamed to Eq/Ord.
9718     * The select/plural methods have been removed from format!. The escapes
9719       for { and } have also changed from \{ and \} to {{ and }},
9720       respectively.
9721     * The TaskBuilder API has been re-worked to be a true builder, and
9722       extension traits for spawning native/green tasks have been added.
9723
9724   * Tooling
9725     * All breaking changes to the language or libraries now have their
9726       commit message annotated with `[breaking-change]` to allow for easy
9727       discovery of breaking changes.
9728     * The compiler will now try to suggest how to annotate lifetimes if a
9729       lifetime-related error occurs.
9730     * Debug info continues to be improved greatly with general bug fixes and
9731       better support for situations like link time optimization (LTO).
9732     * Usage of syntax extensions when cross-compiling has been fixed.
9733     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9734       -fdata-sections and --gc-sections has been enabled by default
9735     * The compiler is now stricter about where it will load module files
9736       from when a module is declared via `mod foo;`.
9737     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9738       Syntax extensions are now discovered via a "plugin registrar" type
9739       which will be extended in the future to other various plugins.
9740     * Lints have been restructured to allow for dynamically loadable lints.
9741     * A number of rustdoc improvements:
9742       * The HTML output has been visually redesigned.
9743       * Markdown is now powered by hoedown instead of sundown.
9744       * Searching heuristics have been greatly improved.
9745       * The search index has been reduced in size by a great amount.
9746       * Cross-crate documentation via `pub use` has been greatly improved.
9747       * Primitive types are now hyperlinked and documented.
9748     * Documentation has been moved from static.rust-lang.org/doc to
9749       doc.rust-lang.org
9750     * A new sandbox, play.rust-lang.org, is available for running and
9751       sharing rust code examples on-line.
9752     * Unused attributes are now more robustly warned about.
9753     * The dead_code lint now warns about unused struct fields.
9754     * Cross-compiling to iOS is now supported.
9755     * Cross-compiling to mipsel is now supported.
9756     * Stability attributes are now inherited by default and no longer apply
9757       to intra-crate usage, only inter-crate usage.
9758     * Error message related to non-exhaustive match expressions have been
9759       greatly improved.
9760
9761
9762 Version 0.10 (2014-04-03)
9763 =========================
9764
9765   * ~1500 changes, numerous bugfixes
9766
9767   * Language
9768     * A new RFC process is now in place for modifying the language.
9769     * Patterns with `@`-pointers have been removed from the language.
9770     * Patterns with unique vectors (`~[T]`) have been removed from the
9771       language.
9772     * Patterns with unique strings (`~str`) have been removed from the
9773       language.
9774     * `@str` has been removed from the language.
9775     * `@[T]` has been removed from the language.
9776     * `@self` has been removed from the language.
9777     * `@Trait` has been removed from the language.
9778     * Headers on `~` allocations which contain `@` boxes inside the type for
9779       reference counting have been removed.
9780     * The semantics around the lifetimes of temporary expressions have changed,
9781       see #3511 and #11585 for more information.
9782     * Cross-crate syntax extensions are now possible, but feature gated. See
9783       #11151 for more information. This includes both `macro_rules!` macros as
9784       well as syntax extensions such as `format!`.
9785     * New lint modes have been added, and older ones have been turned on to be
9786       warn-by-default.
9787       * Unnecessary parentheses
9788       * Uppercase statics
9789       * Camel Case types
9790       * Uppercase variables
9791       * Publicly visible private types
9792       * `#[deriving]` with raw pointers
9793     * Unsafe functions can no longer be coerced to closures.
9794     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9795     * The `#[simd]` attribute is now behind a feature gate.
9796     * Visibility is no longer allowed on `extern crate` statements, and
9797       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9798     * Trailing commas are now allowed in argument lists and tuple patterns.
9799     * The `do` keyword has been removed, it is now a reserved keyword.
9800     * Default type parameters have been implemented, but are feature gated.
9801     * Borrowed variables through captures in closures are now considered soundly.
9802     * `extern mod` is now `extern crate`
9803     * The `Freeze` trait has been removed.
9804     * The `Share` trait has been added for types that can be shared among
9805       threads.
9806     * Labels in macros are now hygienic.
9807     * Expression/statement macro invocations can be delimited with `{}` now.
9808     * Treatment of types allowed in `static mut` locations has been tweaked.
9809     * The `*` and `.` operators are now overloadable through the `Deref` and
9810       `DerefMut` traits.
9811     * `~Trait` and `proc` no longer have `Send` bounds by default.
9812     * Partial type hints are now supported with the `_` type marker.
9813     * An `Unsafe` type was introduced for interior mutability. It is now
9814       considered undefined to transmute from `&T` to `&mut T` without using the
9815       `Unsafe` type.
9816     * The #[linkage] attribute was implemented for extern statics/functions.
9817     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9818     * `Pod` was renamed to `Copy`.
9819
9820   * Libraries
9821     * The `libextra` library has been removed. It has now been decomposed into
9822       component libraries with smaller and more focused nuggets of
9823       functionality. The full list of libraries can be found on the
9824       documentation index page.
9825     * std: `std::condition` has been removed. All I/O errors are now propagated
9826       through the `Result` type. In order to assist with error handling, a
9827       `try!` macro for unwrapping errors with an early return and a lint for
9828       unused results has been added. See #12039 for more information.
9829     * std: The `vec` module has been renamed to `slice`.
9830     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9831       This will become the only growable vector in the future.
9832     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9833       are now found at `std::io::BufferedReader` instead of
9834       `std::io::buffered::BufferedReader`.
9835     * std: `print` and `println` are no longer in the prelude, the `print!` and
9836       `println!` macros are intended to be used instead.
9837     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9838       attempts to statically prevent cycles.
9839     * std: The standard distribution is adopting the policy of pushing failure
9840       to the user rather than failing in libraries. Many functions (such as
9841       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9842     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9843       deriving mode: `#[deriving(Show)]`.
9844     * std: `ToStr` is now implemented for all types implementing `Show`.
9845     * std: The formatting trait methods now take `&self` instead of `&T`
9846     * std: The `invert()` method on iterators has been renamed to `rev()`
9847     * std: `std::num` has seen a reduction in the genericity of its traits,
9848       consolidating functionality into a few core traits.
9849     * std: Backtraces are now printed on task failure if the environment
9850       variable `RUST_BACKTRACE` is present.
9851     * std: Naming conventions for iterators have been standardized. More details
9852       can be found on the wiki's style guide.
9853     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9854       still implement the function.
9855     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9856     * std: `assert_approx_eq!` has been removed
9857     * std: The `e` and `E` formatting specifiers for floats have been added to
9858       print them in exponential notation.
9859     * std: The `Times` trait has been removed
9860     * std: Indications of variance and opting out of builtin bounds is done
9861       through marker types in `std::kinds::marker` now
9862     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9863       `#[deriving(Hash)]` is now possible.
9864     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9865     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9866     * std: `Chan::new` is now `channel()`.
9867     * std: A new synchronous channel type has been implemented.
9868     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9869     * std: `hashmap` and `trie` have been moved to `libcollections`
9870     * std: `run` has been rolled into `io::process`
9871     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9872     * std: The equality and comparison traits have seen some reorganization.
9873     * std: `rand` has moved to `librand`.
9874     * std: `to_{lower,upper}case` has been implemented for `char`.
9875     * std: Logging has been moved to `liblog`.
9876     * collections: `HashMap` has been rewritten for higher performance and less
9877       memory usage.
9878     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9879       it can be booted manually. The runtime guide has more information and
9880       examples.
9881     * native: All I/O functionality except signals has been implemented.
9882     * green: Task spawning with `libgreen` has been optimized with stack caching
9883       and various trimming of code.
9884     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9885     * sync: The `extra::sync` module has been updated to modern rust (and moved
9886       to the `sync` library), tweaking and improving various interfaces while
9887       dropping redundant functionality.
9888     * sync: A new `Barrier` type has been added to the `sync` library.
9889     * sync: An efficient mutex for native and green tasks has been implemented.
9890     * serialize: The `base64` module has seen some improvement. It treats
9891       newlines better, has non-string error values, and has seen general
9892       cleanup.
9893     * fourcc: A `fourcc!` macro was introduced
9894     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9895       hexadecimal literal.
9896
9897   * Tooling
9898     * `rustpkg` has been deprecated and removed from the main repository. Its
9899       replacement, `cargo`, is under development.
9900     * Nightly builds of rust are now available
9901     * The memory usage of rustc has been improved many times throughout this
9902       release cycle.
9903     * The build process supports disabling rpath support for the rustc binary
9904       itself.
9905     * Code generation has improved in some cases, giving more information to the
9906       LLVM optimization passes to enable more extensive optimizations.
9907     * Debuginfo compatibility with lldb on OSX has been restored.
9908     * The master branch is now gated on an android bot, making building for
9909       android much more reliable.
9910     * Output flags have been centralized into one `--emit` flag.
9911     * Crate type flags have been centralized into one `--crate-type` flag.
9912     * Codegen flags have been consolidated behind a `-C` flag.
9913     * Linking against outdated crates now has improved error messages.
9914     * Error messages with lifetimes will often suggest how to annotate the
9915       function to fix the error.
9916     * Many more types are documented in the standard library, and new guides
9917       were written.
9918     * Many `rustdoc` improvements:
9919       * code blocks are syntax highlighted.
9920       * render standalone markdown files.
9921       * the --test flag tests all code blocks by default.
9922       * exported macros are displayed.
9923       * re-exported types have their documentation inlined at the location of the
9924         first re-export.
9925       * search works across crates that have been rendered to the same output
9926         directory.
9927
9928
9929 Version 0.9 (2014-01-09)
9930 ==========================
9931
9932    * ~1800 changes, numerous bugfixes
9933
9934    * Language
9935       * The `float` type has been removed. Use `f32` or `f64` instead.
9936       * A new facility for enabling experimental features (feature gating) has
9937         been added, using the crate-level `#[feature(foo)]` attribute.
9938       * Managed boxes (@) are now behind a feature gate
9939         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9940         standard library's `Gc` or `Rc` types instead.
9941       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9942       * Jumping back to the top of a loop is now done with `continue` instead of
9943         `loop`.
9944       * Strings can no longer be mutated through index assignment.
9945       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9946         hash delimiters, as in `r###"foo"###`.
9947       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9948         called once.
9949       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9950       * `@fn`s have been removed.
9951       * `do` only works with procs in order to make it obvious what the cost
9952         of `do` is.
9953       * Single-element tuple-like structs can no longer be dereferenced to
9954         obtain the inner value. A more comprehensive solution for overloading
9955         the dereference operator will be provided in the future.
9956       * The `#[link(...)]` attribute has been replaced with
9957         `#[crate_id = "name#vers"]`.
9958       * Empty `impl`s must be terminated with empty braces and may not be
9959         terminated with a semicolon.
9960       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9961         no longer has any special meaning.
9962       * The old `fmt!` string formatting macro has been removed.
9963       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9964         `print!` and `println!`.
9965       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9966       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9967         `extern mod foo = "bar"` instead.
9968       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9969       * Macros can have attributes.
9970       * Macros can expand to items with attributes.
9971       * Macros can expand to multiple items.
9972       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9973       * Comments may be nested.
9974       * Values automatically coerce to trait objects they implement, without
9975         an explicit `as`.
9976       * Enum discriminants are no longer an entire word but as small as needed to
9977         contain all the variants. The `repr` attribute can be used to override
9978         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9979         `#[repr(C)]` to match C enums.
9980       * Non-string literals are not allowed in attributes (they never worked).
9981       * The FFI now supports variadic functions.
9982       * Octal numeric literals, as in `0o7777`.
9983       * The `concat!` syntax extension performs compile-time string concatenation.
9984       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9985         removed as Rust no longer uses segmented stacks.
9986       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9987       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9988         not `*`; ignoring remaining fields of a struct is also done with `..`,
9989         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9990       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9991       * `rustc` supports the "system" calling convention, which defaults to the
9992         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9993         "C" elsewhere.
9994       * The `type_overflow` lint (default: warn) checks literals for overflow.
9995       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9996       * The `attribute_usage` lint (default: warn) warns about unknown
9997         attributes.
9998       * The `unknown_features` lint (default: warn) warns about unknown
9999         feature gates.
10000       * The `dead_code` lint (default: warn) checks for dead code.
10001       * Rust libraries can be linked statically to one another
10002       * `#[link_args]` is behind the `link_args` feature gate.
10003       * Native libraries are now linked with `#[link(name = "foo")]`
10004       * Native libraries can be statically linked to a rust crate
10005         (`#[link(name = "foo", kind = "static")]`).
10006       * Native OS X frameworks are now officially supported
10007         (`#[link(name = "foo", kind = "framework")]`).
10008       * The `#[thread_local]` attribute creates thread-local (not task-local)
10009         variables. Currently behind the `thread_local` feature gate.
10010       * The `return` keyword may be used in closures.
10011       * Types that can be copied via a memcpy implement the `Pod` kind.
10012       * The `cfg` attribute can now be used on struct fields and enum variants.
10013
10014    * Libraries
10015       * std: The `option` and `result` API's have been overhauled to make them
10016         simpler, more consistent, and more composable.
10017       * std: The entire `std::io` module has been replaced with one that is
10018         more comprehensive and that properly interfaces with the underlying
10019         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10020         implemented.
10021       * std: `io::util` contains a number of useful implementations of
10022         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10023         `ZeroReader`, `TeeReader`.
10024       * std: The reference counted pointer type `extra::rc` moved into std.
10025       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10026         just a wrapper around it).
10027       * std: The `Either` type has been removed.
10028       * std: `fmt::Default` can be implemented for any type to provide default
10029         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10030       * std: The `rand` API continues to be tweaked.
10031       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10032         on failure in gdb, is now named `rust_fail`.
10033       * std: The `each_key` and `each_value` methods on `HashMap` have been
10034         replaced by the `keys` and `values` iterators.
10035       * std: Functions dealing with type size and alignment have moved from the
10036         `sys` module to the `mem` module.
10037       * std: The `path` module was written and API changed.
10038       * std: `str::from_utf8` has been changed to cast instead of allocate.
10039       * std: `starts_with` and `ends_with` methods added to vectors via the
10040         `ImmutableEqVector` trait, which is in the prelude.
10041       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10042         if the index is out of bounds.
10043       * std: Task failure no longer propagates between tasks, as the model was
10044         complex, expensive, and incompatible with thread-based tasks.
10045       * std: The `Any` type can be used for dynamic typing.
10046       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10047         `task::try`.
10048       * std: Methods that produce iterators generally do not have an `_iter`
10049         suffix now.
10050       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10051         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10052       * std: `util::ignore` renamed to `prelude::drop`.
10053       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10054         trait.
10055       * std: `vec::raw` has seen a lot of cleanup and API changes.
10056       * std: The standard library no longer includes any C++ code, and very
10057         minimal C, eliminating the dependency on libstdc++.
10058       * std: Runtime scheduling and I/O functionality has been factored out into
10059         extensible interfaces and is now implemented by two different crates:
10060         libnative, for native threading and I/O; and libgreen, for green threading
10061         and I/O. This paves the way for using the standard library in more limited
10062         embedded environments.
10063       * std: The `comm` module has been rewritten to be much faster, have a
10064         simpler, more consistent API, and to work for both native and green
10065         threading.
10066       * std: All libuv dependencies have been moved into the rustuv crate.
10067       * native: New implementations of runtime scheduling on top of OS threads.
10068       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10069         and other I/O.
10070       * green: The green thread scheduler and message passing types are almost
10071         entirely lock-free.
10072       * extra: The `flatpipes` module had bitrotted and was removed.
10073       * extra: All crypto functions have been removed and Rust now has a policy of
10074         not reimplementing crypto in the standard library. In the future crypto
10075         will be provided by external crates with bindings to established libraries.
10076       * extra: `c_vec` has been modernized.
10077       * extra: The `sort` module has been removed. Use the `sort` method on
10078         mutable slices.
10079
10080    * Tooling
10081       * The `rust` and `rusti` commands have been removed, due to lack of
10082         maintenance.
10083       * `rustdoc` was completely rewritten.
10084       * `rustdoc` can test code examples in documentation.
10085       * `rustpkg` can test packages with the argument, 'test'.
10086       * `rustpkg` supports arbitrary dependencies, including C libraries.
10087       * `rustc`'s support for generating debug info is improved again.
10088       * `rustc` has better error reporting for unbalanced delimiters.
10089       * `rustc`'s JIT support was removed due to bitrot.
10090       * Executables and static libraries can be built with LTO (-Z lto)
10091       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10092         build tools.
10093
10094
10095 Version 0.8 (2013-09-26)
10096 ============================
10097
10098    * ~2200 changes, numerous bugfixes
10099
10100    * Language
10101       * The `for` loop syntax has changed to work with the `Iterator` trait.
10102       * At long last, unwinding works on Windows.
10103       * Default methods are ready for use.
10104       * Many trait inheritance bugs fixed.
10105       * Owned and borrowed trait objects work more reliably.
10106       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10107       * rustc can omit emission of code for the `debug!` macro if it is passed
10108         `--cfg ndebug`
10109       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10110         for foo.rs, then foo/mod.rs, and will generate an error when both are
10111         present.
10112       * Strings no longer contain trailing nulls. The new `std::c_str` module
10113         provides new mechanisms for converting to C strings.
10114       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10115       * The FFI has been overhauled such that foreign functions are called directly,
10116         instead of through a stack-switching wrapper.
10117       * Calling a foreign function must be done through a Rust function with the
10118         `#[fixed_stack_segment]` attribute.
10119       * The `externfn!` macro can be used to declare both a foreign function and
10120         a `#[fixed_stack_segment]` wrapper at once.
10121       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10122       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10123       * `priv` is disallowed everywhere except for struct fields and enum variants.
10124       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10125       * `ref` bindings in irrefutable patterns work correctly now.
10126       * `char` is now prevented from containing invalid code points.
10127       * Casting to `bool` is no longer allowed.
10128       * `\0` is now accepted as an escape in chars and strings.
10129       * `yield` is a reserved keyword.
10130       * `typeof` is a reserved keyword.
10131       * Crates may be imported by URL with `extern mod foo = "url";`.
10132       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10133       * Static vectors can be initialized with repeating elements,
10134         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10135       * Static structs can be initialized with functional record update,
10136         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10137       * `cfg!` can be used to conditionally execute code based on the crate
10138         configuration, similarly to `#[cfg(...)]`.
10139       * The `unnecessary_qualification` lint detects unneeded module
10140         prefixes (default: allow).
10141       * Arithmetic operations have been implemented on the SIMD types in
10142         `std::unstable::simd`.
10143       * Exchange allocation headers were removed, reducing memory usage.
10144       * `format!` implements a completely new, extensible, and higher-performance
10145         string formatting system. It will replace `fmt!`.
10146       * `print!` and `println!` write formatted strings (using the `format!`
10147         extension) to stdout.
10148       * `write!` and `writeln!` write formatted strings (using the `format!`
10149         extension) to the new Writers in `std::rt::io`.
10150       * The library section in which a function or static is placed may
10151         be specified with `#[link_section = "..."]`.
10152       * The `proto!` syntax extension for defining bounded message protocols
10153         was removed.
10154       * `macro_rules!` is hygienic for `let` declarations.
10155       * The `#[export_name]` attribute specifies the name of a symbol.
10156       * `unreachable!` can be used to indicate unreachable code, and fails
10157         if executed.
10158
10159    * Libraries
10160       * std: Transitioned to the new runtime, written in Rust.
10161       * std: Added an experimental I/O library, `rt::io`, based on the new
10162         runtime.
10163       * std: A new generic `range` function was added to the prelude, replacing
10164         `uint::range` and friends.
10165       * std: `range_rev` no longer exists. Since range is an iterator it can be
10166         reversed with `range(lo, hi).invert()`.
10167       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10168         renamed to `unwrap_or`.
10169       * std: The `iterator` module was renamed to `iter`.
10170       * std: Integral types now support the `checked_add`, `checked_sub`, and
10171         `checked_mul` operations for detecting overflow.
10172       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10173         consistency.
10174       * std: Methods are standardizing on conventions for casting methods:
10175         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10176         and cheap casts.
10177       * std: The `CString` type in `c_str` provides new ways to convert to and
10178         from C strings.
10179       * std: `DoubleEndedIterator` can yield elements in two directions.
10180       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10181         two splices.
10182       * std: `str::from_bytes` renamed to `str::from_utf8`.
10183       * std: `pop_opt` and `shift_opt` methods added to vectors.
10184       * std: The task-local data interface no longer uses @, and keys are
10185         no longer function pointers.
10186       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10187       * std: Added `SharedPort` to `comm`.
10188       * std: `Eq` has a default method for `ne`; only `eq` is required
10189         in implementations.
10190       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10191         is required in implementations.
10192       * std: `is_utf8` performance is improved, impacting many string functions.
10193       * std: `os::MemoryMap` provides cross-platform mmap.
10194       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10195         are not 'in-bounds' are considered undefined.
10196       * std: Many freestanding functions in `vec` removed in favor of methods.
10197       * std: Many freestanding functions on scalar types removed in favor of
10198         methods.
10199       * std: Many options to task builders were removed since they don't make
10200         sense in the new scheduler design.
10201       * std: More containers implement `FromIterator` so can be created by the
10202         `collect` method.
10203       * std: More complete atomic types in `unstable::atomics`.
10204       * std: `comm::PortSet` removed.
10205       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10206         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10207         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10208         default implementations.
10209       * std: Various `from_str` functions were removed in favor of a generic
10210         `from_str` which is available in the prelude.
10211       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10212       * extra: `dlist`, the doubly-linked list was modernized.
10213       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10214       * extra: Added `glob` module, replacing `std::os::glob`.
10215       * extra: `rope` was removed.
10216       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10217       * extra: `net`, and `timer` were removed. The experimental replacements
10218         are `std::rt::io::net` and `std::rt::io::timer`.
10219       * extra: Iterators implemented for `SmallIntMap`.
10220       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10221       * extra: `SmallIntSet` removed. Use `BitvSet`.
10222       * extra: Performance of JSON parsing greatly improved.
10223       * extra: `semver` updated to SemVer 2.0.0.
10224       * extra: `term` handles more terminals correctly.
10225       * extra: `dbg` module removed.
10226       * extra: `par` module removed.
10227       * extra: `future` was cleaned up, with some method renames.
10228       * extra: Most free functions in `getopts` were converted to methods.
10229
10230    * Other
10231       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10232       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10233         similarly to gcc's `--march` flag.
10234       * rustc's performance compiling small crates is much better.
10235       * rustpkg has received many improvements.
10236       * rustpkg supports git tags as package IDs.
10237       * rustpkg builds into target-specific directories so it can be used for
10238         cross-compiling.
10239       * The number of concurrent test tasks is controlled by the environment
10240         variable RUST_TEST_TASKS.
10241       * The test harness can now report metrics for benchmarks.
10242       * All tools have man pages.
10243       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10244       * The runtime uses jemalloc for allocations.
10245       * Segmented stacks are temporarily disabled as part of the transition to
10246         the new runtime. Stack overflows are possible!
10247       * A new documentation backend, rustdoc_ng, is available for use. It is
10248         still invoked through the normal `rustdoc` command.
10249
10250
10251 Version 0.7 (2013-07-03)
10252 =======================
10253
10254    * ~2000 changes, numerous bugfixes
10255
10256    * Language
10257       * `impl`s no longer accept a visibility qualifier. Put them on methods
10258         instead.
10259       * The borrow checker has been rewritten with flow-sensitivity, fixing
10260         many bugs and inconveniences.
10261       * The `self` parameter no longer implicitly means `&'self self`,
10262         and can be explicitly marked with a lifetime.
10263       * Overloadable compound operators (`+=`, etc.) have been temporarily
10264         removed due to bugs.
10265       * The `for` loop protocol now requires `for`-iterators to return `bool`
10266         so they compose better.
10267       * The `Durable` trait is replaced with the `'static` bounds.
10268       * Trait default methods work more often.
10269       * Structs with the `#[packed]` attribute have byte alignment and
10270         no padding between fields.
10271       * Type parameters bound by `Copy` must now be copied explicitly with
10272         the `copy` keyword.
10273       * It is now illegal to move out of a dereferenced unsafe pointer.
10274       * `Option<~T>` is now represented as a nullable pointer.
10275       * `@mut` does dynamic borrow checks correctly.
10276       * The `main` function is only detected at the topmost level of the crate.
10277         The `#[main]` attribute is still valid anywhere.
10278       * Struct fields may no longer be mutable. Use inherited mutability.
10279       * The `#[no_send]` attribute makes a type that would otherwise be
10280         `Send`, not.
10281       * The `#[no_freeze]` attribute makes a type that would otherwise be
10282         `Freeze`, not.
10283       * Unbounded recursion will abort the process after reaching the limit
10284         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10285       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10286         are never implicitly copyable.
10287       * `#[static_assert]` makes compile-time assertions about static bools.
10288       * At long last, 'argument modes' no longer exist.
10289       * The rarely used `use mod` statement no longer exists.
10290
10291    * Syntax extensions
10292       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10293         argument list.
10294       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10295         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10296         `#[deriving(...)]`.
10297       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10298         and unsuffixed integer literals.
10299
10300    * Libraries
10301       * The `core` crate was renamed to `std`.
10302       * The `std` crate was renamed to `extra`.
10303       * More and improved documentation.
10304       * std: `iterator` module for external iterator objects.
10305       * Many old-style (internal, higher-order function) iterators replaced by
10306         implementations of `Iterator`.
10307       * std: Many old internal vector and string iterators,
10308         incl. `any`, `all`. removed.
10309       * std: The `finalize` method of `Drop` renamed to `drop`.
10310       * std: The `drop` method now takes `&mut self` instead of `&self`.
10311       * std: The prelude no longer re-exports any modules, only types and traits.
10312       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10313         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10314       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10315         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10316       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10317         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10318       * std: Many types implement `Clone`.
10319       * std: `path` type renamed to `Path`.
10320       * std: `mut` module and `Mut` type removed.
10321       * std: Many standalone functions removed in favor of methods and iterators
10322         in `vec`, `str`. In the future methods will also work as functions.
10323       * std: `reinterpret_cast` removed. Use `transmute`.
10324       * std: ascii string handling in `std::ascii`.
10325       * std: `Rand` is implemented for ~/@.
10326       * std: `run` module for spawning processes overhauled.
10327       * std: Various atomic types added to `unstable::atomic`.
10328       * std: Various types implement `Zero`.
10329       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10330       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10331       * std: Added `os::mkdir_recursive`.
10332       * std: Added `os::glob` function performs filesystems globs.
10333       * std: `FuzzyEq` renamed to `ApproxEq`.
10334       * std: `Map` now defines `pop` and `swap` methods.
10335       * std: `Cell` constructors converted to static methods.
10336       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10337       * extra: `flate` module moved from `std` to `extra`.
10338       * extra: `fileinput` module for iterating over a series of files.
10339       * extra: `Complex` number type and `complex` module.
10340       * extra: `Rational` number type and `rational` module.
10341       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10342       * extra: `term` uses terminfo now, is more correct.
10343       * extra: `arc` functions converted to methods.
10344       * extra: Implementation of fixed output size variations of SHA-2.
10345
10346    * Tooling
10347       * `unused_variables` lint mode for unused variables (default: warn).
10348       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10349         (default: warn).
10350       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10351         (default: warn).
10352       * `dead_assignment` lint mode for unread variables (default: warn).
10353       * `unnecessary_allocation` lint mode detects some heap allocations that are
10354         immediately borrowed so could be written without allocating (default: warn).
10355       * `missing_doc` lint mode (default: allow).
10356       * `unreachable_code` lint mode (default: warn).
10357       * The `rusti` command has been rewritten and a number of bugs addressed.
10358       * rustc outputs in color on more terminals.
10359       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10360       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10361       * Compiling with `-g` will make the binary record information about
10362         dynamic borrowcheck failures for debugging.
10363       * rustdoc has a nicer stylesheet.
10364       * Various improvements to rustdoc.
10365       * Improvements to rustpkg (see the detailed release notes).
10366
10367
10368 Version 0.6 (2013-04-03)
10369 ========================
10370
10371    * ~2100 changes, numerous bugfixes
10372
10373    * Syntax changes
10374       * The self type parameter in traits is now spelled `Self`
10375       * The `self` parameter in trait and impl methods must now be explicitly
10376         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10377       * Static methods no longer require the `static` keyword and instead
10378         are distinguished by the lack of a `self` parameter
10379       * Replaced the `Durable` trait with the `'static` lifetime
10380       * The old closure type syntax with the trailing sigil has been
10381         removed in favor of the more consistent leading sigil
10382       * `super` is a keyword, and may be prefixed to paths
10383       * Trait bounds are separated with `+` instead of whitespace
10384       * Traits are implemented with `impl Trait for Type`
10385         instead of `impl Type: Trait`
10386       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10387       * The `export` keyword has finally been removed
10388       * The `move` keyword has been removed (see "Semantic changes")
10389       * The interior mutability qualifier on vectors, `[mut T]`, has been
10390         removed. Use `&mut [T]`, etc.
10391       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10392       * `fail` is no longer a keyword. Use `fail!()`
10393       * `assert` is no longer a keyword. Use `assert!()`
10394       * `log` is no longer a keyword. use `debug!`, etc.
10395       * 1-tuples may be represented as `(T,)`
10396       * Struct fields may no longer be `mut`. Use inherited mutability,
10397         `@mut T`, `core::mut` or `core::cell`
10398       * `extern mod { ... }` is no longer valid syntax for foreign
10399         function modules. Use extern blocks: `extern { ... }`
10400       * Newtype enums removed. Use tuple-structs.
10401       * Trait implementations no longer support visibility modifiers
10402       * Pattern matching over vectors improved and expanded
10403       * `const` renamed to `static` to correspond to lifetime name,
10404         and make room for future `static mut` unsafe mutable globals.
10405       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10406       * `Clone` implementations can be automatically generated with
10407         `#[deriving(Clone)]`
10408       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10409         instead of `foo as Bar`.
10410       * Fixed length vector types are now written as `[int, .. 3]`
10411         instead of `[int * 3]`.
10412       * Fixed length vector types can express the length as a constant
10413         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10414
10415    * Semantic changes
10416       * Types with owned pointers or custom destructors move by default,
10417         eliminating the `move` keyword
10418       * All foreign functions are considered unsafe
10419       * &mut is now unaliasable
10420       * Writes to borrowed @mut pointers are prevented dynamically
10421       * () has size 0
10422       * The name of the main function can be customized using #[main]
10423       * The default type of an inferred closure is &fn instead of @fn
10424       * `use` statements may no longer be "chained" - they cannot import
10425         identifiers imported by previous `use` statements
10426       * `use` statements are crate relative, importing from the "top"
10427         of the crate by default. Paths may be prefixed with `super::`
10428         or `self::` to change the search behavior.
10429       * Method visibility is inherited from the implementation declaration
10430       * Structural records have been removed
10431       * Many more types can be used in static items, including enums
10432         'static-lifetime pointers and vectors
10433       * Pattern matching over vectors improved and expanded
10434       * Typechecking of closure types has been overhauled to
10435         improve inference and eliminate unsoundness
10436       * Macros leave scope at the end of modules, unless that module is
10437         tagged with #[macro_escape]
10438
10439    * Libraries
10440       * Added big integers to `std::bigint`
10441       * Removed `core::oldcomm` module
10442       * Added pipe-based `core::comm` module
10443       * Numeric traits have been reorganized under `core::num`
10444       * `vec::slice` finally returns a slice
10445       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10446       * Containers reorganized around traits in `core::container`
10447       * `core::dvec` removed, `~[T]` is a drop-in replacement
10448       * `core::send_map` renamed to `core::hashmap`
10449       * `std::map` removed; replaced with `core::hashmap`
10450       * `std::treemap` reimplemented as an owned balanced tree
10451       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10452       * `core::trie` added as a fast ordered map for integer keys
10453       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10454       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10455         overload the comparison operators, whereas `TotalOrd` is used
10456         by certain container types
10457
10458    * Other
10459       * Replaced the 'cargo' package manager with 'rustpkg'
10460       * Added all-purpose 'rust' tool
10461       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10462       * rustc now *attempts* to offer spelling suggestions
10463       * Improved support for ARM and Android
10464       * Preliminary MIPS backend
10465       * Improved foreign function ABI implementation for x86, x86_64
10466       * Various memory usage improvements
10467       * Rust code may be embedded in foreign code under limited circumstances
10468       * Inline assembler supported by new asm!() syntax extension.
10469
10470
10471 Version 0.5 (2012-12-21)
10472 ===========================
10473
10474    * ~900 changes, numerous bugfixes
10475
10476    * Syntax changes
10477       * Removed `<-` move operator
10478       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10479       * Removed old fixed length vector syntax - `[T]/N`
10480       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10481       * Macros may now expand to items and statements
10482       * `a.b()` is always parsed as a method call, never as a field projection
10483       * `Eq` and `IterBytes` implementations can be automatically generated
10484         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10485       * Removed the special crate language for `.rc` files
10486       * Function arguments may consist of any irrefutable pattern
10487
10488    * Semantic changes
10489       * `&` and `~` pointers may point to objects
10490       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10491       * Enum variants may be structs
10492       * Destructors can be added to all nominal types with the Drop trait
10493       * Structs and nullary enum variants may be constants
10494       * Values that cannot be implicitly copied are now automatically moved
10495         without writing `move` explicitly
10496       * `&T` may now be coerced to `*T`
10497       * Coercions happen in `let` statements as well as function calls
10498       * `use` statements now take crate-relative paths
10499       * The module and type namespaces have been merged so that static
10500         method names can be resolved under the trait in which they are
10501         declared
10502
10503    * Improved support for language features
10504       * Trait inheritance works in many scenarios
10505       * More support for explicit self arguments in methods - `self`, `&self`
10506         `@self`, and `~self` all generally work as expected
10507       * Static methods work in more situations
10508       * Experimental: Traits may declare default methods for the implementations
10509         to use
10510
10511    * Libraries
10512       * New condition handling system in `core::condition`
10513       * Timsort added to `std::sort`
10514       * New priority queue, `std::priority_queue`
10515       * Pipes for serializable types, `std::flatpipes'
10516       * Serialization overhauled to be trait-based
10517       * Expanded `getopts` definitions
10518       * Moved futures to `std`
10519       * More functions are pure now
10520       * `core::comm` renamed to `oldcomm`. Still deprecated
10521       * `rustdoc` and `cargo` are libraries now
10522
10523    * Misc
10524       * Added a preliminary REPL, `rusti`
10525       * License changed from MIT to dual MIT/APL2
10526
10527
10528 Version 0.4 (2012-10-15)
10529 ==========================
10530
10531    * ~2000 changes, numerous bugfixes
10532
10533    * Syntax
10534       * All keywords are now strict and may not be used as identifiers anywhere
10535       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10536         'of', 'with', 'to', 'class'.
10537       * Classes are replaced with simpler structs
10538       * Explicit method self types
10539       * `ret` became `return` and `alt` became `match`
10540       * `import` is now `use`; `use is now `extern mod`
10541       * `extern mod { ... }` is now `extern { ... }`
10542       * `use mod` is the recommended way to import modules
10543       * `pub` and `priv` replace deprecated export lists
10544       * The syntax of `match` pattern arms now uses fat arrow (=>)
10545       * `main` no longer accepts an args vector; use `os::args` instead
10546
10547    * Semantics
10548       * Trait implementations are now coherent, ala Haskell typeclasses
10549       * Trait methods may be static
10550       * Argument modes are deprecated
10551       * Borrowed pointers are much more mature and recommended for use
10552       * Strings and vectors in the static region are stored in constant memory
10553       * Typestate was removed
10554       * Resolution rewritten to be more reliable
10555       * Support for 'dual-mode' data structures (freezing and thawing)
10556
10557    * Libraries
10558       * Most binary operators can now be overloaded via the traits in
10559         `core::ops'
10560       * `std::net::url` for representing URLs
10561       * Sendable hash maps in `core::send_map`
10562       * `core::task' gained a (currently unsafe) task-local storage API
10563
10564    * Concurrency
10565       * An efficient new intertask communication primitive called the pipe,
10566         along with a number of higher-level channel types, in `core::pipes`
10567       * `std::arc`, an atomically reference counted, immutable, shared memory
10568         type
10569       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10570       * Futures are now based on pipes and sendable
10571       * More robust linked task failure
10572       * Improved task builder API
10573
10574    * Other
10575       * Improved error reporting
10576       * Preliminary JIT support
10577       * Preliminary work on precise GC
10578       * Extensive architectural improvements to rustc
10579       * Begun a transition away from buggy C++-based reflection (shape) code to
10580         Rust-based (visitor) code
10581       * All hash functions and tables converted to secure, randomized SipHash
10582
10583
10584 Version 0.3  (2012-07-12)
10585 ========================
10586
10587    * ~1900 changes, numerous bugfixes
10588
10589    * New coding conveniences
10590       * Integer-literal suffix inference
10591       * Per-item control over warnings, errors
10592       * #[cfg(windows)] and #[cfg(unix)] attributes
10593       * Documentation comments
10594       * More compact closure syntax
10595       * 'do' expressions for treating higher-order functions as
10596         control structures
10597       * *-patterns (wildcard extended to all constructor fields)
10598
10599    * Semantic cleanup
10600       * Name resolution pass and exhaustiveness checker rewritten
10601       * Region pointers and borrow checking supersede alias
10602         analysis
10603       * Init-ness checking is now provided by a region-based liveness
10604         pass instead of the typestate pass; same for last-use analysis
10605       * Extensive work on region pointers
10606
10607    * Experimental new language features
10608       * Slices and fixed-size, interior-allocated vectors
10609       * #!-comments for lang versioning, shell execution
10610       * Destructors and iface implementation for classes;
10611         type-parameterized classes and class methods
10612       * 'const' type kind for types that can be used to implement
10613         shared-memory concurrency patterns
10614
10615    * Type reflection
10616
10617    * Removal of various obsolete features
10618       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10619                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10620
10621       * Constructs: do-while loops ('do' repurposed), fn binding,
10622                     resources (replaced by destructors)
10623
10624    * Compiler reorganization
10625       * Syntax-layer of compiler split into separate crate
10626       * Clang (from LLVM project) integrated into build
10627       * Typechecker split into sub-modules
10628
10629    * New library code
10630       * New time functions
10631       * Extension methods for many built-in types
10632       * Arc: atomic-refcount read-only / exclusive-use shared cells
10633       * Par: parallel map and search routines
10634       * Extensive work on libuv interface
10635       * Much vector code moved to libraries
10636       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10637         #include, #include_str, #include_bin
10638
10639    * Tool improvements
10640       * Cargo automatically resolves dependencies
10641
10642
10643 Version 0.2  (2012-03-29)
10644 =========================
10645
10646    * >1500 changes, numerous bugfixes
10647
10648    * New docs and doc tooling
10649
10650    * New port: FreeBSD x86_64
10651
10652    * Compilation model enhancements
10653       * Generics now specialized, multiply instantiated
10654       * Functions now inlined across separate crates
10655
10656    * Scheduling, stack and threading fixes
10657       * Noticeably improved message-passing performance
10658       * Explicit schedulers
10659       * Callbacks from C
10660       * Helgrind clean
10661
10662    * Experimental new language features
10663       * Operator overloading
10664       * Region pointers
10665       * Classes
10666
10667    * Various language extensions
10668       * C-callback function types: 'crust fn ...'
10669       * Infinite-loop construct: 'loop { ... }'
10670       * Shorten 'mutable' to 'mut'
10671       * Required mutable-local qualifier: 'let mut ...'
10672       * Basic glob-exporting: 'export foo::*;'
10673       * Alt now exhaustive, 'alt check' for runtime-checked
10674       * Block-function form of 'for' loop, with 'break' and 'ret'.
10675
10676    * New library code
10677       * AST quasi-quote syntax extension
10678       * Revived libuv interface
10679       * New modules: core::{future, iter}, std::arena
10680       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10681       * Extensive cleanup, regularization in libstd, libcore
10682
10683
10684 Version 0.1  (2012-01-20)
10685 ===============================
10686
10687    * Most language features work, including:
10688       * Unique pointers, unique closures, move semantics
10689       * Interface-constrained generics
10690       * Static interface dispatch
10691       * Stack growth
10692       * Multithread task scheduling
10693       * Typestate predicates
10694       * Failure unwinding, destructors
10695       * Pattern matching and destructuring assignment
10696       * Lightweight block-lambda syntax
10697       * Preliminary macro-by-example
10698
10699    * Compiler works with the following configurations:
10700       * Linux: x86 and x86_64 hosts and targets
10701       * macOS: x86 and x86_64 hosts and targets
10702       * Windows: x86 hosts and targets
10703
10704    * Cross compilation / multi-target configuration supported.
10705
10706    * Preliminary API-documentation and package-management tools included.
10707
10708 Known issues:
10709
10710    * Documentation is incomplete.
10711
10712    * Performance is below intended target.
10713
10714    * Standard library APIs are subject to extensive change, reorganization.
10715
10716    * Language-level versioning is not yet operational - future code will
10717      break unexpectedly.