]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Auto merge of #94350 - matthiaskrgr:rollup-eesfiyr, r=matthiaskrgr
[rust.git] / RELEASES.md
1 Version 1.59.0 (2022-02-24)
2 ==========================
3
4 Language
5 --------
6
7 - [Stabilize default arguments for const parameters and remove the ordering restriction for type and const parameters][90207]
8 - [Stabilize destructuring assignment][90521]
9 - [Relax private in public lint on generic bounds and where clauses of trait impls][90586]
10 - [Stabilize asm! and global_asm! for x86, x86_64, ARM, Aarch64, and RISC-V][91728]
11
12 Compiler
13 --------
14
15 - [Stabilize new symbol mangling format, leaving it opt-in (-Csymbol-mangling-version=v0)][90128]
16 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
17 - [Fix sparc64 ABI for aggregates with floating point members][91003]
18 - [Warn when a `#[test]`-like built-in attribute macro is present multiple times.][91172]
19 - [Add support for riscv64gc-unknown-freebsd][91284]
20 - [Stabilize `-Z emit-future-incompat` as `--json future-incompat`][91535]
21 - [Soft disable incremental compilation][94124]
22
23 This release disables incremental compilation, unless the user has explicitly
24 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
25 This is due to a known and relatively frequently occurring bug in incremental
26 compilation, which causes builds to issue internal compiler errors. This
27 particular bug is already fixed on nightly, but that fix has not yet rolled out
28 to stable and is deemed too risky for a direct stable backport.
29
30 As always, we encourage users to test with nightly and report bugs so that we
31 can track failures and fix issues earlier.
32
33 See [94124] for more details.
34
35 [94124]: https://github.com/rust-lang/rust/issues/94124
36
37 Libraries
38 ---------
39
40 - [Remove unnecessary bounds for some Hash{Map,Set} methods][91593]
41
42 Stabilized APIs
43 ---------------
44
45 - [`std::thread::available_parallelism`][available_parallelism]
46 - [`Result::copied`][result-copied]
47 - [`Result::cloned`][result-cloned]
48 - [`arch::asm!`][asm]
49 - [`arch::global_asm!`][global_asm]
50 - [`ops::ControlFlow::is_break`][is_break]
51 - [`ops::ControlFlow::is_continue`][is_continue]
52 - [`TryFrom<char> for u8`][try_from_char_u8]
53 - [`char::TryFromCharError`][try_from_char_err]
54   implementing `Clone`, `Debug`, `Display`, `PartialEq`, `Copy`, `Eq`, `Error`
55 - [`iter::zip`][zip]
56 - [`NonZeroU8::is_power_of_two`][is_power_of_two8]
57 - [`NonZeroU16::is_power_of_two`][is_power_of_two16]
58 - [`NonZeroU32::is_power_of_two`][is_power_of_two32]
59 - [`NonZeroU64::is_power_of_two`][is_power_of_two64]
60 - [`NonZeroU128::is_power_of_two`][is_power_of_two128]
61 - [`DoubleEndedIterator for ToLowercase`][lowercase]
62 - [`DoubleEndedIterator for ToUppercase`][uppercase]
63 - [`TryFrom<&mut [T]> for [T; N]`][tryfrom_ref_arr]
64 - [`UnwindSafe for Once`][unwindsafe_once]
65 - [`RefUnwindSafe for Once`][refunwindsafe_once]
66 - [armv8 neon intrinsics for aarch64][stdarch/1266]
67
68 Const-stable:
69
70 - [`mem::MaybeUninit::as_ptr`][muninit_ptr]
71 - [`mem::MaybeUninit::assume_init`][muninit_init]
72 - [`mem::MaybeUninit::assume_init_ref`][muninit_init_ref]
73 - [`ffi::CStr::from_bytes_with_nul_unchecked`][cstr_from_bytes]
74
75 Cargo
76 -----
77
78 - [Stabilize the `strip` profile option][cargo/10088]
79 - [Stabilize future-incompat-report][cargo/10165]
80 - [Support abbreviating `--release` as `-r`][cargo/10133]
81 - [Support `term.quiet` configuration][cargo/10152]
82 - [Remove `--host` from cargo {publish,search,login}][cargo/10145]
83
84 Compatibility Notes
85 -------------------
86
87 - [Refactor weak symbols in std::sys::unix][90846]
88   This may add new, versioned, symbols when building with a newer glibc, as the
89   standard library uses weak linkage rather than dynamically attempting to load
90   certain symbols at runtime.
91 - [Deprecate crate_type and crate_name nested inside `#![cfg_attr]`][83744]
92   This adds a future compatibility lint to supporting the use of cfg_attr
93   wrapping either crate_type or crate_name specification within Rust files;
94   it is recommended that users migrate to setting the equivalent command line
95   flags.
96 - [Remove effect of `#[no_link]` attribute on name resolution][92034]
97   This may expose new names, leading to conflicts with preexisting names in a
98   given namespace and a compilation failure.
99 - [Cargo will document libraries before binaries.][cargo/10172]
100 - [Respect doc=false in dependencies, not just the root crate][cargo/10201]
101 - [Weaken guarantee around advancing underlying iterators in zip][83791]
102 - [Make split_inclusive() on an empty slice yield an empty output][89825]
103 - [Update std::env::temp_dir to use GetTempPath2 on Windows when available.][89999]
104 - [unreachable! was updated to match other formatting macro behavior on Rust 2021][92137]
105
106 Internal Changes
107 ----------------
108
109 These changes provide no direct user facing benefits, but represent significant
110 improvements to the internals and overall performance of rustc
111 and related tools.
112
113 - [Fix many cases of normalization-related ICEs][91255]
114 - [Replace dominators algorithm with simple Lengauer-Tarjan][85013]
115 - [Store liveness in interval sets for region inference][90637]
116
117 - [Remove `in_band_lifetimes` from the compiler and standard library, in preparation for removing this
118   unstable feature.][91867]
119
120 [91867]: https://github.com/rust-lang/rust/issues/91867
121 [83744]: https://github.com/rust-lang/rust/pull/83744/
122 [83791]: https://github.com/rust-lang/rust/pull/83791/
123 [85013]: https://github.com/rust-lang/rust/pull/85013/
124 [89825]: https://github.com/rust-lang/rust/pull/89825/
125 [89999]: https://github.com/rust-lang/rust/pull/89999/
126 [90128]: https://github.com/rust-lang/rust/pull/90128/
127 [90207]: https://github.com/rust-lang/rust/pull/90207/
128 [90521]: https://github.com/rust-lang/rust/pull/90521/
129 [90586]: https://github.com/rust-lang/rust/pull/90586/
130 [90637]: https://github.com/rust-lang/rust/pull/90637/
131 [90833]: https://github.com/rust-lang/rust/pull/90833/
132 [90846]: https://github.com/rust-lang/rust/pull/90846/
133 [91003]: https://github.com/rust-lang/rust/pull/91003/
134 [91172]: https://github.com/rust-lang/rust/pull/91172/
135 [91255]: https://github.com/rust-lang/rust/pull/91255/
136 [91284]: https://github.com/rust-lang/rust/pull/91284/
137 [91535]: https://github.com/rust-lang/rust/pull/91535/
138 [91593]: https://github.com/rust-lang/rust/pull/91593/
139 [91728]: https://github.com/rust-lang/rust/pull/91728/
140 [91878]: https://github.com/rust-lang/rust/pull/91878/
141 [91896]: https://github.com/rust-lang/rust/pull/91896/
142 [91926]: https://github.com/rust-lang/rust/pull/91926/
143 [91984]: https://github.com/rust-lang/rust/pull/91984/
144 [92020]: https://github.com/rust-lang/rust/pull/92020/
145 [92034]: https://github.com/rust-lang/rust/pull/92034/
146 [92137]: https://github.com/rust-lang/rust/pull/92137/
147 [92483]: https://github.com/rust-lang/rust/pull/92483/
148 [cargo/10088]: https://github.com/rust-lang/cargo/pull/10088/
149 [cargo/10133]: https://github.com/rust-lang/cargo/pull/10133/
150 [cargo/10145]: https://github.com/rust-lang/cargo/pull/10145/
151 [cargo/10152]: https://github.com/rust-lang/cargo/pull/10152/
152 [cargo/10165]: https://github.com/rust-lang/cargo/pull/10165/
153 [cargo/10172]: https://github.com/rust-lang/cargo/pull/10172/
154 [cargo/10201]: https://github.com/rust-lang/cargo/pull/10201/
155 [cargo/10269]: https://github.com/rust-lang/cargo/pull/10269/
156
157 [cstr_from_bytes]: https://doc.rust-lang.org/stable/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked
158 [muninit_ptr]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.as_ptr
159 [muninit_init]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init
160 [muninit_init_ref]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
161 [unwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-UnwindSafe
162 [refunwindsafe_once]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#impl-RefUnwindSafe
163 [tryfrom_ref_arr]: https://doc.rust-lang.org/stable/std/convert/trait.TryFrom.html#impl-TryFrom%3C%26%27_%20mut%20%5BT%5D%3E
164 [lowercase]: https://doc.rust-lang.org/stable/std/char/struct.ToLowercase.html#impl-DoubleEndedIterator
165 [uppercase]: https://doc.rust-lang.org/stable/std/char/struct.ToUppercase.html#impl-DoubleEndedIterator
166 [try_from_char_err]: https://doc.rust-lang.org/stable/std/char/struct.TryFromCharError.html
167 [available_parallelism]: https://doc.rust-lang.org/stable/std/thread/fn.available_parallelism.html
168 [result-copied]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.copied
169 [result-cloned]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.cloned
170 [asm]: https://doc.rust-lang.org/stable/core/arch/macro.asm.html
171 [global_asm]: https://doc.rust-lang.org/stable/core/arch/macro.global_asm.html
172 [is_break]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_break
173 [is_continue]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html#method.is_continue
174 [try_from_char_u8]: https://doc.rust-lang.org/stable/std/primitive.char.html#impl-TryFrom%3Cchar%3E
175 [zip]: https://doc.rust-lang.org/stable/std/iter/fn.zip.html
176 [is_power_of_two8]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU8.html#method.is_power_of_two
177 [is_power_of_two16]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU16.html#method.is_power_of_two
178 [is_power_of_two32]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU32.html#method.is_power_of_two
179 [is_power_of_two64]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU64.html#method.is_power_of_two
180 [is_power_of_two128]: https://doc.rust-lang.org/stable/core/num/struct.NonZeroU128.html#method.is_power_of_two
181 [stdarch/1266]: https://github.com/rust-lang/stdarch/pull/1266
182
183 Version 1.58.1 (2022-01-19)
184 ===========================
185
186 * Fix race condition in `std::fs::remove_dir_all` ([CVE-2022-21658])
187 * [Handle captured arguments in the `useless_format` Clippy lint][clippy/8295]
188 * [Move `non_send_fields_in_send_ty` Clippy lint to nursery][clippy/8075]
189 * [Fix wrong error message displayed when some imports are missing][91254]
190 * [Fix rustfmt not formatting generated files from stdin][92912]
191
192 [CVE-2022-21658]: https://www.cve.org/CVERecord?id=CVE-2022-21658
193 [91254]: https://github.com/rust-lang/rust/pull/91254
194 [92912]: https://github.com/rust-lang/rust/pull/92912
195 [clippy/8075]: https://github.com/rust-lang/rust-clippy/pull/8075
196 [clippy/8295]: https://github.com/rust-lang/rust-clippy/pull/8295
197
198 Version 1.58.0 (2022-01-13)
199 ==========================
200
201 Language
202 --------
203
204 - [Format strings can now capture arguments simply by writing `{ident}` in the string.][90473] This works in all macros accepting format strings. Support for this in `panic!` (`panic!("{ident}")`) requires the 2021 edition; panic invocations in previous editions that appear to be trying to use this will result in a warning lint about not having the intended effect.
205 - [`*const T` pointers can now be dereferenced in const contexts.][89551]
206 - [The rules for when a generic struct implements `Unsize` have been relaxed.][90417]
207
208 Compiler
209 --------
210
211 - [Add LLVM CFI support to the Rust compiler][89652]
212 - [Stabilize -Z strip as -C strip][90058]. Note that while release builds already don't add debug symbols for the code you compile, the compiled standard library that ships with Rust includes debug symbols, so you may want to use the `strip` option to remove these symbols to produce smaller release binaries. Note that this release only includes support in rustc, not directly in cargo.
213 - [Add support for LLVM coverage mapping format versions 5 and 6][91207]
214 - [Emit LLVM optimization remarks when enabled with `-Cremark`][90833]
215 - [Update the minimum external LLVM to 12][90175]
216 - [Add `x86_64-unknown-none` at Tier 3*][89062]
217 - [Build musl dist artifacts with debuginfo enabled][90733]. When building release binaries using musl, you may want to use the newly stabilized strip option to remove these debug symbols, reducing the size of your binaries.
218 - [Don't abort compilation after giving a lint error][87337]
219 - [Error messages point at the source of trait bound obligations in more places][89580]
220
221 \* Refer to Rust's [platform support page][platform-support-doc] for more
222    information on Rust's tiered platform support.
223
224 Libraries
225 ---------
226
227 - [All remaining functions in the standard library have `#[must_use]` annotations where appropriate][89692], producing a warning when ignoring their return value. This helps catch mistakes such as expecting a function to mutate a value in place rather than return a new value.
228 - [Paths are automatically canonicalized on Windows for operations that support it][89174]
229 - [Re-enable debug checks for `copy` and `copy_nonoverlapping`][90041]
230 - [Implement `RefUnwindSafe` for `Rc<T>`][87467]
231 - [Make RSplit<T, P>: Clone not require T: Clone][90117]
232 - [Implement `Termination` for `Result<Infallible, E>`][88601]. This allows writing `fn main() -> Result<Infallible, ErrorType>`, for a program whose successful exits never involve returning from `main` (for instance, a program that calls `exit`, or that uses `exec` to run another program).
233
234 Stabilized APIs
235 ---------------
236
237 - [`Metadata::is_symlink`]
238 - [`Path::is_symlink`]
239 - [`{integer}::saturating_div`]
240 - [`Option::unwrap_unchecked`]
241 - [`Result::unwrap_unchecked`]
242 - [`Result::unwrap_err_unchecked`]
243 - [`File::options`]
244
245 These APIs are now usable in const contexts:
246
247 - [`Duration::new`]
248 - [`Duration::checked_add`]
249 - [`Duration::saturating_add`]
250 - [`Duration::checked_sub`]
251 - [`Duration::saturating_sub`]
252 - [`Duration::checked_mul`]
253 - [`Duration::saturating_mul`]
254 - [`Duration::checked_div`]
255
256 Cargo
257 -----
258
259 - [Add --message-format for install command][cargo/10107]
260 - [Warn when alias shadows external subcommand][cargo/10082]
261
262 Rustdoc
263 -------
264
265 - [Show all Deref implementations recursively in rustdoc][90183]
266 - [Use computed visibility in rustdoc][88447]
267
268 Compatibility Notes
269 -------------------
270
271 - [Try all stable method candidates first before trying unstable ones][90329]. This change ensures that adding new nightly-only methods to the Rust standard library will not break code invoking methods of the same name from traits outside the standard library.
272 - Windows: [`std::process::Command` will no longer search the current directory for executables.][87704]
273 - [All proc-macro backward-compatibility lints are now deny-by-default.][88041]
274 - [proc_macro: Append .0 to unsuffixed float if it would otherwise become int token][90297]
275 - [Refactor weak symbols in std::sys::unix][90846]. This optimizes accesses to glibc functions, by avoiding the use of dlopen. This does not increase the [minimum expected version of glibc](https://doc.rust-lang.org/nightly/rustc/platform-support.html). However, software distributions that use symbol versions to detect library dependencies, and which take weak symbols into account in that analysis, may detect rust binaries as requiring newer versions of glibc.
276 - [rustdoc now rejects some unexpected semicolons in doctests][91026]
277
278 Internal Changes
279 ----------------
280
281 These changes provide no direct user facing benefits, but represent significant
282 improvements to the internals and overall performance of rustc
283 and related tools.
284
285 - [Implement coherence checks for negative trait impls][90104]
286 - [Add rustc lint, warning when iterating over hashmaps][89558]
287 - [Optimize live point computation][90491]
288 - [Enable verification for 1/32nd of queries loaded from disk][90361]
289 - [Implement version of normalize_erasing_regions that allows for normalization failure][91255]
290
291 [87337]: https://github.com/rust-lang/rust/pull/87337/
292 [87467]: https://github.com/rust-lang/rust/pull/87467/
293 [87704]: https://github.com/rust-lang/rust/pull/87704/
294 [88041]: https://github.com/rust-lang/rust/pull/88041/
295 [88447]: https://github.com/rust-lang/rust/pull/88447/
296 [88601]: https://github.com/rust-lang/rust/pull/88601/
297 [89062]: https://github.com/rust-lang/rust/pull/89062/
298 [89174]: https://github.com/rust-lang/rust/pull/89174/
299 [89551]: https://github.com/rust-lang/rust/pull/89551/
300 [89558]: https://github.com/rust-lang/rust/pull/89558/
301 [89580]: https://github.com/rust-lang/rust/pull/89580/
302 [89652]: https://github.com/rust-lang/rust/pull/89652/
303 [90041]: https://github.com/rust-lang/rust/pull/90041/
304 [90058]: https://github.com/rust-lang/rust/pull/90058/
305 [90104]: https://github.com/rust-lang/rust/pull/90104/
306 [90117]: https://github.com/rust-lang/rust/pull/90117/
307 [90175]: https://github.com/rust-lang/rust/pull/90175/
308 [90183]: https://github.com/rust-lang/rust/pull/90183/
309 [90297]: https://github.com/rust-lang/rust/pull/90297/
310 [90329]: https://github.com/rust-lang/rust/pull/90329/
311 [90361]: https://github.com/rust-lang/rust/pull/90361/
312 [90417]: https://github.com/rust-lang/rust/pull/90417/
313 [90473]: https://github.com/rust-lang/rust/pull/90473/
314 [90491]: https://github.com/rust-lang/rust/pull/90491/
315 [90733]: https://github.com/rust-lang/rust/pull/90733/
316 [90833]: https://github.com/rust-lang/rust/pull/90833/
317 [90846]: https://github.com/rust-lang/rust/pull/90846/
318 [91026]: https://github.com/rust-lang/rust/pull/91026/
319 [91207]: https://github.com/rust-lang/rust/pull/91207/
320 [91255]: https://github.com/rust-lang/rust/pull/91255/
321 [cargo/10082]: https://github.com/rust-lang/cargo/pull/10082/
322 [cargo/10107]: https://github.com/rust-lang/cargo/pull/10107/
323 [`Metadata::is_symlink`]: https://doc.rust-lang.org/stable/std/fs/struct.Metadata.html#method.is_symlink
324 [`Path::is_symlink`]: https://doc.rust-lang.org/stable/std/path/struct.Path.html#method.is_symlink
325 [`{integer}::saturating_div`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.saturating_div
326 [`Option::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.unwrap_unchecked
327 [`Result::unwrap_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_unchecked
328 [`Result::unwrap_err_unchecked`]: https://doc.rust-lang.org/stable/std/result/enum.Result.html#method.unwrap_err_unchecked
329 [`File::options`]: https://doc.rust-lang.org/stable/std/fs/struct.File.html#method.options
330 [`Duration::new`]: https://doc.rust-lang.org/stable/std/time/struct.Duration.html#method.new
331
332 Version 1.57.0 (2021-12-02)
333 ==========================
334
335 Language
336 --------
337
338 - [Macro attributes may follow `#[derive]` and will see the original (pre-`cfg`) input.][87220]
339 - [Accept curly-brace macros in expressions, like `m!{ .. }.method()` and `m!{ .. }?`.][88690]
340 - [Allow panicking in constant evaluation.][89508]
341 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
342
343 Compiler
344 --------
345
346 - [Create more accurate debuginfo for vtables.][89597]
347 - [Add `armv6k-nintendo-3ds` at Tier 3\*.][88529]
348 - [Add `armv7-unknown-linux-uclibceabihf` at Tier 3\*.][88952]
349 - [Add `m68k-unknown-linux-gnu` at Tier 3\*.][88321]
350 - [Add SOLID targets at Tier 3\*:][86191] `aarch64-kmc-solid_asp3`, `armv7a-kmc-solid_asp3-eabi`, `armv7a-kmc-solid_asp3-eabihf`
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 - [Avoid allocations and copying in `Vec::leak`][89337]
359 - [Add `#[repr(i8)]` to `Ordering`][89507]
360 - [Optimize `File::read_to_end` and `read_to_string`][89582]
361 - [Update to Unicode 14.0][89614]
362 - [Many more functions are marked `#[must_use]`][89692], producing a warning
363   when ignoring their return value. This helps catch mistakes such as expecting
364   a function to mutate a value in place rather than return a new value.
365
366 Stabilised APIs
367 ---------------
368
369 - [`[T; N]::as_mut_slice`][`array::as_mut_slice`]
370 - [`[T; N]::as_slice`][`array::as_slice`]
371 - [`collections::TryReserveError`]
372 - [`HashMap::try_reserve`]
373 - [`HashSet::try_reserve`]
374 - [`String::try_reserve`]
375 - [`String::try_reserve_exact`]
376 - [`Vec::try_reserve`]
377 - [`Vec::try_reserve_exact`]
378 - [`VecDeque::try_reserve`]
379 - [`VecDeque::try_reserve_exact`]
380 - [`Iterator::map_while`]
381 - [`iter::MapWhile`]
382 - [`proc_macro::is_available`]
383 - [`Command::get_program`]
384 - [`Command::get_args`]
385 - [`Command::get_envs`]
386 - [`Command::get_current_dir`]
387 - [`CommandArgs`]
388 - [`CommandEnvs`]
389
390 These APIs are now usable in const contexts:
391
392 - [`hint::unreachable_unchecked`]
393
394 Cargo
395 -----
396
397 - [Stabilize custom profiles][cargo/9943]
398
399 Compatibility notes
400 -------------------
401
402 - [Ignore derived `Clone` and `Debug` implementations during dead code analysis.][85200]
403   This will break some builds that set `#![deny(dead_code)]`.
404
405 Internal changes
406 ----------------
407 These changes provide no direct user facing benefits, but represent significant
408 improvements to the internals and overall performance of rustc
409 and related tools.
410
411 - [Added an experimental backend for codegen with `libgccjit`.][87260]
412
413 [85200]: https://github.com/rust-lang/rust/pull/85200/
414 [86191]: https://github.com/rust-lang/rust/pull/86191/
415 [87220]: https://github.com/rust-lang/rust/pull/87220/
416 [87260]: https://github.com/rust-lang/rust/pull/87260/
417 [88321]: https://github.com/rust-lang/rust/pull/88321/
418 [88529]: https://github.com/rust-lang/rust/pull/88529/
419 [88690]: https://github.com/rust-lang/rust/pull/88690/
420 [88952]: https://github.com/rust-lang/rust/pull/88952/
421 [89337]: https://github.com/rust-lang/rust/pull/89337/
422 [89507]: https://github.com/rust-lang/rust/pull/89507/
423 [89508]: https://github.com/rust-lang/rust/pull/89508/
424 [89582]: https://github.com/rust-lang/rust/pull/89582/
425 [89597]: https://github.com/rust-lang/rust/pull/89597/
426 [89614]: https://github.com/rust-lang/rust/pull/89614/
427 [89692]: https://github.com/rust-lang/rust/issues/89692/
428 [cargo/9943]: https://github.com/rust-lang/cargo/pull/9943/
429 [`array::as_mut_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_mut_slice
430 [`array::as_slice`]: https://doc.rust-lang.org/std/primitive.array.html#method.as_slice
431 [`collections::TryReserveError`]: https://doc.rust-lang.org/std/collections/struct.TryReserveError.html
432 [`HashMap::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_map/struct.HashMap.html#method.try_reserve
433 [`HashSet::try_reserve`]: https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.try_reserve
434 [`String::try_reserve`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve
435 [`String::try_reserve_exact`]: https://doc.rust-lang.org/alloc/string/struct.String.html#method.try_reserve_exact
436 [`Vec::try_reserve`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve
437 [`Vec::try_reserve_exact`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.try_reserve_exact
438 [`VecDeque::try_reserve`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve
439 [`VecDeque::try_reserve_exact`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.try_reserve_exact
440 [`Iterator::map_while`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.map_while
441 [`iter::MapWhile`]: https://doc.rust-lang.org/std/iter/struct.MapWhile.html
442 [`proc_macro::is_available`]: https://doc.rust-lang.org/proc_macro/fn.is_available.html
443 [`Command::get_program`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_program
444 [`Command::get_args`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_args
445 [`Command::get_envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_envs
446 [`Command::get_current_dir`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.get_current_dir
447 [`CommandArgs`]: https://doc.rust-lang.org/std/process/struct.CommandArgs.html
448 [`CommandEnvs`]: https://doc.rust-lang.org/std/process/struct.CommandEnvs.html
449
450 Version 1.56.1 (2021-11-01)
451 ===========================
452
453 - New lints to detect the presence of bidirectional-override Unicode
454   codepoints in the compiled source code ([CVE-2021-42574])
455
456 [CVE-2021-42574]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574
457
458 Version 1.56.0 (2021-10-21)
459 ========================
460
461 Language
462 --------
463
464 - [The 2021 Edition is now stable.][rust#88100]
465   See [the edition guide][rust-2021-edition-guide] for more details.
466 - [The pattern in `binding @ pattern` can now also introduce new bindings.][rust#85305]
467 - [Union field access is permitted in `const fn`.][rust#85769]
468
469 [rust-2021-edition-guide]: https://doc.rust-lang.org/nightly/edition-guide/rust-2021/index.html
470
471 Compiler
472 --------
473
474 - [Upgrade to LLVM 13.][rust#87570]
475 - [Support memory, address, and thread sanitizers on aarch64-unknown-freebsd.][rust#88023]
476 - [Allow specifying a deployment target version for all iOS targets][rust#87699]
477 - [Warnings can be forced on with `--force-warn`.][rust#87472]
478   This feature is primarily intended for usage by `cargo fix`, rather than end users.
479 - [Promote `aarch64-apple-ios-sim` to Tier 2\*.][rust#87760]
480 - [Add `powerpc-unknown-freebsd` at Tier 3\*.][rust#87370]
481 - [Add `riscv32imc-esp-espidf` at Tier 3\*.][rust#87666]
482
483 \* Refer to Rust's [platform support page][platform-support-doc] for more
484 information on Rust's tiered platform support.
485
486 Libraries
487 ---------
488
489 - [Allow writing of incomplete UTF-8 sequences via stdout/stderr on Windows.][rust#83342]
490   The Windows console still requires valid Unicode, but this change allows
491   splitting a UTF-8 character across multiple write calls. This allows, for
492   instance, programs that just read and write data buffers (e.g. copying a file
493   to stdout) without regard for Unicode or character boundaries.
494 - [Prefer `AtomicU{64,128}` over Mutex for Instant backsliding protection.][rust#83093]
495   For this use case, atomics scale much better under contention.
496 - [Implement `Extend<(A, B)>` for `(Extend<A>, Extend<B>)`][rust#85835]
497 - [impl Default, Copy, Clone for std::io::Sink and std::io::Empty][rust#86744]
498 - [`impl From<[(K, V); N]>` for all collections.][rust#84111]
499 - [Remove `P: Unpin` bound on impl Future for Pin.][rust#81363]
500 - [Treat invalid environment variable names as non-existent.][rust#86183]
501   Previously, the environment functions would panic if given a variable name
502   with an internal null character or equal sign (`=`). Now, these functions will
503   just treat such names as non-existent variables, since the OS cannot represent
504   the existence of a variable with such a name.
505
506 Stabilised APIs
507 ---------------
508
509 - [`std::os::unix::fs::chroot`]
510 - [`UnsafeCell::raw_get`]
511 - [`BufWriter::into_parts`]
512 - [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]
513   These APIs were previously stable in `std`, but are now also available in `core`.
514 - [`Vec::shrink_to`]
515 - [`String::shrink_to`]
516 - [`OsString::shrink_to`]
517 - [`PathBuf::shrink_to`]
518 - [`BinaryHeap::shrink_to`]
519 - [`VecDeque::shrink_to`]
520 - [`HashMap::shrink_to`]
521 - [`HashSet::shrink_to`]
522
523 These APIs are now usable in const contexts:
524
525 - [`std::mem::transmute`]
526 - [`[T]::first`][`slice::first`]
527 - [`[T]::split_first`][`slice::split_first`]
528 - [`[T]::last`][`slice::last`]
529 - [`[T]::split_last`][`slice::split_last`]
530
531 Cargo
532 -----
533
534 - [Cargo supports specifying a minimum supported Rust version in Cargo.toml.][`rust-version`]
535   This has no effect at present on dependency version selection.
536   We encourage crates to specify their minimum supported Rust version, and we encourage CI systems
537   that support Rust code to include a crate's specified minimum version in the test matrix for that
538   crate by default.
539
540 Compatibility notes
541 -------------------
542
543 - [Update to new argument parsing rules on Windows.][rust#87580]
544   This adjusts Rust's standard library to match the behavior of the standard
545   libraries for C/C++. The rules have changed slightly over time, and this PR
546   brings us to the latest set of rules (changed in 2008).
547 - [Disallow the aapcs calling convention on aarch64][rust#88399]
548   This was already not supported by LLVM; this change surfaces this lack of
549   support with a better error message.
550 - [Make `SEMICOLON_IN_EXPRESSIONS_FROM_MACROS` warn by default][rust#87385]
551 - [Warn when an escaped newline skips multiple lines.][rust#87671]
552 - [Calls to `libc::getpid` / `std::process::id` from `Command::pre_exec`
553    may return different values on glibc <= 2.24.][rust#81825]
554    Rust now invokes the `clone3` system call directly, when available, to use new functionality
555    available via that system call. Older versions of glibc cache the result of `getpid`, and only
556    update that cache when calling glibc's clone/fork functions, so a direct system call bypasses
557    that cache update. glibc 2.25 and newer no longer cache `getpid` for exactly this reason.
558
559 Internal changes
560 ----------------
561 These changes provide no direct user facing benefits, but represent significant
562 improvements to the internals and overall performance of rustc
563 and related tools.
564
565 - [LLVM is compiled with PGO in published x86_64-unknown-linux-gnu artifacts.][rust#88069]
566   This improves the performance of most Rust builds.
567 - [Unify representation of macros in internal data structures.][rust#88019]
568   This change fixes a host of bugs with the handling of macros by the compiler,
569   as well as rustdoc.
570
571 [`std::os::unix::fs::chroot`]: https://doc.rust-lang.org/stable/std/os/unix/fs/fn.chroot.html
572 [`UnsafeCell::raw_get`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.raw_get
573 [`BufWriter::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.BufWriter.html#method.into_parts
574 [`core::panic::{UnwindSafe, RefUnwindSafe, AssertUnwindSafe}`]: https://github.com/rust-lang/rust/pull/84662
575 [`Vec::shrink_to`]: https://doc.rust-lang.org/stable/std/vec/struct.Vec.html#method.shrink_to
576 [`String::shrink_to`]: https://doc.rust-lang.org/stable/std/string/struct.String.html#method.shrink_to
577 [`OsString::shrink_to`]: https://doc.rust-lang.org/stable/std/ffi/struct.OsString.html#method.shrink_to
578 [`PathBuf::shrink_to`]: https://doc.rust-lang.org/stable/std/path/struct.PathBuf.html#method.shrink_to
579 [`BinaryHeap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.BinaryHeap.html#method.shrink_to
580 [`VecDeque::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/struct.VecDeque.html#method.shrink_to
581 [`HashMap::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_map/struct.HashMap.html#method.shrink_to
582 [`HashSet::shrink_to`]: https://doc.rust-lang.org/stable/std/collections/hash_set/struct.HashSet.html#method.shrink_to
583 [`std::mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
584 [`slice::first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.first
585 [`slice::split_first`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_first
586 [`slice::last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.last
587 [`slice::split_last`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.split_last
588 [`rust-version`]: https://doc.rust-lang.org/nightly/cargo/reference/manifest.html#the-rust-version-field
589 [rust#87671]: https://github.com/rust-lang/rust/pull/87671
590 [rust#86183]: https://github.com/rust-lang/rust/pull/86183
591 [rust#87385]: https://github.com/rust-lang/rust/pull/87385
592 [rust#88100]: https://github.com/rust-lang/rust/pull/88100
593 [rust#85305]: https://github.com/rust-lang/rust/pull/85305
594 [rust#88069]: https://github.com/rust-lang/rust/pull/88069
595 [rust#87472]: https://github.com/rust-lang/rust/pull/87472
596 [rust#87699]: https://github.com/rust-lang/rust/pull/87699
597 [rust#87570]: https://github.com/rust-lang/rust/pull/87570
598 [rust#88023]: https://github.com/rust-lang/rust/pull/88023
599 [rust#87760]: https://github.com/rust-lang/rust/pull/87760
600 [rust#87370]: https://github.com/rust-lang/rust/pull/87370
601 [rust#87580]: https://github.com/rust-lang/rust/pull/87580
602 [rust#83342]: https://github.com/rust-lang/rust/pull/83342
603 [rust#83093]: https://github.com/rust-lang/rust/pull/83093
604 [rust#85835]: https://github.com/rust-lang/rust/pull/85835
605 [rust#86744]: https://github.com/rust-lang/rust/pull/86744
606 [rust#81363]: https://github.com/rust-lang/rust/pull/81363
607 [rust#84111]: https://github.com/rust-lang/rust/pull/84111
608 [rust#85769]: https://github.com/rust-lang/rust/pull/85769#issuecomment-854363720
609 [rust#88399]: https://github.com/rust-lang/rust/pull/88399
610 [rust#81825]: https://github.com/rust-lang/rust/pull/81825#issuecomment-808406918
611 [rust#88019]: https://github.com/rust-lang/rust/pull/88019
612 [rust#87666]: https://github.com/rust-lang/rust/pull/87666
613
614 Version 1.55.0 (2021-09-09)
615 ============================
616
617 Language
618 --------
619 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
620   will end at the maximum value of the integer.][83918]
621 - [You can now explicitly import the prelude of different editions
622   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
623
624 Compiler
625 --------
626 - [Added tier 3\* support for `powerpc64le-unknown-freebsd`.][83572]
627
628 \* Refer to Rust's [platform support page][platform-support-doc] for more
629    information on Rust's tiered platform support.
630
631 Libraries
632 ---------
633
634 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
635   These improvements should in general provide faster string parsing of floats,
636   no longer reject certain valid floating point values, and reduce
637   the produced code size for non-stripped artifacts.
638 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
639
640 Stabilised APIs
641 ---------------
642
643 - [`Bound::cloned`]
644 - [`Drain::as_str`]
645 - [`IntoInnerError::into_error`]
646 - [`IntoInnerError::into_parts`]
647 - [`MaybeUninit::assume_init_mut`]
648 - [`MaybeUninit::assume_init_ref`]
649 - [`MaybeUninit::write`]
650 - [`array::map`]
651 - [`ops::ControlFlow`]
652 - [`x86::_bittest`]
653 - [`x86::_bittestandcomplement`]
654 - [`x86::_bittestandreset`]
655 - [`x86::_bittestandset`]
656 - [`x86_64::_bittest64`]
657 - [`x86_64::_bittestandcomplement64`]
658 - [`x86_64::_bittestandreset64`]
659 - [`x86_64::_bittestandset64`]
660
661 The following previously stable functions are now `const`.
662
663 - [`str::from_utf8_unchecked`]
664
665
666 Cargo
667 -----
668 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
669   rustc in parallel such as when using `cargo test`.][cargo/9675]
670 - [The package definition in `cargo metadata` now includes the `"default_run"`
671   field from the manifest.][cargo/9550]
672 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
673 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
674   of packages.][cargo/9663]
675
676 Rustdoc
677 -------
678 - [Added "Go to item on exact match" search option.][85876]
679 - [The "Implementors" section on traits no longer shows redundant
680   method definitions.][85970]
681 - [Trait implementations are toggled open by default.][86260] This should make the
682   implementations more searchable by tools like `CTRL+F` in your browser.
683 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
684   through type aliases.][86334]
685 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
686   "Trait Implementations" section.][86513]
687
688
689 Compatibility Notes
690 -------------------
691 - [std functions that return an `io::Error` will no longer use the
692   `ErrorKind::Other` variant.][85746] This is to better reflect that these
693   kinds of errors could be categorised [into newer more specific `ErrorKind`
694   variants][79965], and that they do not represent a user error.
695 - [Using environment variable names with `process::Command` on Windows now
696   behaves as expected.][85270] Previously using envionment variables with
697   `Command` would cause them to be ASCII-uppercased.
698 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
699   with `rustdoc::`][86849]
700 - `RUSTFLAGS` is no longer set for build scripts. Build scripts
701   should use `CARGO_ENCODED_RUSTFLAGS` instead. See the
702   [documentation](https://doc.rust-lang.org/nightly/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts)
703   for more details.
704
705 [86849]: https://github.com/rust-lang/rust/pull/86849
706 [86513]: https://github.com/rust-lang/rust/pull/86513
707 [86334]: https://github.com/rust-lang/rust/pull/86334
708 [86260]: https://github.com/rust-lang/rust/pull/86260
709 [85970]: https://github.com/rust-lang/rust/pull/85970
710 [85876]: https://github.com/rust-lang/rust/pull/85876
711 [83572]: https://github.com/rust-lang/rust/pull/83572
712 [86294]: https://github.com/rust-lang/rust/pull/86294
713 [86858]: https://github.com/rust-lang/rust/pull/86858
714 [86761]: https://github.com/rust-lang/rust/pull/86761
715 [85746]: https://github.com/rust-lang/rust/pull/85746
716 [85270]: https://github.com/rust-lang/rust/pull/85270
717 [83918]: https://github.com/rust-lang/rust/pull/83918
718 [79965]: https://github.com/rust-lang/rust/pull/79965
719 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
720 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
721 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
722 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
723 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
724 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
725 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
726 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
727 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
728 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
729 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
730 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
731 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
732 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
733 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
734 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
735 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
736 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
737 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
738 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
739 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
740 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
741
742
743 Version 1.54.0 (2021-07-29)
744 ============================
745
746 Language
747 -----------------------
748
749 - [You can now use macros for values in some built-in attributes.][83366]
750   This primarily allows you to call macros within the `#[doc]` attribute. For
751   example, to include external documentation in your crate, you can now write
752   the following:
753   ```rust
754   #![doc = include_str!("README.md")]
755   ```
756
757 - [You can now cast between unsized slice types (and types which contain
758   unsized slices) in `const fn`.][85078]
759 - [You can now use multiple generic lifetimes with `impl Trait` where the
760    lifetimes don't explicitly outlive another.][84701] In code this means
761    that you can now have `impl Trait<'a, 'b>` where as before you could
762    only have `impl Trait<'a, 'b> where 'b: 'a`.
763
764 Compiler
765 -----------------------
766
767 - [Rustc will now search for custom JSON targets in
768   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
769   directory.][83800] You can find your sysroot directory by running
770   `rustc --print sysroot`.
771 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
772 - [You can now use `#[target_feature]` on safe functions when targeting
773   WebAssembly platforms.][84988]
774 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
775 - [Added tier 3\* support for `bpfel-unknown-none`
776    and `bpfeb-unknown-none`.][79608]
777 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
778
779 \* Refer to Rust's [platform support page][platform-support-doc] for more
780    information on Rust's tiered platform support.
781
782 Libraries
783 -----------------------
784
785 - [`panic::panic_any` will now `#[track_caller]`.][85745]
786 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
787 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
788 - [The implementations of vendor intrinsics in core::arch have been
789    significantly refactored.][83278] The main user-visible changes are
790    a 50% reduction in the size of libcore.rlib and stricter validation
791    of constant operands passed to intrinsics. The latter is technically
792    a breaking change, but allows Rust to more closely match the C vendor
793    intrinsics API.
794
795 Stabilized APIs
796 ---------------
797
798 - [`BTreeMap::into_keys`]
799 - [`BTreeMap::into_values`]
800 - [`HashMap::into_keys`]
801 - [`HashMap::into_values`]
802 - [`arch::wasm32`]
803 - [`VecDeque::binary_search`]
804 - [`VecDeque::binary_search_by`]
805 - [`VecDeque::binary_search_by_key`]
806 - [`VecDeque::partition_point`]
807
808 Cargo
809 -----
810
811 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
812   the dependency graph.][cargo/9520]
813 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
814   in the tree ][cargo/9499]
815 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
816   macro dependencies.][cargo/9488]
817 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
818   This variable points to a directory that integration tests and benches
819   can use as a "scratchpad" for testing filesystem operations.
820
821 Compatibility Notes
822 -------------------
823 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
824 - [Previously unsound code is no longer permitted where different constructors in branches
825   could require different lifetimes.][85574]
826 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
827   than before and may reject some previously accepted code.
828 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
829    when compiled with `codegen-units = 1`.][86063]
830
831 [85574]: https://github.com/rust-lang/rust/issues/85574
832 [86831]: https://github.com/rust-lang/rust/issues/86831
833 [86063]: https://github.com/rust-lang/rust/issues/86063
834 [79608]: https://github.com/rust-lang/rust/pull/79608
835 [84988]: https://github.com/rust-lang/rust/pull/84988
836 [84701]: https://github.com/rust-lang/rust/pull/84701
837 [84072]: https://github.com/rust-lang/rust/pull/84072
838 [85745]: https://github.com/rust-lang/rust/pull/85745
839 [84744]: https://github.com/rust-lang/rust/pull/84744
840 [85078]: https://github.com/rust-lang/rust/pull/85078
841 [84717]: https://github.com/rust-lang/rust/pull/84717
842 [83800]: https://github.com/rust-lang/rust/pull/83800
843 [83366]: https://github.com/rust-lang/rust/pull/83366
844 [83278]: https://github.com/rust-lang/rust/pull/83278
845 [85292]: https://github.com/rust-lang/rust/pull/85292
846 [82834]: https://github.com/rust-lang/rust/pull/82834
847 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
848 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
849 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
850 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
851 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
852 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
853 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
854 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
855 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
856 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
857 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
858
859 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
860
861 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
862
863 Version 1.53.0 (2021-06-17)
864 ============================
865
866 Language
867 -----------------------
868 - [You can now use unicode for identifiers.][83799] This allows multilingual
869   identifiers but still doesn't allow glyphs that are not considered characters
870   such as `◆` or `🦀`. More specifically you can now use any identifier that
871   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
872   is the same standard as languages like Python, however Rust uses NFC
873   normalization which may be different from other languages.
874 - [You can now specify "or patterns" inside pattern matches.][79278]
875   Previously you could only use `|` (OR) on complete patterns. E.g.
876   ```rust
877   let x = Some(2u8);
878   // Before
879   matches!(x, Some(1) | Some(2));
880   // Now
881   matches!(x, Some(1 | 2));
882   ```
883 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
884   has the same semantics as the `:pat` matcher. This is to allow `:pat`
885   to change semantics to being a pattern fragment in a future edition.
886
887 Compiler
888 -----------------------
889 - [Updated the minimum external LLVM version to LLVM 10.][83387]
890 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
891 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
892
893 \* Refer to Rust's [platform support page][platform-support-doc] for more
894 information on Rust's tiered platform support.
895
896 Libraries
897 -----------------------
898 - [Abort messages will now forward to `android_set_abort_message` on
899   Android platforms when available.][81469]
900 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
901 - [Arrays of any length now implement `IntoIterator`.][84147]
902   Currently calling `.into_iter()` as a method on an array will
903   return `impl Iterator<Item=&T>`, but this may change in a
904   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
905   directly on arrays will provide `impl Iterator<Item=T>` as expected.
906 - [`leading_zeros`, and `trailing_zeros` are now available on all
907   `NonZero` integer types.][84082]
908 - [`{f32, f64}::from_str` now parse and print special values
909   (`NaN`, `-0`) according to IEEE 754.][78618]
910 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
911 - [Add the `BITS` associated constant to all numeric types.][82565]
912
913 Stabilised APIs
914 ---------------
915 - [`AtomicBool::fetch_update`]
916 - [`AtomicPtr::fetch_update`]
917 - [`BTreeMap::retain`]
918 - [`BTreeSet::retain`]
919 - [`BufReader::seek_relative`]
920 - [`DebugStruct::non_exhaustive`]
921 - [`Duration::MAX`]
922 - [`Duration::ZERO`]
923 - [`Duration::is_zero`]
924 - [`Duration::saturating_add`]
925 - [`Duration::saturating_mul`]
926 - [`Duration::saturating_sub`]
927 - [`ErrorKind::Unsupported`]
928 - [`Option::insert`]
929 - [`Ordering::is_eq`]
930 - [`Ordering::is_ge`]
931 - [`Ordering::is_gt`]
932 - [`Ordering::is_le`]
933 - [`Ordering::is_lt`]
934 - [`Ordering::is_ne`]
935 - [`OsStr::is_ascii`]
936 - [`OsStr::make_ascii_lowercase`]
937 - [`OsStr::make_ascii_uppercase`]
938 - [`OsStr::to_ascii_lowercase`]
939 - [`OsStr::to_ascii_uppercase`]
940 - [`Peekable::peek_mut`]
941 - [`Rc::decrement_strong_count`]
942 - [`Rc::increment_strong_count`]
943 - [`Vec::extend_from_within`]
944 - [`array::from_mut`]
945 - [`array::from_ref`]
946 - [`cmp::max_by_key`]
947 - [`cmp::max_by`]
948 - [`cmp::min_by_key`]
949 - [`cmp::min_by`]
950 - [`f32::is_subnormal`]
951 - [`f64::is_subnormal`]
952
953 Cargo
954 -----------------------
955 - [Cargo now supports git repositories where the default `HEAD` branch is not
956   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
957   which can handle default branches correctly.
958 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
959 - [The `authors` field is no longer included in `Cargo.toml` for new
960   projects.][cargo/9282]
961
962 Rustdoc
963 -----------------------
964 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
965   without hyperlinks.][81764]
966
967 Compatibility Notes
968 -------------------
969 - [Implement token-based handling of attributes during expansion][82608]
970 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
971   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
972   to confusion and potential security vulnerabilities and [is no
973   longer recommended][ietf6943].
974 - [The added `BITS` constant may conflict with external definitions.][85667]
975   In particular, this was known to be a problem in the `lexical-core` crate,
976   but they have published fixes for semantic versions 0.4 through 0.7. To
977   update this dependency alone, use `cargo update -p lexical-core`.
978 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
979
980 Internal Only
981 -------------
982 These changes provide no direct user facing benefits, but represent significant
983 improvements to the internals and overall performance of rustc and
984 related tools.
985
986 - [Rework the `std::sys::windows::alloc` implementation.][83065]
987 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
988 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
989 - [Rework rustdoc const type][82873]
990
991 [85667]: https://github.com/rust-lang/rust/pull/85667
992 [83386]: https://github.com/rust-lang/rust/pull/83386
993 [82771]: https://github.com/rust-lang/rust/pull/82771
994 [84147]: https://github.com/rust-lang/rust/pull/84147
995 [84082]: https://github.com/rust-lang/rust/pull/84082
996 [83799]: https://github.com/rust-lang/rust/pull/83799
997 [83681]: https://github.com/rust-lang/rust/pull/83681
998 [83652]: https://github.com/rust-lang/rust/pull/83652
999 [83387]: https://github.com/rust-lang/rust/pull/83387
1000 [82873]: https://github.com/rust-lang/rust/pull/82873
1001 [82864]: https://github.com/rust-lang/rust/pull/82864
1002 [82608]: https://github.com/rust-lang/rust/pull/82608
1003 [82565]: https://github.com/rust-lang/rust/pull/82565
1004 [80525]: https://github.com/rust-lang/rust/pull/80525
1005 [79278]: https://github.com/rust-lang/rust/pull/79278
1006 [78618]: https://github.com/rust-lang/rust/pull/78618
1007 [77704]: https://github.com/rust-lang/rust/pull/77704
1008 [83941]: https://github.com/rust-lang/rust/pull/83941
1009 [83065]: https://github.com/rust-lang/rust/pull/83065
1010 [81764]: https://github.com/rust-lang/rust/pull/81764
1011 [81469]: https://github.com/rust-lang/rust/pull/81469
1012 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
1013 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
1014 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
1015 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
1016 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
1017 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
1018 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
1019 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
1020 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
1021 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
1022 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
1023 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
1024 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
1025 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
1026 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
1027 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
1028 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
1029 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
1030 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
1031 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
1032 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
1033 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
1034 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
1035 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
1036 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
1037 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
1038 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
1039 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
1040 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
1041 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
1042 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
1043 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
1044 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
1045 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
1046 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
1047 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
1048 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
1049 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
1050 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
1051 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
1052 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
1053
1054
1055 Version 1.52.1 (2021-05-10)
1056 ============================
1057
1058 This release disables incremental compilation, unless the user has explicitly
1059 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
1060
1061 This is due to the widespread, and frequently occuring, breakage encountered by
1062 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
1063 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
1064 newly added incremental verification are still present in past stable versions,
1065 and are not yet fixed on any channel. These bugs can lead to miscompilation of
1066 Rust binaries.
1067
1068 These problems only affect incremental builds, so release builds with Cargo
1069 should not be affected unless the user has explicitly opted into incremental.
1070 Debug and check builds are affected.
1071
1072 See [84970] for more details.
1073
1074 [84970]: https://github.com/rust-lang/rust/issues/84970
1075
1076 Version 1.52.0 (2021-05-06)
1077 ============================
1078
1079 Language
1080 --------
1081 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
1082   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
1083   is allowed by default, and may become a warning or hard error in a
1084   future edition.
1085 - [You can now cast mutable references to arrays to a pointer of the same type as
1086   the element.][81479]
1087
1088 Compiler
1089 --------
1090 - [Upgraded the default LLVM to LLVM 12.][81451]
1091
1092 Added tier 3\* support for the following targets.
1093
1094 - [`s390x-unknown-linux-musl`][82166]
1095 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
1096 - [`powerpc-unknown-openbsd`][82733]
1097
1098 \* Refer to Rust's [platform support page][platform-support-doc] for more
1099 information on Rust's tiered platform support.
1100
1101 Libraries
1102 ---------
1103 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
1104 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
1105 - [`Arc<impl Error>` now implements `error::Error`.][80553]
1106 - [All integer division and remainder operations are now `const`.][80962]
1107
1108 Stabilised APIs
1109 -------------
1110 - [`Arguments::as_str`]
1111 - [`char::MAX`]
1112 - [`char::REPLACEMENT_CHARACTER`]
1113 - [`char::UNICODE_VERSION`]
1114 - [`char::decode_utf16`]
1115 - [`char::from_digit`]
1116 - [`char::from_u32_unchecked`]
1117 - [`char::from_u32`]
1118 - [`slice::partition_point`]
1119 - [`str::rsplit_once`]
1120 - [`str::split_once`]
1121
1122 The following previously stable APIs are now `const`.
1123
1124 - [`char::len_utf8`]
1125 - [`char::len_utf16`]
1126 - [`char::to_ascii_uppercase`]
1127 - [`char::to_ascii_lowercase`]
1128 - [`char::eq_ignore_ascii_case`]
1129 - [`u8::to_ascii_uppercase`]
1130 - [`u8::to_ascii_lowercase`]
1131 - [`u8::eq_ignore_ascii_case`]
1132
1133 Rustdoc
1134 -------
1135 - [Rustdoc lints are now treated as a tool lint, meaning that
1136   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
1137   Using the old style is still allowed, and will become a warning in
1138   a future release.
1139 - [Rustdoc now supports argument files.][82261]
1140 - [Rustdoc now generates smart punctuation for documentation.][79423]
1141 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
1142   ```markdown
1143   - [x] Complete
1144   - [ ] Todo
1145   ```
1146
1147 Misc
1148 ----
1149 - [You can now pass multiple filters to tests.][81356] E.g.
1150   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
1151 - [Rustup now distributes PDB symbols for the `std` library on Windows,
1152   allowing you to see `std` symbols when debugging.][82218]
1153
1154 Internal Only
1155 -------------
1156 These changes provide no direct user facing benefits, but represent significant
1157 improvements to the internals and overall performance of rustc and
1158 related tools.
1159
1160 - [Check the result cache before the DepGraph when ensuring queries][81855]
1161 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
1162 - [Only store a LocalDefId in some HIR nodes][81611]
1163 - [Store HIR attributes in a side table][79519]
1164
1165 Compatibility Notes
1166 -------------------
1167 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
1168 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
1169 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
1170 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
1171   languages in code blocks.][78429]
1172 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
1173 - [Changes in how proc macros handle whitespace may lead to panics when used
1174   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
1175 - [Turn `#[derive]` into a regular macro attribute][79078]
1176
1177 [84136]: https://github.com/rust-lang/rust/issues/84136
1178 [80763]: https://github.com/rust-lang/rust/pull/80763
1179 [82166]: https://github.com/rust-lang/rust/pull/82166
1180 [82121]: https://github.com/rust-lang/rust/pull/82121
1181 [81879]: https://github.com/rust-lang/rust/pull/81879
1182 [82261]: https://github.com/rust-lang/rust/pull/82261
1183 [82218]: https://github.com/rust-lang/rust/pull/82218
1184 [82216]: https://github.com/rust-lang/rust/pull/82216
1185 [82202]: https://github.com/rust-lang/rust/pull/82202
1186 [81855]: https://github.com/rust-lang/rust/pull/81855
1187 [81766]: https://github.com/rust-lang/rust/pull/81766
1188 [81744]: https://github.com/rust-lang/rust/pull/81744
1189 [81611]: https://github.com/rust-lang/rust/pull/81611
1190 [81479]: https://github.com/rust-lang/rust/pull/81479
1191 [81451]: https://github.com/rust-lang/rust/pull/81451
1192 [81356]: https://github.com/rust-lang/rust/pull/81356
1193 [80962]: https://github.com/rust-lang/rust/pull/80962
1194 [80553]: https://github.com/rust-lang/rust/pull/80553
1195 [80527]: https://github.com/rust-lang/rust/pull/80527
1196 [79519]: https://github.com/rust-lang/rust/pull/79519
1197 [79423]: https://github.com/rust-lang/rust/pull/79423
1198 [79208]: https://github.com/rust-lang/rust/pull/79208
1199 [78429]: https://github.com/rust-lang/rust/pull/78429
1200 [82733]: https://github.com/rust-lang/rust/pull/82733
1201 [82594]: https://github.com/rust-lang/rust/pull/82594
1202 [79078]: https://github.com/rust-lang/rust/pull/79078
1203 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
1204 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
1205 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
1206 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
1207 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
1208 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
1209 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
1210 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
1211 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
1212 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
1213 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
1214 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
1215 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
1216 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
1217 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
1218 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
1219 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
1220 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
1221 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
1222 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
1223 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
1224 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
1225
1226 Version 1.51.0 (2021-03-25)
1227 ============================
1228
1229 Language
1230 --------
1231 - [You can now parameterize items such as functions, traits, and `struct`s by constant
1232   values in addition to by types and lifetimes.][79135] Also known as "const generics"
1233   E.g. you can now write the following. Note: Only values of primitive integers,
1234   `bool`, or `char` types are currently permitted.
1235   ```rust
1236   struct GenericArray<T, const LENGTH: usize> {
1237       inner: [T; LENGTH]
1238   }
1239
1240   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
1241       const fn last(&self) -> Option<&T> {
1242           if LENGTH == 0 {
1243               None
1244           } else {
1245               Some(&self.inner[LENGTH - 1])
1246           }
1247       }
1248   }
1249   ```
1250
1251
1252 Compiler
1253 --------
1254
1255 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
1256   This option controls whether debug information is split across multiple files
1257   or packed into a single file. **Note** This option is unstable on other platforms.
1258 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
1259   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
1260 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
1261 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
1262
1263 \* Refer to Rust's [platform support page][platform-support-doc] for more
1264 information on Rust's tiered platform support.
1265
1266 Libraries
1267 ---------
1268
1269 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
1270 - [`str` now implements `AsMut<str>`.][80279]
1271 - [`u64` and `u128` now implement `From<char>`.][79502]
1272 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
1273 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
1274 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
1275 - [`io::Empty` now implements `io::Seek`.][78044]
1276 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
1277   `T: ?Sized` types.][80764]
1278 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
1279
1280
1281 Stabilized APIs
1282 ---------------
1283
1284 - [`Arc::decrement_strong_count`]
1285 - [`Arc::increment_strong_count`]
1286 - [`Once::call_once_force`]
1287 - [`Peekable::next_if_eq`]
1288 - [`Peekable::next_if`]
1289 - [`Seek::stream_position`]
1290 - [`array::IntoIter`]
1291 - [`panic::panic_any`]
1292 - [`ptr::addr_of!`]
1293 - [`ptr::addr_of_mut!`]
1294 - [`slice::fill_with`]
1295 - [`slice::split_inclusive_mut`]
1296 - [`slice::split_inclusive`]
1297 - [`slice::strip_prefix`]
1298 - [`slice::strip_suffix`]
1299 - [`str::split_inclusive`]
1300 - [`sync::OnceState`]
1301 - [`task::Wake`]
1302 - [`VecDeque::range`]
1303 - [`VecDeque::range_mut`]
1304
1305 Cargo
1306 -----
1307 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
1308   codegen option.][cargo/9112]
1309 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
1310   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
1311   to avoid unifying features of dependencies where that unification could be unwanted.
1312   Such as using the same dependency with a `std` feature in a build scripts and
1313   proc-macros, while using the `no-std` feature in the final binary. See the
1314   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
1315
1316 Rustdoc
1317 -------
1318
1319 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
1320 - [You can now provide a `--default-theme` flag which sets the default theme to use for
1321   documentation.][79642]
1322
1323 Various improvements to intra-doc links:
1324
1325 - [You can link to non-path primitives such as `slice`.][80181]
1326 - [You can link to associated items.][74489]
1327 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
1328
1329 Misc
1330 ----
1331 - [You can now pass `--include-ignored` to tests (e.g. with
1332   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
1333
1334 Compatibility Notes
1335 -------------------
1336
1337 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
1338 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
1339   could fail.][80579]
1340 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
1341   for the distributed artifacts.][81521]
1342     - `armv5te-unknown-linux-gnueabi`
1343     - `sparc64-unknown-linux-gnu`
1344     - `thumbv7neon-unknown-linux-gnueabihf`
1345     - `armv7-unknown-linux-gnueabi`
1346     - `x86_64-unknown-linux-gnux32`
1347 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
1348
1349 Internal Only
1350 -------------
1351
1352 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
1353
1354 [79135]: https://github.com/rust-lang/rust/pull/79135
1355 [74489]: https://github.com/rust-lang/rust/pull/74489
1356 [76934]: https://github.com/rust-lang/rust/pull/76934
1357 [79570]: https://github.com/rust-lang/rust/pull/79570
1358 [80181]: https://github.com/rust-lang/rust/pull/80181
1359 [79642]: https://github.com/rust-lang/rust/pull/79642
1360 [80945]: https://github.com/rust-lang/rust/pull/80945
1361 [80279]: https://github.com/rust-lang/rust/pull/80279
1362 [80053]: https://github.com/rust-lang/rust/pull/80053
1363 [79502]: https://github.com/rust-lang/rust/pull/79502
1364 [75180]: https://github.com/rust-lang/rust/pull/75180
1365 [81521]: https://github.com/rust-lang/rust/pull/81521
1366 [80968]: https://github.com/rust-lang/rust/pull/80968
1367 [80959]: https://github.com/rust-lang/rust/pull/80959
1368 [80718]: https://github.com/rust-lang/rust/pull/80718
1369 [80653]: https://github.com/rust-lang/rust/pull/80653
1370 [80579]: https://github.com/rust-lang/rust/pull/80579
1371 [79998]: https://github.com/rust-lang/rust/pull/79998
1372 [78044]: https://github.com/rust-lang/rust/pull/78044
1373 [81455]: https://github.com/rust-lang/rust/pull/81455
1374 [80764]: https://github.com/rust-lang/rust/pull/80764
1375 [80749]: https://github.com/rust-lang/rust/pull/80749
1376 [80662]: https://github.com/rust-lang/rust/pull/80662
1377 [79134]: https://github.com/rust-lang/rust/pull/79134
1378 [80966]: https://github.com/rust-lang/rust/pull/80966
1379 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
1380 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
1381 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
1382 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
1383 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
1384 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
1385 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1386 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
1387 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
1388 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
1389 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
1390 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
1391 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
1392 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
1393 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
1394 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
1395 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
1396 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
1397 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
1398 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
1399 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
1400 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
1401 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
1402
1403 Version 1.50.0 (2021-02-11)
1404 ============================
1405
1406 Language
1407 -----------------------
1408 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
1409   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
1410 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
1411
1412 Compiler
1413 -----------------------
1414 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
1415 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
1416 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
1417 - [Dropped support for all cloudabi targets.][78439]
1418
1419 \* Refer to Rust's [platform support page][platform-support-doc] for more
1420 information on Rust's tiered platform support.
1421
1422 Libraries
1423 -----------------------
1424
1425 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
1426 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
1427 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
1428   This value cannot be a valid file descriptor, and now means `Option<File>` takes
1429   up the same amount of space as `File`.
1430
1431 Stabilized APIs
1432 ---------------
1433
1434 - [`bool::then`]
1435 - [`btree_map::Entry::or_insert_with_key`]
1436 - [`f32::clamp`]
1437 - [`f64::clamp`]
1438 - [`hash_map::Entry::or_insert_with_key`]
1439 - [`Ord::clamp`]
1440 - [`RefCell::take`]
1441 - [`slice::fill`]
1442 - [`UnsafeCell::get_mut`]
1443
1444 The following previously stable methods are now `const`.
1445
1446 - [`IpAddr::is_ipv4`]
1447 - [`IpAddr::is_ipv6`]
1448 - [`IpAddr::is_unspecified`]
1449 - [`IpAddr::is_loopback`]
1450 - [`IpAddr::is_multicast`]
1451 - [`Ipv4Addr::octets`]
1452 - [`Ipv4Addr::is_loopback`]
1453 - [`Ipv4Addr::is_private`]
1454 - [`Ipv4Addr::is_link_local`]
1455 - [`Ipv4Addr::is_multicast`]
1456 - [`Ipv4Addr::is_broadcast`]
1457 - [`Ipv4Addr::is_documentation`]
1458 - [`Ipv4Addr::to_ipv6_compatible`]
1459 - [`Ipv4Addr::to_ipv6_mapped`]
1460 - [`Ipv6Addr::segments`]
1461 - [`Ipv6Addr::is_unspecified`]
1462 - [`Ipv6Addr::is_loopback`]
1463 - [`Ipv6Addr::is_multicast`]
1464 - [`Ipv6Addr::to_ipv4`]
1465 - [`Layout::size`]
1466 - [`Layout::align`]
1467 - [`Layout::from_size_align`]
1468 - `pow` for all integer types.
1469 - `checked_pow` for all integer types.
1470 - `saturating_pow` for all integer types.
1471 - `wrapping_pow` for all integer types.
1472 - `next_power_of_two` for all unsigned integer types.
1473 - `checked_next_power_of_two` for all unsigned integer types.
1474
1475 Cargo
1476 -----------------------
1477
1478 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
1479   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
1480 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
1481   contents of that directory for changes.][cargo/8973]
1482 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
1483
1484 Misc
1485 ----
1486
1487 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
1488 - [Running tests will now print the total time taken to execute.][75752]
1489
1490 Compatibility Notes
1491 -------------------
1492
1493 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
1494   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
1495 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
1496   unhygenic `macro_rules!` macros.][79472]
1497 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
1498   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
1499 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
1500 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
1501   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
1502 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
1503
1504 [74989]: https://github.com/rust-lang/rust/pull/74989
1505 [79261]: https://github.com/rust-lang/rust/pull/79261
1506 [79896]: https://github.com/rust-lang/rust/pull/79896
1507 [79484]: https://github.com/rust-lang/rust/pull/79484
1508 [79472]: https://github.com/rust-lang/rust/pull/79472
1509 [79270]: https://github.com/rust-lang/rust/pull/79270
1510 [79003]: https://github.com/rust-lang/rust/pull/79003
1511 [78864]: https://github.com/rust-lang/rust/pull/78864
1512 [78636]: https://github.com/rust-lang/rust/pull/78636
1513 [78439]: https://github.com/rust-lang/rust/pull/78439
1514 [78343]: https://github.com/rust-lang/rust/pull/78343
1515 [78296]: https://github.com/rust-lang/rust/pull/78296
1516 [78068]: https://github.com/rust-lang/rust/pull/78068
1517 [75752]: https://github.com/rust-lang/rust/pull/75752
1518 [74699]: https://github.com/rust-lang/rust/pull/74699
1519 [78142]: https://github.com/rust-lang/rust/pull/78142
1520 [77484]: https://github.com/rust-lang/rust/pull/77484
1521 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
1522 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
1523 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
1524 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
1525 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
1526 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
1527 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
1528 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
1529 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
1530 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
1531 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
1532 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
1533 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
1534 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
1535 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
1536 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
1537 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
1538 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
1539 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
1540 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
1541 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
1542 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
1543 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
1544 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
1545 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
1546 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
1547 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
1548 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
1549 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
1550 [`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
1551 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
1552 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
1553 [`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
1554 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
1555
1556
1557 Version 1.49.0 (2020-12-31)
1558 ============================
1559
1560 Language
1561 -----------------------
1562
1563 - [Unions can now implement `Drop`, and you can now have a field in a union
1564   with `ManuallyDrop<T>`.][77547]
1565 - [You can now cast uninhabited enums to integers.][76199]
1566 - [You can now bind by reference and by move in patterns.][76119] This
1567   allows you to selectively borrow individual components of a type. E.g.
1568   ```rust
1569   #[derive(Debug)]
1570   struct Person {
1571       name: String,
1572       age: u8,
1573   }
1574
1575   let person = Person {
1576       name: String::from("Alice"),
1577       age: 20,
1578   };
1579
1580   // `name` is moved out of person, but `age` is referenced.
1581   let Person { name, ref age } = person;
1582   println!("{} {}", name, age);
1583   ```
1584
1585 Compiler
1586 -----------------------
1587
1588 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
1589 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
1590 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
1591 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
1592 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1593 - [Output from threads spawned in tests is now captured.][78227]
1594 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1595
1596 \* Refer to Rust's [platform support page][platform-support-doc] for more
1597 information on Rust's tiered platform support.
1598
1599 Libraries
1600 -----------------------
1601
1602 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1603 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1604
1605 Stabilized APIs
1606 ---------------
1607
1608 - [`slice::select_nth_unstable`]
1609 - [`slice::select_nth_unstable_by`]
1610 - [`slice::select_nth_unstable_by_key`]
1611
1612 The following previously stable methods are now `const`.
1613
1614 - [`Poll::is_ready`]
1615 - [`Poll::is_pending`]
1616
1617 Cargo
1618 -----------------------
1619 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1620 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1621 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1622   variable will be set if the crate being built is one the user selected to build, either
1623   with `-p` or through defaults.
1624 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1625
1626
1627 Compatibility Notes
1628 -------------------
1629
1630 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1631 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1632 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1633   Previously such invalid or unused attributes could be ignored.
1634 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1635   read [this post about the changes][rustdoc-ws-post] for more details.
1636 - [Trait bounds are no longer inferred for associated types.][79904]
1637
1638 Internal Only
1639 -------------
1640 These changes provide no direct user facing benefits, but represent significant
1641 improvements to the internals and overall performance of rustc and
1642 related tools.
1643
1644 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1645   Local Storage model.][78201]
1646 - [Calculate visibilities once in resolve.][78077]
1647 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1648 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1649
1650
1651 [75991]: https://github.com/rust-lang/rust/pull/75991
1652 [78951]: https://github.com/rust-lang/rust/pull/78951
1653 [78848]: https://github.com/rust-lang/rust/pull/78848
1654 [78746]: https://github.com/rust-lang/rust/pull/78746
1655 [78376]: https://github.com/rust-lang/rust/pull/78376
1656 [78228]: https://github.com/rust-lang/rust/pull/78228
1657 [78227]: https://github.com/rust-lang/rust/pull/78227
1658 [78201]: https://github.com/rust-lang/rust/pull/78201
1659 [78109]: https://github.com/rust-lang/rust/pull/78109
1660 [78077]: https://github.com/rust-lang/rust/pull/78077
1661 [77997]: https://github.com/rust-lang/rust/pull/77997
1662 [77703]: https://github.com/rust-lang/rust/pull/77703
1663 [77547]: https://github.com/rust-lang/rust/pull/77547
1664 [77015]: https://github.com/rust-lang/rust/pull/77015
1665 [76199]: https://github.com/rust-lang/rust/pull/76199
1666 [76119]: https://github.com/rust-lang/rust/pull/76119
1667 [75914]: https://github.com/rust-lang/rust/pull/75914
1668 [79004]: https://github.com/rust-lang/rust/pull/79004
1669 [78676]: https://github.com/rust-lang/rust/pull/78676
1670 [79904]: https://github.com/rust-lang/rust/issues/79904
1671 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1672 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1673 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1674 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1675 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1676 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1677 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1678 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1679 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1680 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1681
1682 Version 1.48.0 (2020-11-19)
1683 ==========================
1684
1685 Language
1686 --------
1687
1688 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1689   is still rejected *semantically*, but can now be parsed by procedural macros.
1690
1691 Compiler
1692 --------
1693 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1694   `rustc` whether to link its own C runtime and libraries or to rely on a external
1695   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1696 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1697   Note: If you're using cargo you must explicitly pass the `--target` flag.
1698 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1699
1700 \* Refer to Rust's [platform support page][platform-support-doc] for more
1701 information on Rust's tiered platform support.
1702
1703 Libraries
1704 ---------
1705 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1706   and `&Stderr`.][76275]
1707 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1708 - [The `matches!` macro now supports having a trailing comma.][74880]
1709 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1710 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1711
1712 Stabilized APIs
1713 ---------------
1714 - [`slice::as_ptr_range`]
1715 - [`slice::as_mut_ptr_range`]
1716 - [`VecDeque::make_contiguous`]
1717 - [`future::pending`]
1718 - [`future::ready`]
1719
1720 The following previously stable methods are now `const fn`'s:
1721
1722 - [`Option::is_some`]
1723 - [`Option::is_none`]
1724 - [`Option::as_ref`]
1725 - [`Result::is_ok`]
1726 - [`Result::is_err`]
1727 - [`Result::as_ref`]
1728 - [`Ordering::reverse`]
1729 - [`Ordering::then`]
1730
1731 Cargo
1732 -----
1733
1734 Rustdoc
1735 -------
1736 - [You can now link to items in `rustdoc` using the intra-doc link
1737   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1738   a link to `std::future`'s documentation. See ["Linking to items by
1739   name"][intradoc-links] for more information.
1740 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1741   when searching through `rustdoc`'s UI.][75740]
1742
1743 Compatibility Notes
1744 -------------------
1745 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1746   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1747   promoted to `'static` lifetime any more inside `const fn`s.
1748 - [Associated type bindings on trait objects are now verified to meet the bounds
1749   declared on the trait when checking that they implement the trait.][27675]
1750 - [When trait bounds on associated types or opaque types are ambiguous, the
1751   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1752 - [Fixed recursive nonterminals not being expanded in macros during
1753   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1754   correctly handling recursive nonterminal tokens.
1755 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1756 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1757   in places where they have no effect.][73461]
1758 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1759   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1760 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1761   disallow zero-initialization.][71274]
1762 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1763 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1764   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1765   see the [`catch_unwind`] documentation for further information.
1766
1767
1768
1769 Internal Only
1770 -------------
1771 These changes provide no direct user facing benefits, but represent significant
1772 improvements to the internals and overall performance of rustc and
1773 related tools.
1774
1775 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1776   You can continue building with `make` by setting `ninja=false` in
1777   your `config.toml`.
1778 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1779 - [Made `ensure_sufficient_stack()` non-generic][76680]
1780
1781 [78143]: https://github.com/rust-lang/rust/issues/78143
1782 [76680]: https://github.com/rust-lang/rust/pull/76680/
1783 [76030]: https://github.com/rust-lang/rust/pull/76030/
1784 [70212]: https://github.com/rust-lang/rust/pull/70212/
1785 [27675]: https://github.com/rust-lang/rust/issues/27675/
1786 [54121]: https://github.com/rust-lang/rust/issues/54121/
1787 [71274]: https://github.com/rust-lang/rust/pull/71274/
1788 [77386]: https://github.com/rust-lang/rust/pull/77386/
1789 [77153]: https://github.com/rust-lang/rust/pull/77153/
1790 [77055]: https://github.com/rust-lang/rust/pull/77055/
1791 [76275]: https://github.com/rust-lang/rust/pull/76275/
1792 [76310]: https://github.com/rust-lang/rust/pull/76310/
1793 [76420]: https://github.com/rust-lang/rust/pull/76420/
1794 [76158]: https://github.com/rust-lang/rust/pull/76158/
1795 [75857]: https://github.com/rust-lang/rust/pull/75857/
1796 [75585]: https://github.com/rust-lang/rust/pull/75585/
1797 [75740]: https://github.com/rust-lang/rust/pull/75740/
1798 [75502]: https://github.com/rust-lang/rust/pull/75502/
1799 [74880]: https://github.com/rust-lang/rust/pull/74880/
1800 [74922]: https://github.com/rust-lang/rust/pull/74922/
1801 [74430]: https://github.com/rust-lang/rust/pull/74430/
1802 [74194]: https://github.com/rust-lang/rust/pull/74194/
1803 [73461]: https://github.com/rust-lang/rust/pull/73461/
1804 [73166]: https://github.com/rust-lang/rust/pull/73166/
1805 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1806 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1807 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1808 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1809 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1810 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1811 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1812 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1813 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1814 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1815 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1816 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1817 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1818 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1819 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1820
1821
1822 Version 1.47.0 (2020-10-08)
1823 ==========================
1824
1825 Language
1826 --------
1827 - [Closures will now warn when not used.][74869]
1828
1829 Compiler
1830 --------
1831 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1832   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1833   platforms.
1834 - [Upgraded to LLVM 11.][73526]
1835 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1836 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1837 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1838
1839 \* Refer to Rust's [platform support page][platform-support-doc] for more
1840 information on Rust's tiered platform support.
1841
1842 Libraries
1843 ---------
1844 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1845 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1846   those of length less than 33.][74060]
1847 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1848 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1849   `PartialEq`, and `PartialOrd`.][73583]
1850
1851 Stabilized APIs
1852 ---------------
1853 - [`Ident::new_raw`]
1854 - [`Range::is_empty`]
1855 - [`RangeInclusive::is_empty`]
1856 - [`Result::as_deref`]
1857 - [`Result::as_deref_mut`]
1858 - [`Vec::leak`]
1859 - [`pointer::offset_from`]
1860 - [`f32::TAU`]
1861 - [`f64::TAU`]
1862
1863 The following previously stable APIs have now been made const.
1864
1865 - [The `new` method for all `NonZero` integers.][73858]
1866 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1867   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1868   methods for all integers.][73858]
1869 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1870   signed integers.][73858]
1871 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1872   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1873   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1874   `is_ascii_control` methods for `char` and `u8`.][73858]
1875
1876 Cargo
1877 -----
1878 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1879   You can override this by setting the following in your `Cargo.toml`.
1880   ```toml
1881   [profile.release.build-override]
1882   opt-level = 3
1883   ```
1884 - [`cargo-help` will now display man pages for commands rather just the
1885   `--help` text.][cargo/8456]
1886 - [`cargo-metadata` now emits a `test` field indicating if a target has
1887   tests enabled.][cargo/8478]
1888 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1889 - [`cargo-publish` will now use an alternative registry by default if it's the
1890   only registry specified in `package.publish`.][cargo/8571]
1891
1892 Misc
1893 ----
1894 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1895   type based search.][75366]
1896 - [Added the Ayu theme to rustdoc.][71237]
1897
1898 Compatibility Notes
1899 -------------------
1900 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1901 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1902 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1903   help to preserve more span information.][73084] These changes may cause
1904   compiliation errors if your macro was unhygenic or didn't correctly handle
1905   `Delimiter::None`.
1906 - [Moved support for the CloudABI target to tier 3.][75568]
1907 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1908 - [Added the `rustc-docs` component.][75560] This allows you to install
1909   and read the documentation for the compiler internal APIs. (Currently only
1910   available for `x86_64-unknown-linux-gnu`.)
1911
1912 Internal Only
1913 --------
1914
1915 - [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.
1916
1917 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1918 [75048]: https://github.com/rust-lang/rust/pull/75048/
1919 [74163]: https://github.com/rust-lang/rust/pull/74163/
1920 [71237]: https://github.com/rust-lang/rust/pull/71237/
1921 [74869]: https://github.com/rust-lang/rust/pull/74869/
1922 [73858]: https://github.com/rust-lang/rust/pull/73858/
1923 [75716]: https://github.com/rust-lang/rust/pull/75716/
1924 [75560]: https://github.com/rust-lang/rust/pull/75560/
1925 [75568]: https://github.com/rust-lang/rust/pull/75568/
1926 [75366]: https://github.com/rust-lang/rust/pull/75366/
1927 [75204]: https://github.com/rust-lang/rust/pull/75204/
1928 [74650]: https://github.com/rust-lang/rust/pull/74650/
1929 [74419]: https://github.com/rust-lang/rust/pull/74419/
1930 [73964]: https://github.com/rust-lang/rust/pull/73964/
1931 [74021]: https://github.com/rust-lang/rust/pull/74021/
1932 [74060]: https://github.com/rust-lang/rust/pull/74060/
1933 [73893]: https://github.com/rust-lang/rust/pull/73893/
1934 [73526]: https://github.com/rust-lang/rust/pull/73526/
1935 [73583]: https://github.com/rust-lang/rust/pull/73583/
1936 [73084]: https://github.com/rust-lang/rust/pull/73084/
1937 [73197]: https://github.com/rust-lang/rust/pull/73197/
1938 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1939 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1940 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1941 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1942 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1943 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1944 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1945 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1946 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1947 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1948 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1949 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1950 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1951 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1952
1953
1954 Version 1.46.0 (2020-08-27)
1955 ==========================
1956
1957 Language
1958 --------
1959 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1960 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1961   const functions.][73862]
1962 - [The `#[track_caller]` attribute can now be added to functions to use the
1963   function's caller's location information for panic messages.][72445]
1964 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1965   `x.0.0` over `(x.0).0`.
1966 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1967   You currently can't use `mem::transmute` in constant functions.
1968
1969 Compiler
1970 --------
1971 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1972 - [Enabled static "Position Independent Executables" by default
1973   for `x86_64-unknown-linux-musl`.][70740]
1974
1975 Libraries
1976 ---------
1977 - [`mem::forget` is now a `const fn`.][73887]
1978 - [`String` now implements `From<char>`.][73466]
1979 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1980   integer types.][73032]
1981 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1982 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1983   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1984 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1985 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1986 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1987
1988 Stabilized APIs
1989 ---------------
1990 - [`Option::zip`]
1991 - [`vec::Drain::as_slice`]
1992
1993 Cargo
1994 -----
1995 Added a number of new environment variables that are now available when
1996 compiling your crate.
1997
1998 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1999   the specific binary being compiled and the name of the crate.
2000 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
2001 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
2002
2003 Compatibility Notes
2004 -------------------
2005 - [The target configuration option `abi_blacklist` has been renamed
2006   to `unsupported_abis`.][74150] The old name will still continue to work.
2007 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
2008   This was previously accepted but will become a hard error in a future release.
2009 - [Rustc will fail to compile if you have a struct with
2010   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
2011   allowed on `enum`s.
2012 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
2013   ensure that spans have the correct information, and may cause breakage if you
2014   were relying on receiving spans with dummy information.
2015 - [The InnoSetup installer for Windows is no longer available.][72569] This was
2016   a legacy installer that was replaced by a MSI installer a few years ago but
2017   was still being built.
2018 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
2019 - [Rustc will no longer accept overlapping trait implementations that only
2020   differ in how the lifetime was bound.][72493]
2021 - [Rustc now correctly relates the lifetime of an existential associated
2022   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
2023   you to pass a shorter lifetime than expected.
2024 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
2025   The library will need to be installed for `rustc` to work, even though we
2026   expect it to be already available on most systems.
2027 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
2028   under QEMU.][74820]
2029 - [Pretty printing of some tokens in procedural macros changed.][75453] The
2030   exact output returned by rustc's pretty printing is an unstable
2031   implementation detail: we recommend any macro relying on it to switch to a
2032   more robust parsing system.
2033
2034 [75453]: https://github.com/rust-lang/rust/issues/75453/
2035 [74820]: https://github.com/rust-lang/rust/issues/74820/
2036 [74420]: https://github.com/rust-lang/rust/issues/74420/
2037 [74109]: https://github.com/rust-lang/rust/pull/74109/
2038 [74150]: https://github.com/rust-lang/rust/pull/74150/
2039 [73862]: https://github.com/rust-lang/rust/pull/73862/
2040 [73887]: https://github.com/rust-lang/rust/pull/73887/
2041 [73466]: https://github.com/rust-lang/rust/pull/73466/
2042 [73516]: https://github.com/rust-lang/rust/pull/73516/
2043 [73293]: https://github.com/rust-lang/rust/pull/73293/
2044 [73007]: https://github.com/rust-lang/rust/pull/73007/
2045 [73032]: https://github.com/rust-lang/rust/pull/73032/
2046 [72920]: https://github.com/rust-lang/rust/pull/72920/
2047 [72569]: https://github.com/rust-lang/rust/pull/72569/
2048 [72583]: https://github.com/rust-lang/rust/pull/72583/
2049 [72584]: https://github.com/rust-lang/rust/pull/72584/
2050 [72717]: https://github.com/rust-lang/rust/pull/72717/
2051 [72437]: https://github.com/rust-lang/rust/pull/72437/
2052 [72445]: https://github.com/rust-lang/rust/pull/72445/
2053 [72486]: https://github.com/rust-lang/rust/pull/72486/
2054 [72493]: https://github.com/rust-lang/rust/pull/72493/
2055 [72331]: https://github.com/rust-lang/rust/pull/72331/
2056 [71896]: https://github.com/rust-lang/rust/pull/71896/
2057 [71660]: https://github.com/rust-lang/rust/pull/71660/
2058 [71322]: https://github.com/rust-lang/rust/pull/71322/
2059 [70740]: https://github.com/rust-lang/rust/pull/70740/
2060 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
2061 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
2062 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
2063 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
2064 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
2065
2066
2067 Version 1.45.2 (2020-08-03)
2068 ==========================
2069
2070 * [Fix bindings in tuple struct patterns][74954]
2071 * [Fix track_caller integration with trait objects][74784]
2072
2073 [74954]: https://github.com/rust-lang/rust/issues/74954
2074 [74784]: https://github.com/rust-lang/rust/issues/74784
2075
2076
2077 Version 1.45.1 (2020-07-30)
2078 ==========================
2079
2080 * [Fix const propagation with references.][73613]
2081 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2082 * [Avoid spurious implicit region bound.][74509]
2083 * [Install clippy on x.py install][74457]
2084
2085 [73613]: https://github.com/rust-lang/rust/pull/73613
2086 [73078]: https://github.com/rust-lang/rust/issues/73078
2087 [74509]: https://github.com/rust-lang/rust/pull/74509
2088 [74457]: https://github.com/rust-lang/rust/pull/74457
2089
2090
2091 Version 1.45.0 (2020-07-16)
2092 ==========================
2093
2094 Language
2095 --------
2096 - [Out of range float to int conversions using `as` has been defined as a saturating
2097   conversion.][71269] This was previously undefined behaviour, but you can use the
2098    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
2099    may be desirable in rare performance sensitive situations.
2100 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
2101   using `u64`.][70705]
2102 - [Function like procedural macros can now be used in expression, pattern, and  statement
2103   positions.][68717] This means you can now use a function-like procedural macro
2104   anywhere you can use a declarative (`macro_rules!`) macro.
2105
2106 Compiler
2107 --------
2108 - [You can now override individual target features through the `target-feature`
2109   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
2110   equivalent to `-C target-feature=+avx2,+fma`.
2111 - [Added the `force-unwind-tables` flag.][69984] This option allows
2112   rustc to always generate unwind tables regardless of panic strategy.
2113 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
2114   to include LLVM bitcode into generated `rlib`s (this is on by default).
2115 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
2116 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
2117 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
2118 - [Upgraded to LLVM 10.][67759]
2119
2120 \* Refer to Rust's [platform support page][platform-support-doc] for more
2121 information on Rust's tiered platform support.
2122
2123
2124 Libraries
2125 ---------
2126 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
2127   and `Ord`.][72239]
2128 - [`proc_macro::TokenStream` now implements `Default`.][72234]
2129 - [You can now use `char` with
2130   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
2131   a range of codepoints.][72413] E.g.
2132   you can now write the following;
2133   ```rust
2134   for ch in 'a'..='z' {
2135       print!("{}", ch);
2136   }
2137   println!();
2138   // Prints "abcdefghijklmnopqrstuvwxyz"
2139   ```
2140 - [`OsString` now implements `FromStr`.][71662]
2141 - [The `saturating_neg` method has been added to all signed integer primitive
2142   types, and the `saturating_abs` method has been added for all integer
2143   primitive types.][71886]
2144 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
2145   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
2146   or `Path`.][71447]
2147 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
2148 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
2149   integer types.][69813]
2150 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
2151   integer types.][72324]
2152 - [The `fetch_update` method has been added to all atomic integer types.][71843]
2153
2154 Stabilized APIs
2155 ---------------
2156 - [`Arc::as_ptr`]
2157 - [`BTreeMap::remove_entry`]
2158 - [`Rc::as_ptr`]
2159 - [`rc::Weak::as_ptr`]
2160 - [`rc::Weak::from_raw`]
2161 - [`rc::Weak::into_raw`]
2162 - [`str::strip_prefix`]
2163 - [`str::strip_suffix`]
2164 - [`sync::Weak::as_ptr`]
2165 - [`sync::Weak::from_raw`]
2166 - [`sync::Weak::into_raw`]
2167 - [`char::UNICODE_VERSION`]
2168 - [`Span::resolved_at`]
2169 - [`Span::located_at`]
2170 - [`Span::mixed_site`]
2171 - [`unix::process::CommandExt::arg0`]
2172
2173 Cargo
2174 -----
2175
2176 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
2177   time.][cargo/8066]
2178
2179 Misc
2180 ----
2181 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
2182   `~~outdated information~~` becomes "~~outdated information~~".
2183 - [Added an emoji to Rustdoc's deprecated API message.][72014]
2184
2185 Compatibility Notes
2186 -------------------
2187 - [Trying to self initialize a static value (that is creating a value using
2188   itself) is unsound and now causes a compile error.][71140]
2189 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
2190   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
2191 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
2192   previously undocumented and not intended for public use. Rustdoc still provides
2193   a non-zero exit code on errors.
2194 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
2195   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
2196   flags while cargo is adding `embed-bitcode` itself. The recommended way to
2197   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
2198   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
2199
2200 Internals Only
2201 --------------
2202 - [Make clippy a git subtree instead of a git submodule][70655]
2203 - [Unify the undo log of all snapshot types][69464]
2204
2205 [71848]: https://github.com/rust-lang/rust/issues/71848/
2206 [73420]: https://github.com/rust-lang/rust/issues/73420/
2207 [72324]: https://github.com/rust-lang/rust/pull/72324/
2208 [71843]: https://github.com/rust-lang/rust/pull/71843/
2209 [71886]: https://github.com/rust-lang/rust/pull/71886/
2210 [72234]: https://github.com/rust-lang/rust/pull/72234/
2211 [72239]: https://github.com/rust-lang/rust/pull/72239/
2212 [72397]: https://github.com/rust-lang/rust/pull/72397/
2213 [72413]: https://github.com/rust-lang/rust/pull/72413/
2214 [72014]: https://github.com/rust-lang/rust/pull/72014/
2215 [72062]: https://github.com/rust-lang/rust/pull/72062/
2216 [72094]: https://github.com/rust-lang/rust/pull/72094/
2217 [72133]: https://github.com/rust-lang/rust/pull/72133/
2218 [67759]: https://github.com/rust-lang/rust/pull/67759/
2219 [71900]: https://github.com/rust-lang/rust/pull/71900/
2220 [71928]: https://github.com/rust-lang/rust/pull/71928/
2221 [71662]: https://github.com/rust-lang/rust/pull/71662/
2222 [71716]: https://github.com/rust-lang/rust/pull/71716/
2223 [71447]: https://github.com/rust-lang/rust/pull/71447/
2224 [71269]: https://github.com/rust-lang/rust/pull/71269/
2225 [71095]: https://github.com/rust-lang/rust/pull/71095/
2226 [71140]: https://github.com/rust-lang/rust/pull/71140/
2227 [70655]: https://github.com/rust-lang/rust/pull/70655/
2228 [70705]: https://github.com/rust-lang/rust/pull/70705/
2229 [69984]: https://github.com/rust-lang/rust/pull/69984/
2230 [69813]: https://github.com/rust-lang/rust/pull/69813/
2231 [69464]: https://github.com/rust-lang/rust/pull/69464/
2232 [68717]: https://github.com/rust-lang/rust/pull/68717/
2233 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
2234 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
2235 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
2236 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
2237 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
2238 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
2239 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
2240 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
2241 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
2242 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
2243 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
2244 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
2245 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
2246 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
2247 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
2248 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
2249 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
2250
2251
2252 Version 1.44.1 (2020-06-18)
2253 ===========================
2254
2255 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
2256 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
2257 * [Fix crashes when finding backtrace on macOS.][71397]
2258 * [Clippy applies lint levels into different files.][clippy/5356]
2259
2260 [71397]: https://github.com/rust-lang/rust/issues/71397
2261 [73078]: https://github.com/rust-lang/rust/issues/73078
2262 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
2263 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
2264
2265
2266 Version 1.44.0 (2020-06-04)
2267 ==========================
2268
2269 Language
2270 --------
2271 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
2272 - [Added the `unused_braces` lint.][70081]
2273
2274 **Syntax-only changes**
2275
2276 - [Expansion-driven outline module parsing][69838]
2277 ```rust
2278 #[cfg(FALSE)]
2279 mod foo {
2280     mod bar {
2281         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
2282     }
2283 }
2284 ```
2285
2286 These are still rejected semantically, so you will likely receive an error but
2287 these changes can be seen and parsed by macros and conditional compilation.
2288
2289 Compiler
2290 --------
2291 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
2292   Additionally when in incremental mode rustc defaults to 256 codegen units.
2293 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
2294   a panic is thrown.][67502]
2295 - [Added tier 3\* support for the `aarch64-unknown-none` and
2296   `aarch64-unknown-none-softfloat` targets.][68334]
2297 - [Added tier 3 support for `arm64-apple-tvos` and
2298   `x86_64-apple-tvos` targets.][68191]
2299
2300
2301 Libraries
2302 ---------
2303 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
2304   `vec![]` to be able to be used in `const` contexts.
2305 - [`convert::Infallible` now implements `Hash`.][70281]
2306 - [`OsString` now implements `DerefMut` and `IndexMut` returning
2307   a `&mut OsStr`.][70048]
2308 - [Unicode 13 is now supported.][69929]
2309 - [`String` now implements `From<&mut str>`.][69661]
2310 - [`IoSlice` now implements `Copy`.][69403]
2311 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
2312 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
2313 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
2314   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
2315   integer types.][69373]
2316
2317 Stabilized APIs
2318 ---------------
2319 - [`PathBuf::with_capacity`]
2320 - [`PathBuf::capacity`]
2321 - [`PathBuf::clear`]
2322 - [`PathBuf::reserve`]
2323 - [`PathBuf::reserve_exact`]
2324 - [`PathBuf::shrink_to_fit`]
2325 - [`f32::to_int_unchecked`]
2326 - [`f64::to_int_unchecked`]
2327 - [`Layout::align_to`]
2328 - [`Layout::pad_to_align`]
2329 - [`Layout::array`]
2330 - [`Layout::extend`]
2331
2332 Cargo
2333 -----
2334 - [Added the `cargo tree` command which will print a tree graph of
2335   your dependencies.][cargo/8062] E.g.
2336   ```
2337     mdbook v0.3.2 (/Users/src/rust/mdbook)
2338   ├── ammonia v3.0.0
2339   │   ├── html5ever v0.24.0
2340   │   │   ├── log v0.4.8
2341   │   │   │   └── cfg-if v0.1.9
2342   │   │   ├── mac v0.1.1
2343   │   │   └── markup5ever v0.9.0
2344   │   │       ├── log v0.4.8 (*)
2345   │   │       ├── phf v0.7.24
2346   │   │       │   └── phf_shared v0.7.24
2347   │   │       │       ├── siphasher v0.2.3
2348   │   │       │       └── unicase v1.4.2
2349   │   │       │           [build-dependencies]
2350   │   │       │           └── version_check v0.1.5
2351   ...
2352   ```
2353   You can also display dependencies on multiple versions of the same crate with
2354   `cargo tree -d` (short for `cargo tree --duplicates`).
2355
2356 Misc
2357 ----
2358 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
2359   the version in the sidebar.][69494]
2360
2361 Compatibility Notes
2362 -------------------
2363 - [Rustc now correctly generates static libraries on Windows GNU targets with
2364   the `.a` extension, rather than the previous `.lib`.][70937]
2365 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
2366 - [The `file_name` property in JSON output of macro errors now points the actual
2367   source file rather than the previous format of `<NAME macros>`.][70969]
2368   **Note:** this may not point to a file that actually exists on the user's system.
2369 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
2370 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
2371   not allow zero initialization such as `NonZeroU8`.][66059] This was
2372   previously a warning.
2373 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
2374   operator has been defined as a saturating operation.][71269] This was previously
2375   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
2376   continue using the current behaviour, which may be desirable in rare performance
2377   sensitive situations.
2378
2379 Internal Only
2380 -------------
2381 These changes provide no direct user facing benefits, but represent significant
2382 improvements to the internals and overall performance of rustc and
2383 related tools.
2384
2385 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
2386 - [Replace big JS dict with JSON parsing.][71250]
2387
2388 [69373]: https://github.com/rust-lang/rust/pull/69373/
2389 [66059]: https://github.com/rust-lang/rust/pull/66059/
2390 [68191]: https://github.com/rust-lang/rust/pull/68191/
2391 [68899]: https://github.com/rust-lang/rust/pull/68899/
2392 [71147]: https://github.com/rust-lang/rust/pull/71147/
2393 [71250]: https://github.com/rust-lang/rust/pull/71250/
2394 [70937]: https://github.com/rust-lang/rust/pull/70937/
2395 [70969]: https://github.com/rust-lang/rust/pull/70969/
2396 [70632]: https://github.com/rust-lang/rust/pull/70632/
2397 [70281]: https://github.com/rust-lang/rust/pull/70281/
2398 [70345]: https://github.com/rust-lang/rust/pull/70345/
2399 [70048]: https://github.com/rust-lang/rust/pull/70048/
2400 [70081]: https://github.com/rust-lang/rust/pull/70081/
2401 [70156]: https://github.com/rust-lang/rust/pull/70156/
2402 [71269]: https://github.com/rust-lang/rust/pull/71269/
2403 [69838]: https://github.com/rust-lang/rust/pull/69838/
2404 [69929]: https://github.com/rust-lang/rust/pull/69929/
2405 [69661]: https://github.com/rust-lang/rust/pull/69661/
2406 [69778]: https://github.com/rust-lang/rust/pull/69778/
2407 [69494]: https://github.com/rust-lang/rust/pull/69494/
2408 [69403]: https://github.com/rust-lang/rust/pull/69403/
2409 [69033]: https://github.com/rust-lang/rust/pull/69033/
2410 [68692]: https://github.com/rust-lang/rust/pull/68692/
2411 [68334]: https://github.com/rust-lang/rust/pull/68334/
2412 [67502]: https://github.com/rust-lang/rust/pull/67502/
2413 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
2414 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
2415 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
2416 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
2417 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
2418 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
2419 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
2420 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
2421 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
2422 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
2423 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
2424 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
2425 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
2426
2427
2428 Version 1.43.1 (2020-05-07)
2429 ===========================
2430
2431 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
2432 * [Fixed the stabilization of AVX-512 features.][71473]
2433 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
2434
2435 [71430]: https://github.com/rust-lang/rust/pull/71430
2436 [71473]: https://github.com/rust-lang/rust/issues/71473
2437 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
2438
2439
2440 Version 1.43.0 (2020-04-23)
2441 ==========================
2442
2443 Language
2444 --------
2445 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
2446   the type inferred correctly.][68129]
2447 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
2448
2449 **Syntax only changes**
2450 - [Allow `type Foo: Ord` syntactically.][69361]
2451 - [Fuse associated and extern items up to defaultness.][69194]
2452 - [Syntactically allow `self` in all `fn` contexts.][68764]
2453 - [Merge `fn` syntax + cleanup item parsing.][68728]
2454 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
2455   For example, you may now write:
2456   ```rust
2457   macro_rules! mac_trait {
2458       ($i:item) => {
2459           trait T { $i }
2460       }
2461   }
2462   mac_trait! {
2463       fn foo() {}
2464   }
2465   ```
2466
2467 These are still rejected *semantically*, so you will likely receive an error but
2468 these changes can be seen and parsed by macros and
2469 conditional compilation.
2470
2471
2472 Compiler
2473 --------
2474 - [You can now pass multiple lint flags to rustc to override the previous
2475   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
2476   everything in the `unused` lint group except `unused-variables` which
2477   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
2478   everything in the `unused` lint group **including** `unused-variables` since
2479   the allow flag is specified before the deny flag (and therefore overridden).
2480 - [rustc will now prefer your system MinGW libraries over its bundled libraries
2481   if they are available on `windows-gnu`.][67429]
2482 - [rustc now buffers errors/warnings printed in JSON.][69227]
2483
2484 Libraries
2485 ---------
2486 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
2487   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
2488   respectively.][69538] **Note** These conversions are only available when `N`
2489   is `0..=32`.
2490 - [You can now use associated constants on floats and integers directly, rather
2491   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
2492   `f32::NAN` with no imports.
2493 - [`u8::is_ascii` is now `const`.][68984]
2494 - [`String` now implements `AsMut<str>`.][68742]
2495 - [Added the `primitive` module to `std` and `core`.][67637] This module
2496   reexports Rust's primitive types. This is mainly useful in macros
2497   where you want avoid these types being shadowed.
2498 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
2499 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
2500
2501 Stabilized APIs
2502 ---------------
2503 - [`Once::is_completed`]
2504 - [`f32::LOG10_2`]
2505 - [`f32::LOG2_10`]
2506 - [`f64::LOG10_2`]
2507 - [`f64::LOG2_10`]
2508 - [`iter::once_with`]
2509
2510 Cargo
2511 -----
2512 - [You can now set config `[profile]`s in your `.cargo/config`, or through
2513   your environment.][cargo/7823]
2514 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
2515   executable path when running integration tests or benchmarks.][cargo/7697]
2516   `<name>` is the name of your binary as-is e.g. If you wanted the executable
2517   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
2518
2519 Misc
2520 ----
2521 - [Certain checks in the `const_err` lint were deemed unrelated to const
2522   evaluation][69185], and have been moved to the `unconditional_panic` and
2523   `arithmetic_overflow` lints.
2524
2525 Compatibility Notes
2526 -------------------
2527
2528 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
2529   has been a warning since 1.36.0.
2530 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
2531   led to some instances being accepted, and now correctly emits a hard error.
2532
2533 [69340]: https://github.com/rust-lang/rust/pull/69340
2534
2535 Internal Only
2536 -------------
2537 These changes provide no direct user facing benefits, but represent significant
2538 improvements to the internals and overall performance of `rustc` and
2539 related tools.
2540
2541 - [All components are now built with `opt-level=3` instead of `2`.][67878]
2542 - [Improved how rustc generates drop code.][67332]
2543 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
2544 - [traits: preallocate 2 Vecs of known initial size][69022]
2545 - [Avoid exponential behaviour when relating types][68772]
2546 - [Skip `Drop` terminators for enum variants without drop glue][68943]
2547 - [Improve performance of coherence checks][68966]
2548 - [Deduplicate types in the generator witness][68672]
2549 - [Invert control in struct_lint_level.][68725]
2550
2551 [67332]: https://github.com/rust-lang/rust/pull/67332/
2552 [67429]: https://github.com/rust-lang/rust/pull/67429/
2553 [67637]: https://github.com/rust-lang/rust/pull/67637/
2554 [67642]: https://github.com/rust-lang/rust/pull/67642/
2555 [67878]: https://github.com/rust-lang/rust/pull/67878/
2556 [67885]: https://github.com/rust-lang/rust/pull/67885/
2557 [68129]: https://github.com/rust-lang/rust/pull/68129/
2558 [68672]: https://github.com/rust-lang/rust/pull/68672/
2559 [68725]: https://github.com/rust-lang/rust/pull/68725/
2560 [68728]: https://github.com/rust-lang/rust/pull/68728/
2561 [68738]: https://github.com/rust-lang/rust/pull/68738/
2562 [68742]: https://github.com/rust-lang/rust/pull/68742/
2563 [68764]: https://github.com/rust-lang/rust/pull/68764/
2564 [68772]: https://github.com/rust-lang/rust/pull/68772/
2565 [68943]: https://github.com/rust-lang/rust/pull/68943/
2566 [68952]: https://github.com/rust-lang/rust/pull/68952/
2567 [68966]: https://github.com/rust-lang/rust/pull/68966/
2568 [68984]: https://github.com/rust-lang/rust/pull/68984/
2569 [69022]: https://github.com/rust-lang/rust/pull/69022/
2570 [69185]: https://github.com/rust-lang/rust/pull/69185/
2571 [69194]: https://github.com/rust-lang/rust/pull/69194/
2572 [69201]: https://github.com/rust-lang/rust/pull/69201/
2573 [69227]: https://github.com/rust-lang/rust/pull/69227/
2574 [69548]: https://github.com/rust-lang/rust/pull/69548/
2575 [69256]: https://github.com/rust-lang/rust/pull/69256/
2576 [69361]: https://github.com/rust-lang/rust/pull/69361/
2577 [69366]: https://github.com/rust-lang/rust/pull/69366/
2578 [69538]: https://github.com/rust-lang/rust/pull/69538/
2579 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
2580 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
2581 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
2582 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
2583 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
2584 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
2585 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
2586 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
2587
2588
2589 Version 1.42.0 (2020-03-12)
2590 ==========================
2591
2592 Language
2593 --------
2594 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2595   ```rust
2596   fn foo(words: &[&str]) {
2597       match words {
2598           ["Hello", "World", "!", ..] => println!("Hello World!"),
2599           ["Foo", "Bar", ..] => println!("Baz"),
2600           rest => println!("{:?}", rest),
2601       }
2602   }
2603   ```
2604 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2605   that you can create an enum that has the exact layout and ABI of the type
2606   it contains.
2607 - [You can now use outer attribute procedural macros on inline modules.][64273]
2608 - [There are some *syntax-only* changes:][67131]
2609    - `default` is syntactically allowed before items in `trait` definitions.
2610    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2611      leave out their bodies in favor of `;`.
2612    - Bounds on associated types in `impl`s are now syntactically allowed
2613      (e.g. `type Foo: Ord;`).
2614    - `...` (the C-variadic type) may occur syntactically directly as the type of
2615       any function parameter.
2616
2617   These are still rejected *semantically*, so you will likely receive an error
2618   but these changes can be seen and parsed by procedural macros and
2619   conditional compilation.
2620
2621 Compiler
2622 --------
2623 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2624 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2625 - [`Option::{expect,unwrap}` and
2626    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2627    pointing to the location where they were called, rather than
2628    `core`'s internals. ][67887]
2629
2630 \* Refer to Rust's [platform support page][platform-support-doc] for more
2631 information on Rust's tiered platform support.
2632
2633 Libraries
2634 ---------
2635 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2636 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2637    to implement `Sized`.][67935]
2638 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2639 - [`Layout::new` is now `const`.][66254]
2640 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2641
2642
2643 Stabilized APIs
2644 ---------------
2645 - [`CondVar::wait_while`]
2646 - [`CondVar::wait_timeout_while`]
2647 - [`DebugMap::key`]
2648 - [`DebugMap::value`]
2649 - [`ManuallyDrop::take`]
2650 - [`matches!`]
2651 - [`ptr::slice_from_raw_parts_mut`]
2652 - [`ptr::slice_from_raw_parts`]
2653
2654 Cargo
2655 -----
2656 - [You no longer need to include `extern crate proc_macro;` to be able to
2657   `use proc_macro;` in the `2018` edition.][cargo/7700]
2658
2659 Compatibility Notes
2660 -------------------
2661 - [`Error::description` has been deprecated, and its use will now produce a
2662   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2663
2664 [68253]: https://github.com/rust-lang/rust/pull/68253/
2665 [68348]: https://github.com/rust-lang/rust/pull/68348/
2666 [67935]: https://github.com/rust-lang/rust/pull/67935/
2667 [68339]: https://github.com/rust-lang/rust/pull/68339/
2668 [68122]: https://github.com/rust-lang/rust/pull/68122/
2669 [64273]: https://github.com/rust-lang/rust/pull/64273/
2670 [67712]: https://github.com/rust-lang/rust/pull/67712/
2671 [67887]: https://github.com/rust-lang/rust/pull/67887/
2672 [67131]: https://github.com/rust-lang/rust/pull/67131/
2673 [67233]: https://github.com/rust-lang/rust/pull/67233/
2674 [66899]: https://github.com/rust-lang/rust/pull/66899/
2675 [66919]: https://github.com/rust-lang/rust/pull/66919/
2676 [66254]: https://github.com/rust-lang/rust/pull/66254/
2677 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2678 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2679 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2680 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2681 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2682 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2683 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2684 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2685 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2686
2687
2688 Version 1.41.1 (2020-02-27)
2689 ===========================
2690
2691 * [Always check types of static items][69145]
2692 * [Always check lifetime bounds of `Copy` impls][69145]
2693 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2694
2695 [69225]: https://github.com/rust-lang/rust/issues/69225
2696 [69145]: https://github.com/rust-lang/rust/pull/69145
2697
2698
2699 Version 1.41.0 (2020-01-30)
2700 ===========================
2701
2702 Language
2703 --------
2704
2705 - [You can now pass type parameters to foreign items when implementing
2706   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2707 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2708   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2709   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2710 - [You can now use any valid identifier in a `format_args` macro.][66847]
2711   Previously identifiers starting with an underscore were not allowed.
2712 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2713   enum variants.][66183] These are still rejected semantically, but
2714   can be seen and parsed by procedural macros and conditional compilation.
2715 - [You can now define a Rust `extern "C"` function with `Box<T>` and use `T*` as the corresponding
2716   type on the C side.][62514] Please see [the documentation][box-memory-layout] for more information,
2717   including the important caveat about preferring to avoid `Box<T>` in Rust signatures for functions defined in C.
2718
2719 [box-memory-layout]: https://doc.rust-lang.org/std/boxed/index.html#memory-layout
2720
2721 Compiler
2722 --------
2723
2724 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2725 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2726 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2727 - [You can now pass an arguments file passing the `@path` syntax
2728   to rustc.][66172] Note that the format differs somewhat from what is
2729   found in other tooling; please see [the documentation][argfile-docs] for
2730   more information.
2731 - [You can now provide `--extern` flag without a path, indicating that it is
2732   available from the search path or specified with an `-L` flag.][64882]
2733
2734 \* Refer to Rust's [platform support page][platform-support-doc] for more
2735 information on Rust's tiered platform support.
2736
2737 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2738
2739 Libraries
2740 ---------
2741
2742 - [The `core::panic` module is now stable.][66771] It was already stable
2743   through `std`.
2744 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2745   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2746 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2747
2748 Stabilized APIs
2749 ---------------
2750
2751 - [`Result::map_or`]
2752 - [`Result::map_or_else`]
2753 - [`std::rc::Weak::weak_count`]
2754 - [`std::rc::Weak::strong_count`]
2755 - [`std::sync::Weak::weak_count`]
2756 - [`std::sync::Weak::strong_count`]
2757
2758 Cargo
2759 -----
2760
2761 - [Cargo will now document all the private items for binary crates
2762   by default.][cargo/7593]
2763 - [`cargo-install` will now reinstall the package if it detects that it is out
2764   of date.][cargo/7560]
2765 - [Cargo.lock now uses a more git friendly format that should help to reduce
2766   merge conflicts.][cargo/7579]
2767 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2768   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2769   optimisation level to `2` for debug builds. You can also use
2770   `[profile.<profile>.build-override]` to override build scripts and
2771   their dependencies.
2772
2773 Misc
2774 ----
2775
2776 - [You can now specify `edition` in documentation code blocks to compile the block
2777   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2778   should be compiled the 2018 edition of Rust.
2779 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2780   current theme with `--check-theme`.][54733]
2781 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2782
2783 Compatibility Notes
2784 -------------------
2785
2786 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2787   Apple targets.][apple-32bit-drop] This means that the source code is still
2788   available to build, but the targets are no longer being tested and release
2789   binaries for those platforms will no longer be distributed by the Rust project.
2790   Please refer to the linked blog post for more information.
2791
2792 [54733]: https://github.com/rust-lang/rust/pull/54733/
2793 [61351]: https://github.com/rust-lang/rust/pull/61351/
2794 [62514]: https://github.com/rust-lang/rust/pull/62514/
2795 [67255]: https://github.com/rust-lang/rust/pull/67255/
2796 [66661]: https://github.com/rust-lang/rust/pull/66661/
2797 [66771]: https://github.com/rust-lang/rust/pull/66771/
2798 [66847]: https://github.com/rust-lang/rust/pull/66847/
2799 [66238]: https://github.com/rust-lang/rust/pull/66238/
2800 [66277]: https://github.com/rust-lang/rust/pull/66277/
2801 [66325]: https://github.com/rust-lang/rust/pull/66325/
2802 [66172]: https://github.com/rust-lang/rust/pull/66172/
2803 [66183]: https://github.com/rust-lang/rust/pull/66183/
2804 [65879]: https://github.com/rust-lang/rust/pull/65879/
2805 [65013]: https://github.com/rust-lang/rust/pull/65013/
2806 [64882]: https://github.com/rust-lang/rust/pull/64882/
2807 [64325]: https://github.com/rust-lang/rust/pull/64325/
2808 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2809 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2810 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2811 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2812 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2813 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2814 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2815 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2816 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2817 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2818 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2819
2820 Version 1.40.0 (2019-12-19)
2821 ===========================
2822
2823 Language
2824 --------
2825 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2826   `const` contexts.][65188] e.g.
2827
2828   ```rust
2829   pub struct Point(i32, i32);
2830
2831   const ORIGIN: Point = {
2832       let constructor = Point;
2833
2834       constructor(0, 0)
2835   };
2836   ```
2837
2838 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2839   indicate that there may be variants or fields added in the future.][64639]
2840   For example this requires adding a wild-card branch (`_ => {}`) to any match
2841   statements on a non-exhaustive `enum`. [(RFC 2008)]
2842 - [You can now use function-like procedural macros in `extern` blocks and in
2843   type positions.][63931] e.g. `type Generated = macro!();`
2844 - [Function-like and attribute procedural macros can now emit
2845   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2846 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2847   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2848   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2849
2850 Compiler
2851 --------
2852 - [Added tier 3 support\* for the
2853   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2854 - [Added tier 3 support for the
2855   `aarch64-unknown-none-softfloat` target.][64589]
2856 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2857   `mips64el-unknown-linux-muslabi64` targets.][65843]
2858
2859 \* Refer to Rust's [platform support page][platform-support-doc] for more
2860   information on Rust's tiered platform support.
2861
2862 Libraries
2863 ---------
2864 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2865
2866 Stabilized APIs
2867 ---------------
2868 - [`BTreeMap::get_key_value`]
2869 - [`HashMap::get_key_value`]
2870 - [`Option::as_deref_mut`]
2871 - [`Option::as_deref`]
2872 - [`Option::flatten`]
2873 - [`UdpSocket::peer_addr`]
2874 - [`f32::to_be_bytes`]
2875 - [`f32::to_le_bytes`]
2876 - [`f32::to_ne_bytes`]
2877 - [`f64::to_be_bytes`]
2878 - [`f64::to_le_bytes`]
2879 - [`f64::to_ne_bytes`]
2880 - [`f32::from_be_bytes`]
2881 - [`f32::from_le_bytes`]
2882 - [`f32::from_ne_bytes`]
2883 - [`f64::from_be_bytes`]
2884 - [`f64::from_le_bytes`]
2885 - [`f64::from_ne_bytes`]
2886 - [`mem::take`]
2887 - [`slice::repeat`]
2888 - [`todo!`]
2889
2890 Cargo
2891 -----
2892 - [Cargo will now always display warnings, rather than only on
2893   fresh builds.][cargo/7450]
2894 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2895   now produce an error.][cargo/7507] Previously these flags were ignored.
2896 - [You can now publish `dev-dependencies` without including
2897   a `version`.][cargo/7333]
2898
2899 Misc
2900 ----
2901 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2902   when running documentation tests with `rustdoc`.][63803]
2903
2904 Compatibility Notes
2905 -------------------
2906 - [As previously announced, any previous NLL warnings in the 2015 edition are
2907   now hard errors.][64221]
2908 - [The `include!` macro will now warn if it failed to include the
2909   entire file.][64284] The `include!` macro unintentionally only includes the
2910   first _expression_ in a file, and this can be unintuitive. This will become
2911   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2912 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2913   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2914   or `extern` blocks now correctly emits a hard error.
2915
2916 [65294]: https://github.com/rust-lang/rust/pull/65294/
2917 [66103]: https://github.com/rust-lang/rust/pull/66103/
2918 [65843]: https://github.com/rust-lang/rust/pull/65843/
2919 [65188]: https://github.com/rust-lang/rust/pull/65188/
2920 [65092]: https://github.com/rust-lang/rust/pull/65092/
2921 [64589]: https://github.com/rust-lang/rust/pull/64589/
2922 [64639]: https://github.com/rust-lang/rust/pull/64639/
2923 [64221]: https://github.com/rust-lang/rust/pull/64221/
2924 [64284]: https://github.com/rust-lang/rust/pull/64284/
2925 [63931]: https://github.com/rust-lang/rust/pull/63931/
2926 [64035]: https://github.com/rust-lang/rust/pull/64035/
2927 [63674]: https://github.com/rust-lang/rust/pull/63674/
2928 [63803]: https://github.com/rust-lang/rust/pull/63803/
2929 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2930 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2931 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2932 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2933 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2934 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2935 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2936 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2937 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2938 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2939 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2940 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2941 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2942 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2943 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2944 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2945 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2946 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2947 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2948 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2949 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2950 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2951 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2952 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2953 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2954
2955
2956 Version 1.39.0 (2019-11-07)
2957 ===========================
2958
2959 Language
2960 --------
2961 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2962   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2963 - [You can now use certain attributes on function, closure, and function pointer
2964   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2965   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2966   attributes applied to items. e.g.
2967   ```rust
2968   fn len(
2969       #[cfg(windows)] slice: &[u16],
2970       #[cfg(not(windows))] slice: &[u8],
2971   ) -> usize {
2972       slice.len()
2973   }
2974   ```
2975 - [You can now take shared references to bind-by-move patterns in the `if` guards
2976   of `match` arms.][63118] e.g.
2977   ```rust
2978   fn main() {
2979       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2980
2981       match array {
2982           nums
2983   //      ---- `nums` is bound by move.
2984               if nums.iter().sum::<u8>() == 10
2985   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2986           => {
2987               drop(nums);
2988   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2989           }
2990           _ => unreachable!(),
2991       }
2992   }
2993   ```
2994
2995
2996
2997 Compiler
2998 --------
2999 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
3000 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
3001 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
3002   **Note** Cargo currently doesn't use this feature. Refer to
3003   [cargo#7315][cargo/7315] to track this feature's progress.
3004 - [You can now pass `--show-output` argument to test binaries to print the
3005   output of successful tests.][62600]
3006
3007
3008 \* Refer to Rust's [platform support page][platform-support-doc] for more
3009 information on Rust's tiered platform support.
3010
3011 Libraries
3012 ---------
3013 - [`Vec::new` and `String::new` are now `const` functions.][64028]
3014 - [`LinkedList::new` is now a `const` function.][63684]
3015 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
3016 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
3017   now `const`.][63786]
3018
3019 Stabilized APIs
3020 ---------------
3021 - [`Pin::into_inner`]
3022 - [`Instant::checked_duration_since`]
3023 - [`Instant::saturating_duration_since`]
3024
3025 Cargo
3026 -----
3027 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
3028 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
3029   `--all` is now deprecated.
3030
3031 Misc
3032 ----
3033 - [You can now pass `-Clinker` to rustdoc to control the linker used
3034   for compiling doctests.][63834]
3035
3036 Compatibility Notes
3037 -------------------
3038 - [Code that was previously accepted by the old borrow checker, but rejected by
3039   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
3040   previously a warning, and will also become a hard error in the Rust 2015
3041   edition in the 1.40.0 release.
3042 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
3043   run tests.][63827] This should improve performance when running a large
3044   amount of doctests.
3045 - [The `try!` macro will now issue a deprecation warning.][62672] It is
3046   recommended to use the `?` operator instead.
3047 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
3048   returned `0.0`.
3049
3050 [62600]: https://github.com/rust-lang/rust/pull/62600/
3051 [62672]: https://github.com/rust-lang/rust/pull/62672/
3052 [63118]: https://github.com/rust-lang/rust/pull/63118/
3053 [63209]: https://github.com/rust-lang/rust/pull/63209/
3054 [63402]: https://github.com/rust-lang/rust/pull/63402/
3055 [63565]: https://github.com/rust-lang/rust/pull/63565/
3056 [63595]: https://github.com/rust-lang/rust/pull/63595/
3057 [63684]: https://github.com/rust-lang/rust/pull/63684/
3058 [63698]: https://github.com/rust-lang/rust/pull/63698/
3059 [63770]: https://github.com/rust-lang/rust/pull/63770/
3060 [63786]: https://github.com/rust-lang/rust/pull/63786/
3061 [63827]: https://github.com/rust-lang/rust/pull/63827/
3062 [63834]: https://github.com/rust-lang/rust/pull/63834/
3063 [64010]: https://github.com/rust-lang/rust/pull/64010/
3064 [64028]: https://github.com/rust-lang/rust/pull/64028/
3065 [64334]: https://github.com/rust-lang/rust/pull/64334/
3066 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
3067 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
3068 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
3069 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
3070 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
3071 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
3072
3073 Version 1.38.0 (2019-09-26)
3074 ==========================
3075
3076 Language
3077 --------
3078 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
3079 - [The `#[deprecated]` attribute can now be used on macros.][62042]
3080
3081 Compiler
3082 --------
3083 - [Added pipelined compilation support to `rustc`.][62766] This will
3084   improve compilation times in some cases. For further information please refer
3085   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
3086 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
3087   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
3088   `x86_64-uwp-windows-msvc` targets.][60260]
3089 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
3090   `armv7-unknown-linux-musleabi` targets.][63107]
3091 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
3092 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
3093 - [Upgraded to LLVM 9.][62592]
3094
3095 \* Refer to Rust's [platform support page][platform-support-doc] for more
3096 information on Rust's tiered platform support.
3097
3098 Libraries
3099 ---------
3100 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
3101 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
3102   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
3103   is available at `std::clone::Clone`). This also makes all built-in macros
3104   available in `std`/`core` root. e.g. `std::include_bytes!`.
3105 - [`str::Chars` now implements `Debug`.][63000]
3106 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
3107 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
3108 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
3109 - [Added euclidean remainder and division operations (`div_euclid`,
3110   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
3111   `overflowing`, and `wrapping` versions are available for all
3112   integer primitives.
3113 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
3114   `PartialEq`.][61491]
3115 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
3116
3117 Stabilized APIs
3118 ---------------
3119 - [`<*const T>::cast`]
3120 - [`<*mut T>::cast`]
3121 - [`Duration::as_secs_f32`]
3122 - [`Duration::as_secs_f64`]
3123 - [`Duration::div_f32`]
3124 - [`Duration::div_f64`]
3125 - [`Duration::from_secs_f32`]
3126 - [`Duration::from_secs_f64`]
3127 - [`Duration::mul_f32`]
3128 - [`Duration::mul_f64`]
3129 - [`any::type_name`]
3130
3131 Cargo
3132 -----
3133 - [Added pipelined compilation support to `cargo`.][cargo/7143]
3134 - [You can now pass the `--features` option multiple times to enable
3135   multiple features.][cargo/7084]
3136
3137 Rustdoc
3138 -------
3139
3140 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
3141
3142 Misc
3143 ----
3144 - [`rustc` will now warn about some incorrect uses of
3145   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
3146
3147 Compatibility Notes
3148 -------------------
3149 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
3150   1.38.0.
3151 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
3152   issues][62896] with certain crates such as libc.
3153
3154 [60260]: https://github.com/rust-lang/rust/pull/60260/
3155 [61457]: https://github.com/rust-lang/rust/pull/61457/
3156 [61491]: https://github.com/rust-lang/rust/pull/61491/
3157 [61884]: https://github.com/rust-lang/rust/pull/61884/
3158 [61953]: https://github.com/rust-lang/rust/pull/61953/
3159 [62042]: https://github.com/rust-lang/rust/pull/62042/
3160 [62528]: https://github.com/rust-lang/rust/pull/62528/
3161 [62583]: https://github.com/rust-lang/rust/pull/62583/
3162 [62735]: https://github.com/rust-lang/rust/pull/62735/
3163 [62766]: https://github.com/rust-lang/rust/pull/62766/
3164 [62784]: https://github.com/rust-lang/rust/pull/62784/
3165 [62592]: https://github.com/rust-lang/rust/pull/62592/
3166 [62785]: https://github.com/rust-lang/rust/issues/62785/
3167 [62814]: https://github.com/rust-lang/rust/pull/62814/
3168 [62896]: https://github.com/rust-lang/rust/issues/62896/
3169 [63000]: https://github.com/rust-lang/rust/pull/63000/
3170 [63056]: https://github.com/rust-lang/rust/pull/63056/
3171 [63107]: https://github.com/rust-lang/rust/pull/63107/
3172 [63346]: https://github.com/rust-lang/rust/pull/63346/
3173 [63421]: https://github.com/rust-lang/rust/pull/63421/
3174 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
3175 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
3176 [63048]: https://github.com/rust-lang/rust/pull/63048
3177 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3178 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
3179 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
3180 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
3181 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
3182 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
3183 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
3184 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
3185 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
3186 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
3187 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
3188 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
3189 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
3190
3191 Version 1.37.0 (2019-08-15)
3192 ==========================
3193
3194 Language
3195 --------
3196 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
3197   [`Box`][62228], or an [array][62235] and unused.
3198 - [You can now use the `cfg` and `cfg_attr` attributes on
3199   generic parameters.][61547]
3200 - [You can now use enum variants through type alias.][61682] e.g. You can
3201   write the following:
3202   ```rust
3203   type MyOption = Option<u8>;
3204
3205   fn increment_or_zero(x: MyOption) -> u8 {
3206       match x {
3207           MyOption::Some(y) => y + 1,
3208           MyOption::None => 0,
3209       }
3210   }
3211   ```
3212 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
3213   `const _: u32 = 5;`.
3214 - [You can now use `#[repr(align(X)]` on enums.][61229]
3215 - [The  `?` Kleene macro operator is now available in the
3216   2015 edition.][60932]
3217
3218 Compiler
3219 --------
3220 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
3221   and `-C profile-use` flags.][61268] For more information on how to use profile
3222   guided optimization, please refer to the [rustc book][rustc-book-pgo].
3223 - [The `rust-lldb` wrapper script should now work again.][61827]
3224
3225 Libraries
3226 ---------
3227 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
3228
3229 Stabilized APIs
3230 ---------------
3231 - [`BufReader::buffer`]
3232 - [`BufWriter::buffer`]
3233 - [`Cell::from_mut`]
3234 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
3235 - [`DoubleEndedIterator::nth_back`]
3236 - [`Option::xor`]
3237 - [`Wrapping::reverse_bits`]
3238 - [`i128::reverse_bits`]
3239 - [`i16::reverse_bits`]
3240 - [`i32::reverse_bits`]
3241 - [`i64::reverse_bits`]
3242 - [`i8::reverse_bits`]
3243 - [`isize::reverse_bits`]
3244 - [`slice::copy_within`]
3245 - [`u128::reverse_bits`]
3246 - [`u16::reverse_bits`]
3247 - [`u32::reverse_bits`]
3248 - [`u64::reverse_bits`]
3249 - [`u8::reverse_bits`]
3250 - [`usize::reverse_bits`]
3251
3252 Cargo
3253 -----
3254 - [`Cargo.lock` files are now included by default when publishing executable crates
3255   with executables.][cargo/7026]
3256 - [You can now specify `default-run="foo"` in `[package]` to specify the
3257   default executable to use for `cargo run`.][cargo/7056]
3258
3259 Misc
3260 ----
3261
3262 Compatibility Notes
3263 -------------------
3264 - [Using `...` for inclusive range patterns will now warn by default.][61342]
3265   Please transition your code to using the `..=` syntax for inclusive
3266   ranges instead.
3267 - [Using a trait object without the `dyn` will now warn by default.][61203]
3268   Please transition your code to use `dyn Trait` for trait objects instead.
3269
3270 [62228]: https://github.com/rust-lang/rust/pull/62228/
3271 [62235]: https://github.com/rust-lang/rust/pull/62235/
3272 [61802]: https://github.com/rust-lang/rust/pull/61802/
3273 [61827]: https://github.com/rust-lang/rust/pull/61827/
3274 [61547]: https://github.com/rust-lang/rust/pull/61547/
3275 [61682]: https://github.com/rust-lang/rust/pull/61682/
3276 [61268]: https://github.com/rust-lang/rust/pull/61268/
3277 [61342]: https://github.com/rust-lang/rust/pull/61342/
3278 [61347]: https://github.com/rust-lang/rust/pull/61347/
3279 [61100]: https://github.com/rust-lang/rust/pull/61100/
3280 [61203]: https://github.com/rust-lang/rust/pull/61203/
3281 [61229]: https://github.com/rust-lang/rust/pull/61229/
3282 [60932]: https://github.com/rust-lang/rust/pull/60932/
3283 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
3284 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
3285 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
3286 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
3287 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
3288 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
3289 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
3290 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
3291 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
3292 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
3293 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
3294 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
3295 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
3296 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
3297 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
3298 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
3299 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
3300 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
3301 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
3302 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
3303 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
3304 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
3305 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
3306
3307
3308 Version 1.36.0 (2019-07-04)
3309 ==========================
3310
3311 Language
3312 --------
3313 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
3314 - [The order of traits in trait objects no longer affects the semantics of that
3315   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
3316   `dyn fmt::Debug + Send`, where this was previously not the case.
3317
3318 Libraries
3319 ---------
3320 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
3321 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
3322 - [`mem::needs_drop` is now available as a const fn.][60364]
3323 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
3324 - [`String` now implements `BorrowMut<str>`.][60404]
3325 - [`io::Cursor` now implements `Default`.][60234]
3326 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
3327 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
3328   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
3329   environment has access to heap memory allocation.
3330 - [`String` now implements `From<&String>`.][59825]
3331 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
3332   return a tuple of each argument when there is multiple arguments.
3333 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
3334   not used.][59648]
3335
3336 Stabilized APIs
3337 ---------------
3338 - [`VecDeque::rotate_left`]
3339 - [`VecDeque::rotate_right`]
3340 - [`Iterator::copied`]
3341 - [`io::IoSlice`]
3342 - [`io::IoSliceMut`]
3343 - [`Read::read_vectored`]
3344 - [`Write::write_vectored`]
3345 - [`str::as_mut_ptr`]
3346 - [`mem::MaybeUninit`]
3347 - [`pointer::align_offset`]
3348 - [`future::Future`]
3349 - [`task::Context`]
3350 - [`task::RawWaker`]
3351 - [`task::RawWakerVTable`]
3352 - [`task::Waker`]
3353 - [`task::Poll`]
3354
3355 Cargo
3356 -----
3357 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
3358 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
3359
3360 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
3361
3362 Clippy
3363 ------
3364 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
3365
3366 Misc
3367 ----
3368
3369 Compatibility Notes
3370 -------------------
3371 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
3372   longer recommended, and will be deprecated in 1.39.0.
3373
3374 [60318]: https://github.com/rust-lang/rust/pull/60318/
3375 [60364]: https://github.com/rust-lang/rust/pull/60364/
3376 [60370]: https://github.com/rust-lang/rust/pull/60370/
3377 [60404]: https://github.com/rust-lang/rust/pull/60404/
3378 [60234]: https://github.com/rust-lang/rust/pull/60234/
3379 [60244]: https://github.com/rust-lang/rust/pull/60244/
3380 [58623]: https://github.com/rust-lang/rust/pull/58623/
3381 [59648]: https://github.com/rust-lang/rust/pull/59648/
3382 [59675]: https://github.com/rust-lang/rust/pull/59675/
3383 [59825]: https://github.com/rust-lang/rust/pull/59825/
3384 [59826]: https://github.com/rust-lang/rust/pull/59826/
3385 [59445]: https://github.com/rust-lang/rust/pull/59445/
3386 [59114]: https://github.com/rust-lang/rust/pull/59114/
3387 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
3388 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
3389 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
3390 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
3391 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
3392 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
3393 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
3394 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
3395 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
3396 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
3397 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
3398 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
3399 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
3400 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
3401 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
3402 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
3403 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
3404 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
3405 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
3406 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
3407
3408
3409 Version 1.35.0 (2019-05-23)
3410 ==========================
3411
3412 Language
3413 --------
3414 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
3415   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
3416 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
3417   ```rust
3418   unsafe fn call_unsafe(func: unsafe fn()) {
3419       func()
3420   }
3421
3422   pub fn main() {
3423       unsafe { call_unsafe(|| {}); }
3424   }
3425   ```
3426
3427
3428 Compiler
3429 --------
3430 - [Added the `armv6-unknown-freebsd-gnueabihf` and
3431   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
3432 - [Added the `wasm32-unknown-wasi` target.][59464]
3433
3434
3435 Libraries
3436 ---------
3437 - [`Thread` will now show its ID in `Debug` output.][59460]
3438 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
3439 - [`alloc::System` now implements `Default`.][59451]
3440 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
3441   last field.][59076]
3442 - [`char::{ToLowercase, ToUppercase}` now
3443   implement `ExactSizeIterator`.][58778]
3444 - [All `NonZero` numeric types now implement `FromStr`.][58717]
3445 - [Removed the `Read` trait bounds
3446   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
3447 - [You can now call the `dbg!` macro without any parameters to print the file
3448   and line where it is called.][57847]
3449 - [In place ASCII case conversions are now up to 4× faster.][59283]
3450   e.g. `str::make_ascii_lowercase`
3451 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
3452   and `Send`.][58369]
3453
3454 Stabilized APIs
3455 ---------------
3456 - [`f32::copysign`]
3457 - [`f64::copysign`]
3458 - [`RefCell::replace_with`]
3459 - [`RefCell::map_split`]
3460 - [`ptr::hash`]
3461 - [`Range::contains`]
3462 - [`RangeFrom::contains`]
3463 - [`RangeTo::contains`]
3464 - [`RangeInclusive::contains`]
3465 - [`RangeToInclusive::contains`]
3466 - [`Option::copied`]
3467
3468 Cargo
3469 -----
3470 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
3471   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
3472   platform specific.
3473
3474 Misc
3475 ----
3476 - [The Rust toolchain is now available natively for musl based distros.][58575]
3477
3478 [59460]: https://github.com/rust-lang/rust/pull/59460/
3479 [59464]: https://github.com/rust-lang/rust/pull/59464/
3480 [59500]: https://github.com/rust-lang/rust/pull/59500/
3481 [59512]: https://github.com/rust-lang/rust/pull/59512/
3482 [59580]: https://github.com/rust-lang/rust/pull/59580/
3483 [59283]: https://github.com/rust-lang/rust/pull/59283/
3484 [59451]: https://github.com/rust-lang/rust/pull/59451/
3485 [59076]: https://github.com/rust-lang/rust/pull/59076/
3486 [58778]: https://github.com/rust-lang/rust/pull/58778/
3487 [58717]: https://github.com/rust-lang/rust/pull/58717/
3488 [58369]: https://github.com/rust-lang/rust/pull/58369/
3489 [58423]: https://github.com/rust-lang/rust/pull/58423/
3490 [58080]: https://github.com/rust-lang/rust/pull/58080/
3491 [57847]: https://github.com/rust-lang/rust/pull/57847/
3492 [58575]: https://github.com/rust-lang/rust/pull/58575
3493 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
3494 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
3495 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
3496 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
3497 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
3498 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
3499 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
3500 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
3501 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
3502 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
3503 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
3504 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
3505
3506 Version 1.34.2 (2019-05-14)
3507 ===========================
3508
3509 * [Destabilize the `Error::type_id` function due to a security
3510    vulnerability][60785] ([CVE-2019-12083])
3511
3512 [60785]: https://github.com/rust-lang/rust/pull/60785
3513 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
3514
3515 Version 1.34.1 (2019-04-25)
3516 ===========================
3517
3518 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
3519 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
3520 * [Fix Clippy panic when checking some macros][clippy/3805]
3521
3522 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
3523 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
3524 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
3525
3526 Version 1.34.0 (2019-04-11)
3527 ==========================
3528
3529 Language
3530 --------
3531 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
3532   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
3533   but had no effect.
3534 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
3535   `#[attr{}]` procedural macros.][57367]
3536 - [You can now write `extern crate self as foo;`][57407] to import your
3537   crate's root into the extern prelude.
3538
3539
3540 Compiler
3541 --------
3542 - [You can now target `riscv64imac-unknown-none-elf` and
3543   `riscv64gc-unknown-none-elf`.][58406]
3544 - [You can now enable linker plugin LTO optimisations with
3545   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
3546   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
3547   boundaries.
3548 - [You can now target `powerpc64-unknown-freebsd`.][57809]
3549
3550
3551 Libraries
3552 ---------
3553 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
3554   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
3555   the `Hash` trait to create an iterator.
3556 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
3557   methods.][58421] Most notably you no longer require the `Ord` trait to create
3558   an iterator.
3559 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
3560   for all numeric types.][58044]
3561 - [Indexing a `str` is now generic over all types that
3562   implement `SliceIndex<str>`.][57604]
3563 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
3564   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
3565   produce a warning if their returning type is unused.
3566 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
3567   `overflowing_pow` are now available for all numeric types.][57873] These are
3568   equivalent to methods such as `wrapping_add` for the `pow` operation.
3569
3570
3571 Stabilized APIs
3572 ---------------
3573
3574 #### std & core
3575 * [`Any::type_id`]
3576 * [`Error::type_id`]
3577 * [`atomic::AtomicI16`]
3578 * [`atomic::AtomicI32`]
3579 * [`atomic::AtomicI64`]
3580 * [`atomic::AtomicI8`]
3581 * [`atomic::AtomicU16`]
3582 * [`atomic::AtomicU32`]
3583 * [`atomic::AtomicU64`]
3584 * [`atomic::AtomicU8`]
3585 * [`convert::Infallible`]
3586 * [`convert::TryFrom`]
3587 * [`convert::TryInto`]
3588 * [`iter::from_fn`]
3589 * [`iter::successors`]
3590 * [`num::NonZeroI128`]
3591 * [`num::NonZeroI16`]
3592 * [`num::NonZeroI32`]
3593 * [`num::NonZeroI64`]
3594 * [`num::NonZeroI8`]
3595 * [`num::NonZeroIsize`]
3596 * [`slice::sort_by_cached_key`]
3597 * [`str::escape_debug`]
3598 * [`str::escape_default`]
3599 * [`str::escape_unicode`]
3600 * [`str::split_ascii_whitespace`]
3601
3602 #### std
3603 * [`Instant::checked_add`]
3604 * [`Instant::checked_sub`]
3605 * [`SystemTime::checked_add`]
3606 * [`SystemTime::checked_sub`]
3607
3608 Cargo
3609 -----
3610 - [You can now use alternative registries to crates.io.][cargo/6654]
3611
3612 Misc
3613 ----
3614 - [You can now use the `?` operator in your documentation tests without manually
3615   adding `fn main() -> Result<(), _> {}`.][56470]
3616
3617 Compatibility Notes
3618 -------------------
3619 - [`Command::before_exec` is being replaced by the unsafe method
3620   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3621 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3622   can now use `const` functions in `static` variables.
3623
3624 [58370]: https://github.com/rust-lang/rust/pull/58370/
3625 [58406]: https://github.com/rust-lang/rust/pull/58406/
3626 [58421]: https://github.com/rust-lang/rust/pull/58421/
3627 [58166]: https://github.com/rust-lang/rust/pull/58166/
3628 [58044]: https://github.com/rust-lang/rust/pull/58044/
3629 [58057]: https://github.com/rust-lang/rust/pull/58057/
3630 [58059]: https://github.com/rust-lang/rust/pull/58059/
3631 [57809]: https://github.com/rust-lang/rust/pull/57809/
3632 [57873]: https://github.com/rust-lang/rust/pull/57873/
3633 [57604]: https://github.com/rust-lang/rust/pull/57604/
3634 [57367]: https://github.com/rust-lang/rust/pull/57367/
3635 [57407]: https://github.com/rust-lang/rust/pull/57407/
3636 [57425]: https://github.com/rust-lang/rust/pull/57425/
3637 [57106]: https://github.com/rust-lang/rust/pull/57106/
3638 [56470]: https://github.com/rust-lang/rust/pull/56470/
3639 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3640 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3641 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3642 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3643 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3644 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3645 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3646 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3647 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3648 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3649 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3650 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3651 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3652 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3653 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3654 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3655 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3656 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3657 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3658 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3659 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3660 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3661 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3662 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3663 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3664 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3665 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3666 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3667 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3668 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3669 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3670
3671
3672 Version 1.33.0 (2019-02-28)
3673 ==========================
3674
3675 Language
3676 --------
3677 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3678   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3679 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3680   E.g. You can have match statement on a `u8` that covers `0..=255` and
3681   you would no longer be required to have a `_ => unreachable!()` case.
3682 - [You can now have multiple patterns in `if let` and `while let`
3683   expressions.][57532] You can do this with the same syntax as a `match`
3684   expression. E.g.
3685   ```rust
3686   enum Creature {
3687       Crab(String),
3688       Lobster(String),
3689       Person(String),
3690   }
3691
3692   fn main() {
3693       let state = Creature::Crab("Ferris");
3694
3695       if let Creature::Crab(name) | Creature::Person(name) = state {
3696           println!("This creature's name is: {}", name);
3697       }
3698   }
3699   ```
3700 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3701   this feature will by default produce a warning as this behaviour can be
3702   unintuitive. E.g. `if let _ = 5 {}`
3703 - [You can now use `let` bindings, assignments, expression statements,
3704   and irrefutable pattern destructuring in const functions.][57175]
3705 - [You can now call unsafe const functions.][57067] E.g.
3706   ```rust
3707   const unsafe fn foo() -> i32 { 5 }
3708   const fn bar() -> i32 {
3709       unsafe { foo() }
3710   }
3711   ```
3712 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3713   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3714 - [You can now specify a specific alignment with the `#[repr(packed)]`
3715   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3716   with an alignment of 2 bytes and a size of 6 bytes.
3717 - [You can now import an item from a module as an `_`.][56303] This allows you to
3718   import a trait's impls, and not have the name in the namespace. E.g.
3719   ```rust
3720   use std::io::Read as _;
3721
3722   // Allowed as there is only one `Read` in the module.
3723   pub trait Read {}
3724   ```
3725 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3726
3727 Compiler
3728 --------
3729 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3730   command line argument.][56351]
3731 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3732 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3733 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3734   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3735   information on Rust's platform support.
3736 - [Added support for the `thumbv7neon-linux-androideabi` and
3737   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3738 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3739
3740 Libraries
3741 ---------
3742 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3743   functions for all numeric types.][57566]
3744 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3745   are now `const` functions for all numeric types.][57105]
3746 - [The methods `is_positive` and `is_negative` are now `const` functions for
3747   all signed numeric types.][57105]
3748 - [The `get` method for all `NonZero` types is now `const`.][57167]
3749 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3750   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3751   numeric types.][57234]
3752 - [`Ipv4Addr::new` is now a `const` function][57234]
3753
3754 Stabilized APIs
3755 ---------------
3756 - [`unix::FileExt::read_exact_at`]
3757 - [`unix::FileExt::write_all_at`]
3758 - [`Option::transpose`]
3759 - [`Result::transpose`]
3760 - [`convert::identity`]
3761 - [`pin::Pin`]
3762 - [`marker::Unpin`]
3763 - [`marker::PhantomPinned`]
3764 - [`Vec::resize_with`]
3765 - [`VecDeque::resize_with`]
3766 - [`Duration::as_millis`]
3767 - [`Duration::as_micros`]
3768 - [`Duration::as_nanos`]
3769
3770
3771 Cargo
3772 -----
3773 - [You can now publish crates that require a feature flag to compile with
3774   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3775 - [Cargo should now rebuild a crate if a file was modified during the initial
3776   build.][cargo/6484]
3777
3778 Compatibility Notes
3779 -------------------
3780 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3781   are now deprecated in the standard library, and their usage will now produce a warning.
3782   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3783   methods instead.
3784 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3785   downcasting.
3786 - [Libtest no longer creates a new thread for each test when
3787   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3788
3789 [56243]: https://github.com/rust-lang/rust/pull/56243
3790 [56303]: https://github.com/rust-lang/rust/pull/56303/
3791 [56351]: https://github.com/rust-lang/rust/pull/56351/
3792 [56362]: https://github.com/rust-lang/rust/pull/56362
3793 [56642]: https://github.com/rust-lang/rust/pull/56642/
3794 [56769]: https://github.com/rust-lang/rust/pull/56769/
3795 [56805]: https://github.com/rust-lang/rust/pull/56805
3796 [56947]: https://github.com/rust-lang/rust/pull/56947/
3797 [57049]: https://github.com/rust-lang/rust/pull/57049/
3798 [57067]: https://github.com/rust-lang/rust/pull/57067/
3799 [57105]: https://github.com/rust-lang/rust/pull/57105
3800 [57130]: https://github.com/rust-lang/rust/pull/57130/
3801 [57167]: https://github.com/rust-lang/rust/pull/57167/
3802 [57175]: https://github.com/rust-lang/rust/pull/57175/
3803 [57234]: https://github.com/rust-lang/rust/pull/57234/
3804 [57332]: https://github.com/rust-lang/rust/pull/57332/
3805 [57465]: https://github.com/rust-lang/rust/pull/57465/
3806 [57532]: https://github.com/rust-lang/rust/pull/57532/
3807 [57535]: https://github.com/rust-lang/rust/pull/57535/
3808 [57566]: https://github.com/rust-lang/rust/pull/57566/
3809 [57615]: https://github.com/rust-lang/rust/pull/57615/
3810 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3811 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3812 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3813 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3814 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3815 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3816 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3817 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3818 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3819 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3820 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3821 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3822 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3823 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3824 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3825 [platform-support]: https://forge.rust-lang.org/platform-support.html
3826
3827 Version 1.32.0 (2019-01-17)
3828 ==========================
3829
3830 Language
3831 --------
3832 #### 2018 edition
3833 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3834   operator allows you to specify zero or one repetitions similar to the `*` and
3835   `+` operators.
3836 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3837   now always resolve to the item (`enum`, `struct`, etc.) available in the
3838   module if present, before resolving to a external crate or an item the prelude.][56759]
3839   E.g.
3840   ```rust
3841   enum Color { Red, Green, Blue }
3842
3843   use Color::*;
3844   ```
3845
3846 #### All editions
3847 - [You can now match against `PhantomData<T>` types.][55837]
3848 - [You can now match against literals in macros with the `literal`
3849   specifier.][56072] This will match against a literal of any type.
3850   E.g. `1`, `'A'`, `"Hello World"`
3851 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3852   ```rust
3853   struct Point(i32, i32);
3854
3855   impl Point {
3856       pub fn new(x: i32, y: i32) -> Self {
3857           Self(x, y)
3858       }
3859
3860       pub fn is_origin(&self) -> bool {
3861           match self {
3862               Self(0, 0) => true,
3863               _ => false,
3864           }
3865       }
3866   }
3867   ```
3868 - [Self can also now be used in type definitions.][56366] E.g.
3869   ```rust
3870   enum List<T>
3871   where
3872       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3873   {
3874       Nil,
3875       Cons(T, Box<Self>) // likewise here
3876   }
3877   ```
3878 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3879   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3880
3881 Compiler
3882 --------
3883 - [The default allocator has changed from jemalloc to the default allocator on
3884   your system.][55238] The compiler itself on Linux & macOS will still use
3885   jemalloc, but programs compiled with it will use the system allocator.
3886 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3887
3888 Libraries
3889 ---------
3890 - [`PathBuf` now implements `FromStr`.][55148]
3891 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3892 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3893   easily debug expressions in your rust program. E.g.
3894   ```rust
3895   let a = 2;
3896   let b = dbg!(a * 2) + 1;
3897   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3898   assert_eq!(b, 5);
3899   ```
3900
3901 The following APIs are now `const` functions and can be used in a
3902 `const` context.
3903
3904 - [`Cell::as_ptr`]
3905 - [`UnsafeCell::get`]
3906 - [`char::is_ascii`]
3907 - [`iter::empty`]
3908 - [`ManuallyDrop::new`]
3909 - [`ManuallyDrop::into_inner`]
3910 - [`RangeInclusive::start`]
3911 - [`RangeInclusive::end`]
3912 - [`NonNull::as_ptr`]
3913 - [`slice::as_ptr`]
3914 - [`str::as_ptr`]
3915 - [`Duration::as_secs`]
3916 - [`Duration::subsec_millis`]
3917 - [`Duration::subsec_micros`]
3918 - [`Duration::subsec_nanos`]
3919 - [`CStr::as_ptr`]
3920 - [`Ipv4Addr::is_unspecified`]
3921 - [`Ipv6Addr::new`]
3922 - [`Ipv6Addr::octets`]
3923
3924 Stabilized APIs
3925 ---------------
3926 - [`i8::to_be_bytes`]
3927 - [`i8::to_le_bytes`]
3928 - [`i8::to_ne_bytes`]
3929 - [`i8::from_be_bytes`]
3930 - [`i8::from_le_bytes`]
3931 - [`i8::from_ne_bytes`]
3932 - [`i16::to_be_bytes`]
3933 - [`i16::to_le_bytes`]
3934 - [`i16::to_ne_bytes`]
3935 - [`i16::from_be_bytes`]
3936 - [`i16::from_le_bytes`]
3937 - [`i16::from_ne_bytes`]
3938 - [`i32::to_be_bytes`]
3939 - [`i32::to_le_bytes`]
3940 - [`i32::to_ne_bytes`]
3941 - [`i32::from_be_bytes`]
3942 - [`i32::from_le_bytes`]
3943 - [`i32::from_ne_bytes`]
3944 - [`i64::to_be_bytes`]
3945 - [`i64::to_le_bytes`]
3946 - [`i64::to_ne_bytes`]
3947 - [`i64::from_be_bytes`]
3948 - [`i64::from_le_bytes`]
3949 - [`i64::from_ne_bytes`]
3950 - [`i128::to_be_bytes`]
3951 - [`i128::to_le_bytes`]
3952 - [`i128::to_ne_bytes`]
3953 - [`i128::from_be_bytes`]
3954 - [`i128::from_le_bytes`]
3955 - [`i128::from_ne_bytes`]
3956 - [`isize::to_be_bytes`]
3957 - [`isize::to_le_bytes`]
3958 - [`isize::to_ne_bytes`]
3959 - [`isize::from_be_bytes`]
3960 - [`isize::from_le_bytes`]
3961 - [`isize::from_ne_bytes`]
3962 - [`u8::to_be_bytes`]
3963 - [`u8::to_le_bytes`]
3964 - [`u8::to_ne_bytes`]
3965 - [`u8::from_be_bytes`]
3966 - [`u8::from_le_bytes`]
3967 - [`u8::from_ne_bytes`]
3968 - [`u16::to_be_bytes`]
3969 - [`u16::to_le_bytes`]
3970 - [`u16::to_ne_bytes`]
3971 - [`u16::from_be_bytes`]
3972 - [`u16::from_le_bytes`]
3973 - [`u16::from_ne_bytes`]
3974 - [`u32::to_be_bytes`]
3975 - [`u32::to_le_bytes`]
3976 - [`u32::to_ne_bytes`]
3977 - [`u32::from_be_bytes`]
3978 - [`u32::from_le_bytes`]
3979 - [`u32::from_ne_bytes`]
3980 - [`u64::to_be_bytes`]
3981 - [`u64::to_le_bytes`]
3982 - [`u64::to_ne_bytes`]
3983 - [`u64::from_be_bytes`]
3984 - [`u64::from_le_bytes`]
3985 - [`u64::from_ne_bytes`]
3986 - [`u128::to_be_bytes`]
3987 - [`u128::to_le_bytes`]
3988 - [`u128::to_ne_bytes`]
3989 - [`u128::from_be_bytes`]
3990 - [`u128::from_le_bytes`]
3991 - [`u128::from_ne_bytes`]
3992 - [`usize::to_be_bytes`]
3993 - [`usize::to_le_bytes`]
3994 - [`usize::to_ne_bytes`]
3995 - [`usize::from_be_bytes`]
3996 - [`usize::from_le_bytes`]
3997 - [`usize::from_ne_bytes`]
3998
3999 Cargo
4000 -----
4001 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
4002 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
4003
4004 Misc
4005 ----
4006 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
4007
4008 Compatibility Notes
4009 -------------------
4010 - [The argument types for AVX's
4011   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
4012   been changed from `*const` to `*mut` as the previous implementation
4013   was unsound.
4014
4015
4016 [55148]: https://github.com/rust-lang/rust/pull/55148/
4017 [55238]: https://github.com/rust-lang/rust/pull/55238/
4018 [55280]: https://github.com/rust-lang/rust/pull/55280/
4019 [55610]: https://github.com/rust-lang/rust/pull/55610/
4020 [55663]: https://github.com/rust-lang/rust/pull/55663/
4021 [55702]: https://github.com/rust-lang/rust/pull/55702/
4022 [55837]: https://github.com/rust-lang/rust/pull/55837/
4023 [55843]: https://github.com/rust-lang/rust/pull/55843/
4024 [56072]: https://github.com/rust-lang/rust/pull/56072/
4025 [56245]: https://github.com/rust-lang/rust/pull/56245/
4026 [56365]: https://github.com/rust-lang/rust/pull/56365/
4027 [56366]: https://github.com/rust-lang/rust/pull/56366/
4028 [56395]: https://github.com/rust-lang/rust/pull/56395/
4029 [56759]: https://github.com/rust-lang/rust/pull/56759/
4030 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
4031 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
4032 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
4033 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
4034 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
4035 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4036 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4037 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
4038 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
4039 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
4040 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
4041 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
4042 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
4043 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
4044 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
4045 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
4046 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
4047 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
4048 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
4049 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
4050 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
4051 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
4052 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
4053 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
4054 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
4055 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
4056 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
4057 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
4058 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
4059 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
4060 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
4061 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
4062 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
4063 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
4064 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
4065 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
4066 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
4067 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
4068 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
4069 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
4070 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
4071 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
4072 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
4073 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
4074 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
4075 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
4076 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
4077 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
4078 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
4079 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
4080 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
4081 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
4082 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
4083 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
4084 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
4085 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
4086 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
4087 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
4088 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
4089 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
4090 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
4091 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
4092 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
4093 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
4094 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
4095 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
4096 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
4097 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
4098 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
4099 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
4100 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
4101 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
4102 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
4103 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
4104 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
4105 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
4106 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
4107 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
4108 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
4109 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
4110 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
4111 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
4112 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
4113 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
4114 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
4115 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
4116 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
4117 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
4118 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
4119 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
4120 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
4121 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
4122 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
4123
4124
4125 Version 1.31.1 (2018-12-20)
4126 ===========================
4127
4128 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
4129 - [Fix broken go-to-definition in RLS][rls/1171]
4130 - [Fix infinite loop on hover in RLS][rls/1170]
4131
4132 [56562]: https://github.com/rust-lang/rust/pull/56562
4133 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
4134 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
4135
4136 Version 1.31.0 (2018-12-06)
4137 ==========================
4138
4139 Language
4140 --------
4141 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
4142 - [New lifetime elision rules now allow for eliding lifetimes in functions and
4143   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
4144   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
4145   in structs.
4146 - [You can now define and use `const` functions.][54835] These are currently
4147   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
4148   [language reference][const-reference] for what exactly is available.
4149 - [You can now use tool lints, which allow you to scope lints from external
4150   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
4151 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
4152   a crate, not just in exported functions.][54451]
4153 - [You can now use parentheses in pattern matches.][54497]
4154
4155 Compiler
4156 --------
4157 - [Updated musl to 1.1.20][54430]
4158
4159 Libraries
4160 ---------
4161 - [You can now convert `num::NonZero*` types to their raw equivalents using the
4162   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
4163 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
4164   into `Option<&mut T>` using the `From` trait.][53218]
4165 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
4166
4167
4168 Stabilized APIs
4169 ---------------
4170 - [`slice::align_to`]
4171 - [`slice::align_to_mut`]
4172 - [`slice::chunks_exact`]
4173 - [`slice::chunks_exact_mut`]
4174 - [`slice::rchunks`]
4175 - [`slice::rchunks_mut`]
4176 - [`slice::rchunks_exact`]
4177 - [`slice::rchunks_exact_mut`]
4178 - [`Option::replace`]
4179
4180 Cargo
4181 -----
4182 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
4183 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
4184   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
4185
4186 [52813]: https://github.com/rust-lang/rust/pull/52813/
4187 [53218]: https://github.com/rust-lang/rust/pull/53218/
4188 [54057]: https://github.com/rust-lang/rust/pull/54057/
4189 [54240]: https://github.com/rust-lang/rust/pull/54240/
4190 [54430]: https://github.com/rust-lang/rust/pull/54430/
4191 [54451]: https://github.com/rust-lang/rust/pull/54451/
4192 [54497]: https://github.com/rust-lang/rust/pull/54497/
4193 [54778]: https://github.com/rust-lang/rust/pull/54778/
4194 [54835]: https://github.com/rust-lang/rust/pull/54835/
4195 [54870]: https://github.com/rust-lang/rust/pull/54870/
4196 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
4197 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
4198 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
4199 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
4200 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
4201 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
4202 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4203 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
4204 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
4205 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
4206 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
4207 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
4208 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
4209 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
4210
4211 Version 1.30.1 (2018-11-08)
4212 ===========================
4213
4214 - [Fixed overflow ICE in rustdoc][54199]
4215 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
4216
4217 [54199]: https://github.com/rust-lang/rust/pull/54199
4218 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
4219
4220 Version 1.30.0 (2018-10-25)
4221 ==========================
4222
4223 Language
4224 --------
4225 - [Procedural macros are now available.][52081] These kinds of macros allow for
4226   more powerful code generation. There is a [new chapter available][proc-macros]
4227   in the Rust Programming Language book that goes further in depth.
4228 - [You can now use keywords as identifiers using the raw identifiers
4229   syntax (`r#`),][53236] e.g. `let r#for = true;`
4230 - [Using anonymous parameters in traits is now deprecated with a warning and
4231   will be a hard error in the 2018 edition.][53272]
4232 - [You can now use `crate` in paths.][54404] This allows you to refer to the
4233   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
4234 - [Using a external crate no longer requires being prefixed with `::`.][54404]
4235   Previously, using a external crate in a module without a use statement
4236   required `let json = ::serde_json::from_str(foo);` but can now be written
4237   as `let json = serde_json::from_str(foo);`.
4238 - [You can now apply the `#[used]` attribute to static items to prevent the
4239   compiler from optimising them away, even if they appear to be unused,][51363]
4240   e.g. `#[used] static FOO: u32 = 1;`
4241 - [You can now import and reexport macros from other crates with the `use`
4242   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
4243   the root module of the crate. If your macro relies on calling other local
4244   macros, it is recommended to export with the
4245   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
4246   those macros.
4247 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
4248   using the `vis` specifier.][53370]
4249 - [Non-macro attributes now allow all forms of literals, not just
4250   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
4251   write `#[attr(true)]`.
4252 - [You can now specify a function to handle a panic in the Rust runtime with the
4253   `#[panic_handler]` attribute.][51366]
4254
4255 Compiler
4256 --------
4257 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
4258 - [Added the `aarch64-unknown-netbsd` target][53165]
4259 - [Upgraded to LLVM 8.][53611]
4260
4261 Libraries
4262 ---------
4263 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
4264
4265 Stabilized APIs
4266 ---------------
4267 - [`Ipv4Addr::BROADCAST`]
4268 - [`Ipv4Addr::LOCALHOST`]
4269 - [`Ipv4Addr::UNSPECIFIED`]
4270 - [`Ipv6Addr::LOCALHOST`]
4271 - [`Ipv6Addr::UNSPECIFIED`]
4272 - [`Iterator::find_map`]
4273
4274   The following methods are replacement methods for `trim_left`, `trim_right`,
4275   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
4276   in 1.33.0:
4277 - [`str::trim_end_matches`]
4278 - [`str::trim_end`]
4279 - [`str::trim_start_matches`]
4280 - [`str::trim_start`]
4281
4282 Cargo
4283 ----
4284 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
4285 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
4286   equivalent to calling `rustdoc --error-format=json`.
4287 - [Cargo will now provide a progress bar for builds.][cargo/5995]
4288
4289 Misc
4290 ----
4291 - [`rustdoc` allows you to specify what edition to treat your code as with the
4292   `--edition` option.][54057]
4293 - [`rustdoc` now has the `--color` (specify whether to output color) and
4294   `--error-format` (specify error format, e.g. `json`) options.][53003]
4295 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
4296   debug symbols.][53774]
4297 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
4298   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
4299
4300 [50911]: https://github.com/rust-lang/rust/pull/50911/
4301 [51363]: https://github.com/rust-lang/rust/pull/51363/
4302 [51366]: https://github.com/rust-lang/rust/pull/51366/
4303 [52081]: https://github.com/rust-lang/rust/pull/52081/
4304 [53003]: https://github.com/rust-lang/rust/pull/53003/
4305 [53033]: https://github.com/rust-lang/rust/pull/53033/
4306 [53044]: https://github.com/rust-lang/rust/pull/53044/
4307 [53165]: https://github.com/rust-lang/rust/pull/53165/
4308 [53611]: https://github.com/rust-lang/rust/pull/53611/
4309 [53236]: https://github.com/rust-lang/rust/pull/53236/
4310 [53272]: https://github.com/rust-lang/rust/pull/53272/
4311 [53370]: https://github.com/rust-lang/rust/pull/53370/
4312 [53459]: https://github.com/rust-lang/rust/pull/53459/
4313 [53774]: https://github.com/rust-lang/rust/pull/53774/
4314 [53822]: https://github.com/rust-lang/rust/pull/53822/
4315 [54057]: https://github.com/rust-lang/rust/pull/54057/
4316 [54404]: https://github.com/rust-lang/rust/pull/54404/
4317 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
4318 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
4319 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
4320 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
4321
4322 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
4323 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
4324 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
4325 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
4326 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
4327 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
4328 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
4329 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
4330 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
4331 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
4332
4333
4334 Version 1.29.2 (2018-10-11)
4335 ===========================
4336
4337 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
4338 - The `rls-preview` component on the windows-gnu targets has been restored.
4339
4340 [54639]: https://github.com/rust-lang/rust/pull/54639
4341
4342
4343 Version 1.29.1 (2018-09-25)
4344 ===========================
4345
4346 Security Notes
4347 --------------
4348
4349 - The standard library's `str::repeat` function contained an out of bounds write
4350   caused by an integer overflow. This has been fixed by deterministically
4351   panicking when an overflow happens.
4352
4353   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
4354   us.
4355
4356
4357 Version 1.29.0 (2018-09-13)
4358 ==========================
4359
4360 Compiler
4361 --------
4362 - [Bumped minimum LLVM version to 5.0.][51899]
4363 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
4364 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
4365 - [Upgraded to LLVM 7.][51966]
4366
4367 Libraries
4368 ---------
4369 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
4370 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
4371 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
4372 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
4373   for `&str`.][51178]
4374 - [`Cell<T>` now allows `T` to be unsized.][50494]
4375 - [`SocketAddr` is now stable on Redox.][52656]
4376
4377 Stabilized APIs
4378 ---------------
4379 - [`Arc::downcast`]
4380 - [`Iterator::flatten`]
4381 - [`Rc::downcast`]
4382
4383 Cargo
4384 -----
4385 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
4386   `--locked` to disable this behavior.
4387 - [`cargo-install` will now allow you to cross compile an install
4388   using `--target`.][cargo/5614]
4389 - [Added the `cargo-fix` subcommand to automatically move project code from
4390   2015 edition to 2018.][cargo/5723]
4391 - [`cargo doc` can now optionally document private types using the
4392   `--document-private-items` flag.][cargo/5543]
4393
4394 Misc
4395 ----
4396 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
4397   the specified level to that level.][52354] For example `--cap-lints warn`
4398   will demote `deny` and `forbid` lints to `warn`.
4399 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
4400   fails and `101` if there is a panic.][52197]
4401 - [A preview of clippy has been made available through rustup.][51122]
4402   You can install the preview with `rustup component add clippy-preview`.
4403
4404 Compatibility Notes
4405 -------------------
4406 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
4407   Use `str::get_unchecked(begin..end)` instead.
4408 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
4409   Consider using the `home_dir` function from
4410   https://crates.io/crates/dirs instead.
4411 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
4412 - [`cfg` attributes and `--cfg` command line flags are now more
4413   strictly validated.][53893]
4414
4415 [53893]: https://github.com/rust-lang/rust/pull/53893/
4416 [52861]: https://github.com/rust-lang/rust/pull/52861/
4417 [51966]: https://github.com/rust-lang/rust/pull/51966/
4418 [52656]: https://github.com/rust-lang/rust/pull/52656/
4419 [52239]: https://github.com/rust-lang/rust/pull/52239/
4420 [52330]: https://github.com/rust-lang/rust/pull/52330/
4421 [52354]: https://github.com/rust-lang/rust/pull/52354/
4422 [52402]: https://github.com/rust-lang/rust/pull/52402/
4423 [52197]: https://github.com/rust-lang/rust/pull/52197/
4424 [51807]: https://github.com/rust-lang/rust/pull/51807/
4425 [51899]: https://github.com/rust-lang/rust/pull/51899/
4426 [51912]: https://github.com/rust-lang/rust/pull/51912/
4427 [51619]: https://github.com/rust-lang/rust/pull/51619/
4428 [51656]: https://github.com/rust-lang/rust/pull/51656/
4429 [51178]: https://github.com/rust-lang/rust/pull/51178/
4430 [51122]: https://github.com/rust-lang/rust/pull/51122
4431 [50494]: https://github.com/rust-lang/rust/pull/50494/
4432 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
4433 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
4434 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
4435 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
4436 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
4437 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
4438 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
4439
4440
4441 Version 1.28.0 (2018-08-02)
4442 ===========================
4443
4444 Language
4445 --------
4446 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
4447   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
4448   the inner type across Foreign Function Interface (FFI) boundaries.
4449 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
4450   and can now be used as identifiers.][51196]
4451 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
4452   stable.][51241] This will allow users to specify a global allocator for
4453   their program.
4454 - [Unit test functions marked with the `#[test]` attribute can now return
4455   `Result<(), E: Debug>` in addition to `()`.][51298]
4456 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
4457   allows macros to easily target lifetimes.
4458
4459 Compiler
4460 --------
4461 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
4462   prioritise making smaller binary sizes. `z` is the same as `s` with the
4463   exception that it does not vectorise loops, which typically results in an even
4464   smaller binary.
4465 - [The short error format is now stable.][49546] Specified with
4466   `--error-format=short` this option will provide a more compressed output of
4467   rust error messages.
4468 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
4469 - [Reduced the number of allocations in the macro parser.][50855] This can
4470   improve compile times of macro heavy crates on average by 5%.
4471
4472 Libraries
4473 ---------
4474 - [Implemented `Default` for `&mut str`.][51306]
4475 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
4476 - [Implemented `Extend` for `()`.][50234]
4477 - [The `Debug` implementation of `time::Duration` should now be more easily
4478   human readable.][50364] Previously a `Duration` of one second would printed as
4479   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
4480 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
4481   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
4482   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
4483   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
4484   for `PathBuf`.][50170]
4485 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
4486   and `Wrapping<i128>`.][50465]
4487 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
4488   possible.][51050] This can provide up to a 40% speed increase.
4489 - [Improved error messages when using `format!`.][50610]
4490
4491 Stabilized APIs
4492 ---------------
4493 - [`Iterator::step_by`]
4494 - [`Path::ancestors`]
4495 - [`SystemTime::UNIX_EPOCH`]
4496 - [`alloc::GlobalAlloc`]
4497 - [`alloc::Layout`]
4498 - [`alloc::LayoutErr`]
4499 - [`alloc::System`]
4500 - [`alloc::alloc`]
4501 - [`alloc::alloc_zeroed`]
4502 - [`alloc::dealloc`]
4503 - [`alloc::realloc`]
4504 - [`alloc::handle_alloc_error`]
4505 - [`btree_map::Entry::or_default`]
4506 - [`fmt::Alignment`]
4507 - [`hash_map::Entry::or_default`]
4508 - [`iter::repeat_with`]
4509 - [`num::NonZeroUsize`]
4510 - [`num::NonZeroU128`]
4511 - [`num::NonZeroU16`]
4512 - [`num::NonZeroU32`]
4513 - [`num::NonZeroU64`]
4514 - [`num::NonZeroU8`]
4515 - [`ops::RangeBounds`]
4516 - [`slice::SliceIndex`]
4517 - [`slice::from_mut`]
4518 - [`slice::from_ref`]
4519 - [`{Any + Send + Sync}::downcast_mut`]
4520 - [`{Any + Send + Sync}::downcast_ref`]
4521 - [`{Any + Send + Sync}::is`]
4522
4523 Cargo
4524 -----
4525 - [Cargo will now no longer allow you to publish crates with build scripts that
4526   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
4527   considered to be immutable.
4528
4529 Misc
4530 ----
4531 - [The `suggestion_applicability` field in `rustc`'s json output is now
4532   stable.][50486] This will allow dev tools to check whether a code suggestion
4533   would apply to them.
4534
4535 Compatibility Notes
4536 -------------------
4537 - [Rust will consider trait objects with duplicated constraints to be the same
4538   type as without the duplicated constraint.][51276] For example the below code will
4539   now fail to compile.
4540   ```rust
4541   trait Trait {}
4542
4543   impl Trait + Send {
4544       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
4545   }
4546
4547   impl Trait + Send + Send {
4548       fn test(&self) { println!("two"); }
4549   }
4550   ```
4551
4552 [49546]: https://github.com/rust-lang/rust/pull/49546/
4553 [50143]: https://github.com/rust-lang/rust/pull/50143/
4554 [50170]: https://github.com/rust-lang/rust/pull/50170/
4555 [50234]: https://github.com/rust-lang/rust/pull/50234/
4556 [50265]: https://github.com/rust-lang/rust/pull/50265/
4557 [50364]: https://github.com/rust-lang/rust/pull/50364/
4558 [50385]: https://github.com/rust-lang/rust/pull/50385/
4559 [50465]: https://github.com/rust-lang/rust/pull/50465/
4560 [50486]: https://github.com/rust-lang/rust/pull/50486/
4561 [50554]: https://github.com/rust-lang/rust/pull/50554/
4562 [50610]: https://github.com/rust-lang/rust/pull/50610/
4563 [50855]: https://github.com/rust-lang/rust/pull/50855/
4564 [51050]: https://github.com/rust-lang/rust/pull/51050/
4565 [51196]: https://github.com/rust-lang/rust/pull/51196/
4566 [51241]: https://github.com/rust-lang/rust/pull/51241/
4567 [51276]: https://github.com/rust-lang/rust/pull/51276/
4568 [51298]: https://github.com/rust-lang/rust/pull/51298/
4569 [51306]: https://github.com/rust-lang/rust/pull/51306/
4570 [51562]: https://github.com/rust-lang/rust/pull/51562/
4571 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
4572 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
4573 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
4574 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
4575 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
4576 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
4577 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4578 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4579 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4580 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4581 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4582 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4583 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4584 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4585 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4586 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4587 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4588 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4589 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4590 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4591 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4592 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4593 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4594 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4595 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4596 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4597 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4598 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4599 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4600 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4601
4602 Version 1.27.2 (2018-07-20)
4603 ===========================
4604
4605 Compatibility Notes
4606 -------------------
4607
4608 - The borrow checker was fixed to avoid potential unsoundness when using
4609   match ergonomics: [#52213][52213].
4610
4611 [52213]: https://github.com/rust-lang/rust/issues/52213
4612
4613 Version 1.27.1 (2018-07-10)
4614 ===========================
4615
4616 Security Notes
4617 --------------
4618
4619 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4620   when running, which enabled executing code as some other user on a
4621   given machine. This release fixes that vulnerability; you can read
4622   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4623
4624   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4625
4626 Compatibility Notes
4627 -------------------
4628
4629 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4630   match ergonomics: [#51415][51415], [#49534][49534].
4631
4632 [51415]: https://github.com/rust-lang/rust/issues/51415
4633 [49534]: https://github.com/rust-lang/rust/issues/49534
4634 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4635 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4636
4637 Version 1.27.0 (2018-06-21)
4638 ==========================
4639
4640 Language
4641 --------
4642 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4643   be used as an identifier.
4644 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4645   bare `Trait` syntax, and should make it clearer when being used in tandem with
4646   `impl Trait` because it is equivalent to the following syntax:
4647   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4648   `Box<Trait> == Box<dyn Trait>`.
4649 - [Attributes on generic parameters such as types and lifetimes are
4650   now stable.][48851] e.g.
4651   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4652 - [The `#[must_use]` attribute can now also be used on functions as well as
4653   types.][48925] It provides a lint that by default warns users when the
4654   value returned by a function has not been used.
4655
4656 Compiler
4657 --------
4658 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4659
4660 Libraries
4661 ---------
4662 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4663   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4664   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4665   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4666   the `cfg` attribute.
4667 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4668   std are now available in core.][49896]
4669 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4670   to `Self`.][49630]
4671 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4672   that the operation isn't done in place.
4673 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4674   the `#[must_use]` attribute][49533] to warn about unused potentially
4675   expensive allocations.
4676
4677 Stabilized APIs
4678 ---------------
4679 - [`DoubleEndedIterator::rfind`]
4680 - [`DoubleEndedIterator::rfold`]
4681 - [`DoubleEndedIterator::try_rfold`]
4682 - [`Duration::from_micros`]
4683 - [`Duration::from_nanos`]
4684 - [`Duration::subsec_micros`]
4685 - [`Duration::subsec_millis`]
4686 - [`HashMap::remove_entry`]
4687 - [`Iterator::try_fold`]
4688 - [`Iterator::try_for_each`]
4689 - [`NonNull::cast`]
4690 - [`Option::filter`]
4691 - [`String::replace_range`]
4692 - [`Take::set_limit`]
4693 - [`hint::unreachable_unchecked`]
4694 - [`os::unix::process::parent_id`]
4695 - [`ptr::swap_nonoverlapping`]
4696 - [`slice::rsplit_mut`]
4697 - [`slice::rsplit`]
4698 - [`slice::swap_with_slice`]
4699
4700 Cargo
4701 -----
4702 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4703   `readme`, and `repository` fields.][cargo/5386]
4704 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4705 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4706   a different directory than `target` for placing compilation artifacts.
4707 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4708   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4709   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4710   where cargo would infer a binary, Cargo will produce a warning. You can
4711   disable this feature ahead of time by setting any of the following to false:
4712   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4713 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4714   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4715
4716 Misc
4717 ----
4718 - [Added “The Rustc book” into the official documentation.][49707]
4719   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4720 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4721
4722 Compatibility Notes
4723 -------------------
4724 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4725   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4726   compile, `"".is_empty()` will still compile.
4727 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4728   will only print the inner type.][48553] E.g.
4729   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4730   not `AtomicBool(true)`.
4731 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4732   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4733   alignment should cover all use cases.
4734 - The `.description()` method on the `std::error::Error` trait
4735   [has been soft-deprecated][50163]. It is no longer required to implement it.
4736
4737 [48553]: https://github.com/rust-lang/rust/pull/48553/
4738 [48851]: https://github.com/rust-lang/rust/pull/48851/
4739 [48925]: https://github.com/rust-lang/rust/pull/48925/
4740 [49533]: https://github.com/rust-lang/rust/pull/49533/
4741 [49623]: https://github.com/rust-lang/rust/pull/49623/
4742 [49630]: https://github.com/rust-lang/rust/pull/49630/
4743 [49664]: https://github.com/rust-lang/rust/pull/49664/
4744 [49699]: https://github.com/rust-lang/rust/pull/49699/
4745 [49707]: https://github.com/rust-lang/rust/pull/49707/
4746 [49896]: https://github.com/rust-lang/rust/pull/49896/
4747 [49968]: https://github.com/rust-lang/rust/pull/49968/
4748 [50163]: https://github.com/rust-lang/rust/pull/50163
4749 [50177]: https://github.com/rust-lang/rust/pull/50177/
4750 [50378]: https://github.com/rust-lang/rust/pull/50378/
4751 [50423]: https://github.com/rust-lang/rust/pull/50423/
4752 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4753 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4754 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4755 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4756 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4757 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4758 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4759 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4760 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4761 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4762 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4763 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4764 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4765 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4766 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4767 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4768 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4769 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4770 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4771 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4772 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4773 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4774 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4775 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4776 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4777 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4778 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4779 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4780 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4781
4782
4783 Version 1.26.2 (2018-06-05)
4784 ==========================
4785
4786 Compatibility Notes
4787 -------------------
4788
4789 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4790
4791 [51117]: https://github.com/rust-lang/rust/issues/51117
4792
4793
4794 Version 1.26.1 (2018-05-29)
4795 ==========================
4796
4797 Tools
4798 -----
4799
4800 - [RLS now works on Windows.][50646]
4801 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4802
4803
4804 Compatibility Notes
4805 --------
4806
4807 - [`fn main() -> impl Trait` no longer works for non-Termination
4808   trait.][50656]
4809   This reverts an accidental stabilization.
4810 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4811 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4812
4813 [50646]: https://github.com/rust-lang/rust/issues/50646
4814 [50656]: https://github.com/rust-lang/rust/pull/50656
4815 [50812]: https://github.com/rust-lang/rust/pull/50812
4816 [50950]: https://github.com/rust-lang/rust/issues/50950
4817 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4818
4819 Version 1.26.0 (2018-05-10)
4820 ==========================
4821
4822 Language
4823 --------
4824 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4825   implement either or both traits.][49299]
4826 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4827 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4828   lifetime can be elided.][49458]
4829 - [`impl Trait` is now stable allowing you to have abstract types in returns
4830    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4831   `fn open(path: impl AsRef<Path>)`.
4832 - [Pattern matching will now automatically apply dereferences.][49394]
4833 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4834 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4835 - [A lot of operations are now available in a const context.][46882] E.g. You
4836   can now index into constant arrays, reference and dereference into constants,
4837   and use tuple struct constructors.
4838 - [Fixed entry slice patterns are now stable.][48516] E.g.
4839   ```rust
4840   let points = [1, 2, 3, 4];
4841   match points {
4842       [1, 2, 3, 4] => println!("All points were sequential."),
4843       _ => println!("Not all points were sequential."),
4844   }
4845   ```
4846
4847
4848 Compiler
4849 --------
4850 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4851 - [Fixed exponential projection complexity on nested types.][48296]
4852   This can provide up to a ~12% reduction in compile times for certain crates.
4853 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4854   to remap path prefixes outputted by the compiler.
4855 - [Added `powerpc-unknown-netbsd` target.][48281]
4856
4857 Libraries
4858 ---------
4859 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4860 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4861   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4862 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4863 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4864 - [`ascii::escape_default` is now available in libcore.][48735]
4865 - [Trailing commas are now supported in std and core macros.][48056]
4866 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4867 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4868
4869 Stabilized APIs
4870 ---------------
4871 - [`*const T::add`]
4872 - [`*const T::copy_to_nonoverlapping`]
4873 - [`*const T::copy_to`]
4874 - [`*const T::read_unaligned`]
4875 - [`*const T::read_volatile`]
4876 - [`*const T::read`]
4877 - [`*const T::sub`]
4878 - [`*const T::wrapping_add`]
4879 - [`*const T::wrapping_sub`]
4880 - [`*mut T::add`]
4881 - [`*mut T::copy_to_nonoverlapping`]
4882 - [`*mut T::copy_to`]
4883 - [`*mut T::read_unaligned`]
4884 - [`*mut T::read_volatile`]
4885 - [`*mut T::read`]
4886 - [`*mut T::replace`]
4887 - [`*mut T::sub`]
4888 - [`*mut T::swap`]
4889 - [`*mut T::wrapping_add`]
4890 - [`*mut T::wrapping_sub`]
4891 - [`*mut T::write_bytes`]
4892 - [`*mut T::write_unaligned`]
4893 - [`*mut T::write_volatile`]
4894 - [`*mut T::write`]
4895 - [`Box::leak`]
4896 - [`FromUtf8Error::as_bytes`]
4897 - [`LocalKey::try_with`]
4898 - [`Option::cloned`]
4899 - [`btree_map::Entry::and_modify`]
4900 - [`fs::read_to_string`]
4901 - [`fs::read`]
4902 - [`fs::write`]
4903 - [`hash_map::Entry::and_modify`]
4904 - [`iter::FusedIterator`]
4905 - [`ops::RangeInclusive`]
4906 - [`ops::RangeToInclusive`]
4907 - [`process::id`]
4908 - [`slice::rotate_left`]
4909 - [`slice::rotate_right`]
4910 - [`String::retain`]
4911
4912
4913 Cargo
4914 -----
4915 - [Cargo will now output path to custom commands when `-v` is
4916   passed with `--list`][cargo/5041]
4917 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4918
4919 Misc
4920 ----
4921 - [The second edition of "The Rust Programming Language" book is now recommended
4922   over the first.][48404]
4923
4924 Compatibility Notes
4925 -------------------
4926
4927 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4928   syntax is now invalid.
4929   ```
4930   use std::ops::Fn as dyn;
4931   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4932   ```
4933 - [The result of dereferences are no longer promoted to `'static`.][47408]
4934   e.g.
4935   ```rust
4936   fn main() {
4937       const PAIR: &(i32, i32) = &(0, 1);
4938       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4939   }
4940   ```
4941 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4942 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4943   an error.][48235]
4944 - [Removed hoedown from rustdoc.][48274]
4945 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4946
4947 [46882]: https://github.com/rust-lang/rust/pull/46882
4948 [47379]: https://github.com/rust-lang/rust/pull/47379
4949 [47408]: https://github.com/rust-lang/rust/pull/47408
4950 [47813]: https://github.com/rust-lang/rust/pull/47813
4951 [48056]: https://github.com/rust-lang/rust/pull/48056
4952 [48125]: https://github.com/rust-lang/rust/pull/48125
4953 [48235]: https://github.com/rust-lang/rust/pull/48235
4954 [48274]: https://github.com/rust-lang/rust/pull/48274
4955 [48281]: https://github.com/rust-lang/rust/pull/48281
4956 [48296]: https://github.com/rust-lang/rust/pull/48296
4957 [48326]: https://github.com/rust-lang/rust/pull/48326
4958 [48359]: https://github.com/rust-lang/rust/pull/48359
4959 [48404]: https://github.com/rust-lang/rust/pull/48404
4960 [48481]: https://github.com/rust-lang/rust/pull/48481
4961 [48516]: https://github.com/rust-lang/rust/pull/48516
4962 [48628]: https://github.com/rust-lang/rust/pull/48628
4963 [48629]: https://github.com/rust-lang/rust/pull/48629
4964 [48657]: https://github.com/rust-lang/rust/pull/48657
4965 [48735]: https://github.com/rust-lang/rust/pull/48735
4966 [48978]: https://github.com/rust-lang/rust/pull/48978
4967 [49101]: https://github.com/rust-lang/rust/pull/49101
4968 [49109]: https://github.com/rust-lang/rust/pull/49109
4969 [49162]: https://github.com/rust-lang/rust/pull/49162
4970 [49255]: https://github.com/rust-lang/rust/pull/49255
4971 [49299]: https://github.com/rust-lang/rust/pull/49299
4972 [49305]: https://github.com/rust-lang/rust/pull/49305
4973 [49394]: https://github.com/rust-lang/rust/pull/49394
4974 [49458]: https://github.com/rust-lang/rust/pull/49458
4975 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4976 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4977 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4978 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4979 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4980 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4981 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4982 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4983 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4984 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4985 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4986 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4987 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4988 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4989 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4990 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4991 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4992 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4993 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4994 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4995 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4996 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4997 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4998 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4999 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
5000 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
5001 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
5002 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
5003 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
5004 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
5005 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
5006 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
5007 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
5008 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
5009 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
5010 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
5011 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
5012 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
5013 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
5014 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
5015 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
5016 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
5017
5018
5019 Version 1.25.0 (2018-03-29)
5020 ==========================
5021
5022 Language
5023 --------
5024 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
5025 - [You can now use nested groups of imports.][47948]
5026   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
5027 - [You can now have `|` at the start of a match arm.][47947] e.g.
5028 ```rust
5029 enum Foo { A, B, C }
5030
5031 fn main() {
5032     let x = Foo::A;
5033     match x {
5034         | Foo::A
5035         | Foo::B => println!("AB"),
5036         | Foo::C => println!("C"),
5037     }
5038 }
5039 ```
5040
5041 Compiler
5042 --------
5043 - [Upgraded to LLVM 6.][47828]
5044 - [Added `-C lto=val` option.][47521]
5045 - [Added `i586-unknown-linux-musl` target][47282]
5046
5047 Libraries
5048 ---------
5049 - [Impl Send for `process::Command` on Unix.][47760]
5050 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
5051 - [`UnsafeCell::into_inner` is now safe.][47204]
5052 - [Implement libstd for CloudABI.][47268]
5053 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
5054 - [Implement `AsRef<Path>` for Component][46985]
5055 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
5056 - [Moved `Duration` to libcore.][46666]
5057
5058 Stabilized APIs
5059 ---------------
5060 - [`Location::column`]
5061 - [`ptr::NonNull`]
5062
5063 The following functions can now be used in a constant expression.
5064 eg. `static MINUTE: Duration = Duration::from_secs(60);`
5065 - [`Duration::new`][47300]
5066 - [`Duration::from_secs`][47300]
5067 - [`Duration::from_millis`][47300]
5068
5069 Cargo
5070 -----
5071 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
5072 - [`cargo new` now defaults to creating a binary crate, instead of a
5073   library crate.][cargo/5029]
5074
5075 Misc
5076 ----
5077 - [Rust by example is now shipped with new releases][46196]
5078
5079 Compatibility Notes
5080 -------------------
5081 - [Deprecated `net::lookup_host`.][47510]
5082 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
5083 - The borrow checker was sometimes incorrectly permitting overlapping borrows
5084   around indexing operations (see [#47349][47349]). This has been fixed (which also
5085   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
5086 - [Removed deprecated unstable attribute `#[simd]`.][47251]
5087
5088 [33903]: https://github.com/rust-lang/rust/pull/33903
5089 [47947]: https://github.com/rust-lang/rust/pull/47947
5090 [47948]: https://github.com/rust-lang/rust/pull/47948
5091 [47760]: https://github.com/rust-lang/rust/pull/47760
5092 [47790]: https://github.com/rust-lang/rust/pull/47790
5093 [47828]: https://github.com/rust-lang/rust/pull/47828
5094 [47398]: https://github.com/rust-lang/rust/pull/47398
5095 [47510]: https://github.com/rust-lang/rust/pull/47510
5096 [47521]: https://github.com/rust-lang/rust/pull/47521
5097 [47204]: https://github.com/rust-lang/rust/pull/47204
5098 [47251]: https://github.com/rust-lang/rust/pull/47251
5099 [47268]: https://github.com/rust-lang/rust/pull/47268
5100 [47282]: https://github.com/rust-lang/rust/pull/47282
5101 [47300]: https://github.com/rust-lang/rust/pull/47300
5102 [47349]: https://github.com/rust-lang/rust/pull/47349
5103 [46931]: https://github.com/rust-lang/rust/pull/46931
5104 [46985]: https://github.com/rust-lang/rust/pull/46985
5105 [47006]: https://github.com/rust-lang/rust/pull/47006
5106 [46830]: https://github.com/rust-lang/rust/pull/46830
5107 [46095]: https://github.com/rust-lang/rust/pull/46095
5108 [46666]: https://github.com/rust-lang/rust/pull/46666
5109 [46196]: https://github.com/rust-lang/rust/pull/46196
5110 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
5111 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
5112 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
5113 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
5114 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
5115
5116
5117 Version 1.24.1 (2018-03-01)
5118 ==========================
5119
5120  - [Do not abort when unwinding through FFI][48251]
5121  - [Emit UTF-16 files for linker arguments on Windows][48318]
5122  - [Make the error index generator work again][48308]
5123  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
5124
5125 [48251]: https://github.com/rust-lang/rust/issues/48251
5126 [48308]: https://github.com/rust-lang/rust/issues/48308
5127 [48318]: https://github.com/rust-lang/rust/issues/48318
5128 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
5129
5130
5131 Version 1.24.0 (2018-02-15)
5132 ==========================
5133
5134 Language
5135 --------
5136 - [External `sysv64` ffi is now available.][46528]
5137   eg. `extern "sysv64" fn foo () {}`
5138
5139 Compiler
5140 --------
5141 - [rustc now uses 16 codegen units by default for release builds.][46910]
5142   For the fastest builds, utilize `codegen-units=1`.
5143 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
5144 - [Add `aarch64-unknown-openbsd` support][46760]
5145
5146 Libraries
5147 ---------
5148 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
5149   improvement in performance in the majority of cases.
5150 - [`OsStr`'s `Debug` implementation is now lossless and consistent
5151   with Windows.][46798]
5152 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
5153 - [impl `From<bool>` for `AtomicBool`][46293]
5154 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
5155 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
5156 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
5157 - [float::from_bits now just uses transmute.][46012] This provides
5158   some optimisations from LLVM.
5159 - [Copied `AsciiExt` methods onto `char`][46077]
5160 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
5161 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
5162 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
5163 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
5164
5165 Stabilized APIs
5166 ---------------
5167 - [`RefCell::replace`]
5168 - [`RefCell::swap`]
5169 - [`atomic::spin_loop_hint`]
5170
5171 The following functions can now be used in a constant expression.
5172 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
5173
5174 - [`AtomicBool::new`][46287]
5175 - [`AtomicUsize::new`][46287]
5176 - [`AtomicIsize::new`][46287]
5177 - [`AtomicPtr::new`][46287]
5178 - [`Cell::new`][46287]
5179 - [`{integer}::min_value`][46287]
5180 - [`{integer}::max_value`][46287]
5181 - [`mem::size_of`][46287]
5182 - [`mem::align_of`][46287]
5183 - [`ptr::null`][46287]
5184 - [`ptr::null_mut`][46287]
5185 - [`RefCell::new`][46287]
5186 - [`UnsafeCell::new`][46287]
5187
5188 Cargo
5189 -----
5190 - [Added a `workspace.default-members` config that
5191   overrides implied `--all` in virtual workspaces.][cargo/4743]
5192 - [Enable incremental by default on development builds.][cargo/4817] Also added
5193   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
5194   per-project or global basis respectively.
5195
5196 Misc
5197 ----
5198
5199 Compatibility Notes
5200 -------------------
5201 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
5202 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
5203   in accordance with IETF RFC 4291 §2.2.
5204 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
5205 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
5206   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
5207 - [Leading zeros in tuple struct members is now an error][47084]
5208 - [`column!()` macro is one-based instead of zero-based][46977]
5209 - [`fmt::Arguments` can no longer be shared across threads][45198]
5210 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
5211 - [Cargo sets a different working directory for the compiler][cargo/4788]
5212
5213 [44884]: https://github.com/rust-lang/rust/pull/44884
5214 [45198]: https://github.com/rust-lang/rust/pull/45198
5215 [45506]: https://github.com/rust-lang/rust/pull/45506
5216 [45990]: https://github.com/rust-lang/rust/pull/45990
5217 [46012]: https://github.com/rust-lang/rust/pull/46012
5218 [46077]: https://github.com/rust-lang/rust/pull/46077
5219 [46094]: https://github.com/rust-lang/rust/pull/46094
5220 [46284]: https://github.com/rust-lang/rust/pull/46284
5221 [46287]: https://github.com/rust-lang/rust/pull/46287
5222 [46293]: https://github.com/rust-lang/rust/pull/46293
5223 [46528]: https://github.com/rust-lang/rust/pull/46528
5224 [46671]: https://github.com/rust-lang/rust/pull/46671
5225 [46713]: https://github.com/rust-lang/rust/pull/46713
5226 [46735]: https://github.com/rust-lang/rust/pull/46735
5227 [46760]: https://github.com/rust-lang/rust/pull/46760
5228 [46798]: https://github.com/rust-lang/rust/pull/46798
5229 [46828]: https://github.com/rust-lang/rust/pull/46828
5230 [46831]: https://github.com/rust-lang/rust/pull/46831
5231 [46833]: https://github.com/rust-lang/rust/pull/46833
5232 [46910]: https://github.com/rust-lang/rust/pull/46910
5233 [46977]: https://github.com/rust-lang/rust/pull/46977
5234 [47018]: https://github.com/rust-lang/rust/pull/47018
5235 [47080]: https://github.com/rust-lang/rust/pull/47080
5236 [47084]: https://github.com/rust-lang/rust/pull/47084
5237 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
5238 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
5239 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
5240 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
5241 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
5242 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
5243
5244
5245 Version 1.23.0 (2018-01-04)
5246 ==========================
5247
5248 Language
5249 --------
5250 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
5251 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
5252   Which should fix some confusing errors in some operations.
5253
5254 Compiler
5255 --------
5256 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
5257   undefined behavior.][45920]
5258 - [rustc now suggests renaming import if names clash.][45660]
5259 - [Display errors/warnings correctly when there are zero-width or
5260   wide characters.][45711]
5261 - [rustc now avoids unnecessary copies of arguments that are
5262   simple bindings][45380] This should improve memory usage on average by 5-10%.
5263 - [Updated musl used to build musl rustc to 1.1.17][45393]
5264
5265 Libraries
5266 ---------
5267 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
5268 - [Implement Hash for raw pointers to unsized types][45483]
5269 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
5270 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
5271 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
5272 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
5273   and `<*mut T>::as_mut`][44932]
5274 - [Optimized `Thread::{park, unpark}` implementation][45524]
5275 - [Improved `SliceExt::binary_search` performance.][45333]
5276 - [impl `FromIterator<()>` for `()`][45379]
5277 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
5278   is now deprecated.
5279
5280 Stabilized APIs
5281 ---------------
5282
5283 Cargo
5284 -----
5285 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
5286   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
5287 - [Added unit test checking to `cargo check`][cargo/4592]
5288 - [Cargo now lets you install a specific version
5289   using `cargo install --version`][cargo/4637]
5290
5291 Misc
5292 ----
5293 - [Releases now ship with the Cargo book documentation.][45692]
5294 - [rustdoc now prints rendering warnings on every run.][45324]
5295
5296 Compatibility Notes
5297 -------------------
5298 - [Changes have been made to type equality to make it more correct,
5299   in rare cases this could break some code.][45853] [Tracking issue for
5300   further information][45852]
5301 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
5302 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
5303   Android 9, the minimum supported version is Android 14.
5304 - [Bumped the minimum LLVM to 3.9][45326]
5305
5306 [44042]: https://github.com/rust-lang/rust/pull/44042
5307 [44932]: https://github.com/rust-lang/rust/pull/44932
5308 [45267]: https://github.com/rust-lang/rust/pull/45267
5309 [45324]: https://github.com/rust-lang/rust/pull/45324
5310 [45326]: https://github.com/rust-lang/rust/pull/45326
5311 [45333]: https://github.com/rust-lang/rust/pull/45333
5312 [45379]: https://github.com/rust-lang/rust/pull/45379
5313 [45380]: https://github.com/rust-lang/rust/pull/45380
5314 [45393]: https://github.com/rust-lang/rust/pull/45393
5315 [45435]: https://github.com/rust-lang/rust/pull/45435
5316 [45483]: https://github.com/rust-lang/rust/pull/45483
5317 [45524]: https://github.com/rust-lang/rust/pull/45524
5318 [45571]: https://github.com/rust-lang/rust/pull/45571
5319 [45580]: https://github.com/rust-lang/rust/pull/45580
5320 [45610]: https://github.com/rust-lang/rust/pull/45610
5321 [45660]: https://github.com/rust-lang/rust/pull/45660
5322 [45692]: https://github.com/rust-lang/rust/pull/45692
5323 [45711]: https://github.com/rust-lang/rust/pull/45711
5324 [45772]: https://github.com/rust-lang/rust/pull/45772
5325 [45852]: https://github.com/rust-lang/rust/issues/45852
5326 [45853]: https://github.com/rust-lang/rust/pull/45853
5327 [45887]: https://github.com/rust-lang/rust/pull/45887
5328 [45920]: https://github.com/rust-lang/rust/pull/45920
5329 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
5330 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
5331 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
5332
5333
5334 Version 1.22.1 (2017-11-22)
5335 ==========================
5336
5337 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
5338
5339 [46183]: https://github.com/rust-lang/rust/pull/46183
5340
5341 Version 1.22.0 (2017-11-22)
5342 ==========================
5343
5344 Language
5345 --------
5346 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
5347 - [Now accepts underscores in unicode escapes][43716]
5348 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
5349 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
5350
5351 Compiler
5352 --------
5353 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
5354 - [rustc will no longer inline in codegen units when compiling for debug][45075]
5355   This should decrease compile times for debug builds.
5356 - [strict memory alignment now enabled on ARMv6][45094]
5357 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
5358
5359 Libraries
5360 ---------
5361 - [Allow atomic operations up to 32 bits
5362   on `armv5te_unknown_linux_gnueabi`][44978]
5363 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
5364 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
5365 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
5366 - [Properly detect overflow in `Instant += Duration`.][44220]
5367 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
5368 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
5369 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
5370
5371 Stabilized APIs
5372 ---------------
5373
5374 Cargo
5375 -----
5376 - [Cargo will now build multi file examples in subdirectories of the `examples`
5377   folder that have a `main.rs` file.][cargo/4496]
5378 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
5379   the old format will continue to work and can be updated with `cargo update`.
5380 - [Now supports vendoring git repositories][cargo/3992]
5381
5382 Misc
5383 ----
5384 - [`libbacktrace` is now available on Apple platforms.][44251]
5385 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
5386   This now lets you specify that a given code example will fail to compile.
5387
5388 Compatibility Notes
5389 -------------------
5390 - [The minimum Android version that rustc can build for has been bumped
5391   to `4.0` from `2.3`][45656]
5392 - [Allowing `T op= &T` for numeric types has broken some type
5393   inference cases][45480]
5394
5395
5396 [42526]: https://github.com/rust-lang/rust/pull/42526
5397 [43716]: https://github.com/rust-lang/rust/pull/43716
5398 [43949]: https://github.com/rust-lang/rust/pull/43949
5399 [44015]: https://github.com/rust-lang/rust/pull/44015
5400 [44220]: https://github.com/rust-lang/rust/pull/44220
5401 [44251]: https://github.com/rust-lang/rust/pull/44251
5402 [44287]: https://github.com/rust-lang/rust/pull/44287
5403 [44303]: https://github.com/rust-lang/rust/pull/44303
5404 [44456]: https://github.com/rust-lang/rust/pull/44456
5405 [44466]: https://github.com/rust-lang/rust/pull/44466
5406 [44895]: https://github.com/rust-lang/rust/pull/44895
5407 [44966]: https://github.com/rust-lang/rust/pull/44966
5408 [44978]: https://github.com/rust-lang/rust/pull/44978
5409 [45041]: https://github.com/rust-lang/rust/pull/45041
5410 [45064]: https://github.com/rust-lang/rust/pull/45064
5411 [45075]: https://github.com/rust-lang/rust/pull/45075
5412 [45094]: https://github.com/rust-lang/rust/pull/45094
5413 [45095]: https://github.com/rust-lang/rust/pull/45095
5414 [45480]: https://github.com/rust-lang/rust/issues/45480
5415 [45656]: https://github.com/rust-lang/rust/pull/45656
5416 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
5417 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
5418 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
5419
5420
5421
5422
5423
5424
5425 Version 1.21.0 (2017-10-12)
5426 ==========================
5427
5428 Language
5429 --------
5430 - [You can now use static references for literals.][43838]
5431   Example:
5432   ```rust
5433   fn main() {
5434       let x: &'static u32 = &0;
5435   }
5436   ```
5437 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
5438   Example:
5439   ```rust
5440   my_macro!(Vec<i32>::new); // Always worked
5441   my_macro!(Vec::<i32>::new); // Now works
5442   ```
5443
5444 Compiler
5445 --------
5446 - [Upgraded jemalloc to 4.5.0][43911]
5447 - [Enabled unwinding panics on Redox][43917]
5448 - [Now runs LLVM in parallel during translation phase.][43506]
5449   This should reduce peak memory usage.
5450
5451 Libraries
5452 ---------
5453 - [Generate builtin impls for `Clone` for all arrays and tuples that
5454   are `T: Clone`][43690]
5455 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
5456 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
5457   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
5458
5459 Stabilized APIs
5460 ---------------
5461
5462 [`std::mem::discriminant`]
5463
5464 Cargo
5465 -----
5466 - [You can now call `cargo install` with multiple package names][cargo/4216]
5467 - [Cargo commands inside a virtual workspace will now implicitly
5468   pass `--all`][cargo/4335]
5469 - [Added a `[patch]` section to `Cargo.toml` to handle
5470   prepublication dependencies][cargo/4123] [RFC 1969]
5471 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
5472   like patterns][cargo/4270]
5473 - [Added the `--all-targets` option][cargo/4400]
5474 - [Using required dependencies as a feature is now deprecated and emits
5475   a warning][cargo/4364]
5476
5477
5478 Misc
5479 ----
5480 - [Cargo docs are moving][43916]
5481   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
5482 - [The rustdoc book is now available][43863]
5483   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
5484 - [Added a preview of RLS has been made available through rustup][44204]
5485   Install with `rustup component add rls-preview`
5486 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
5487   Previously only showed `std::os::unix`.
5488
5489 Compatibility Notes
5490 -------------------
5491 - [Changes in method matching against higher-ranked types][43880] This may cause
5492   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
5493 - [rustc's JSON error output's byte position start at top of file.][42973]
5494   Was previously relative to the rustc's internal `CodeMap` struct which
5495   required the unstable library `libsyntax` to correctly use.
5496 - [`unused_results` lint no longer ignores booleans][43728]
5497
5498 [42565]: https://github.com/rust-lang/rust/pull/42565
5499 [42973]: https://github.com/rust-lang/rust/pull/42973
5500 [43348]: https://github.com/rust-lang/rust/pull/43348
5501 [43459]: https://github.com/rust-lang/rust/pull/43459
5502 [43506]: https://github.com/rust-lang/rust/pull/43506
5503 [43540]: https://github.com/rust-lang/rust/pull/43540
5504 [43690]: https://github.com/rust-lang/rust/pull/43690
5505 [43728]: https://github.com/rust-lang/rust/pull/43728
5506 [43838]: https://github.com/rust-lang/rust/pull/43838
5507 [43863]: https://github.com/rust-lang/rust/pull/43863
5508 [43880]: https://github.com/rust-lang/rust/pull/43880
5509 [43911]: https://github.com/rust-lang/rust/pull/43911
5510 [43916]: https://github.com/rust-lang/rust/pull/43916
5511 [43917]: https://github.com/rust-lang/rust/pull/43917
5512 [44204]: https://github.com/rust-lang/rust/pull/44204
5513 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
5514 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
5515 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5516 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
5517 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
5518 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
5519 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
5520 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
5521 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
5522
5523 Version 1.20.0 (2017-08-31)
5524 ===========================
5525
5526 Language
5527 --------
5528 - [Associated constants are now stabilised.][42809]
5529 - [A lot of macro bugs are now fixed.][42913]
5530
5531 Compiler
5532 --------
5533
5534 - [Struct fields are now properly coerced to the expected field type.][42807]
5535 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
5536   `wasm32-experimental-emscripten` target.
5537 - [Changed some of the error messages to be more helpful.][42033]
5538 - [Add support for RELRO(RELocation Read-Only) for platforms that support
5539   it.][43170]
5540 - [rustc now reports the total number of errors on compilation failure][43015]
5541   previously this was only the number of errors in the pass that failed.
5542 - [Expansion in rustc has been sped up 29x.][42533]
5543 - [added `msp430-none-elf` target.][43099]
5544 - [rustc will now suggest one-argument enum variant to fix type mismatch when
5545   applicable][43178]
5546 - [Fixes backtraces on Redox][43228]
5547 - [rustc now identifies different versions of same crate when absolute paths of
5548   different types match in an error message.][42826]
5549
5550 Libraries
5551 ---------
5552
5553
5554 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
5555 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
5556   tuples.][43011]
5557 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
5558   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
5559 - [Impl `Clone` for `DefaultHasher`.][42799]
5560 - [Impl `Sync` for `SyncSender`.][42397]
5561 - [Impl `FromStr` for `char`][42271]
5562 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
5563   NaN.][42431]
5564 - [allow messages in the `unimplemented!()` macro.][42155]
5565   ie. `unimplemented!("Waiting for 1.21 to be stable")`
5566 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
5567 - [Upgrade to Unicode 10.0.0][42999]
5568 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5569 - [Skip the main thread's manual stack guard on Linux][43072]
5570 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in *O*(1) time][43077]
5571 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5572   previously 2^15.
5573 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5574
5575 Stabilized APIs
5576 ---------------
5577
5578 - [`CStr::into_c_string`]
5579 - [`CString::as_c_str`]
5580 - [`CString::into_boxed_c_str`]
5581 - [`Chain::get_mut`]
5582 - [`Chain::get_ref`]
5583 - [`Chain::into_inner`]
5584 - [`Option::get_or_insert_with`]
5585 - [`Option::get_or_insert`]
5586 - [`OsStr::into_os_string`]
5587 - [`OsString::into_boxed_os_str`]
5588 - [`Take::get_mut`]
5589 - [`Take::get_ref`]
5590 - [`Utf8Error::error_len`]
5591 - [`char::EscapeDebug`]
5592 - [`char::escape_debug`]
5593 - [`compile_error!`]
5594 - [`f32::from_bits`]
5595 - [`f32::to_bits`]
5596 - [`f64::from_bits`]
5597 - [`f64::to_bits`]
5598 - [`mem::ManuallyDrop`]
5599 - [`slice::sort_unstable_by_key`]
5600 - [`slice::sort_unstable_by`]
5601 - [`slice::sort_unstable`]
5602 - [`str::from_boxed_utf8_unchecked`]
5603 - [`str::as_bytes_mut`]
5604 - [`str::as_bytes_mut`]
5605 - [`str::from_utf8_mut`]
5606 - [`str::from_utf8_unchecked_mut`]
5607 - [`str::get_mut`]
5608 - [`str::get_unchecked_mut`]
5609 - [`str::get_unchecked`]
5610 - [`str::get`]
5611 - [`str::into_boxed_bytes`]
5612
5613
5614 Cargo
5615 -----
5616 - [Cargo API token location moved from `~/.cargo/config` to
5617   `~/.cargo/credentials`.][cargo/3978]
5618 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5619   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5620   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5621 - [You can now specify version of a binary when installed through
5622   `cargo install` using `--vers`.][cargo/4229]
5623 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5624   failure.][cargo/4248]
5625 - [Changed the convention around which file is the crate root.][cargo/4259]
5626
5627 Compatibility Notes
5628 -------------------
5629
5630 - [Functions with `'static` in their return types will now not be as usable as
5631   if they were using lifetime parameters instead.][42417]
5632 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5633   takes the sign of NaN into account where previously didn't.][42430]
5634
5635 [42033]: https://github.com/rust-lang/rust/pull/42033
5636 [42155]: https://github.com/rust-lang/rust/pull/42155
5637 [42271]: https://github.com/rust-lang/rust/pull/42271
5638 [42397]: https://github.com/rust-lang/rust/pull/42397
5639 [42417]: https://github.com/rust-lang/rust/pull/42417
5640 [42430]: https://github.com/rust-lang/rust/pull/42430
5641 [42431]: https://github.com/rust-lang/rust/pull/42431
5642 [42533]: https://github.com/rust-lang/rust/pull/42533
5643 [42571]: https://github.com/rust-lang/rust/pull/42571
5644 [42613]: https://github.com/rust-lang/rust/pull/42613
5645 [42799]: https://github.com/rust-lang/rust/pull/42799
5646 [42807]: https://github.com/rust-lang/rust/pull/42807
5647 [42809]: https://github.com/rust-lang/rust/pull/42809
5648 [42822]: https://github.com/rust-lang/rust/pull/42822
5649 [42826]: https://github.com/rust-lang/rust/pull/42826
5650 [42854]: https://github.com/rust-lang/rust/pull/42854
5651 [42913]: https://github.com/rust-lang/rust/pull/42913
5652 [42999]: https://github.com/rust-lang/rust/pull/42999
5653 [43011]: https://github.com/rust-lang/rust/pull/43011
5654 [43015]: https://github.com/rust-lang/rust/pull/43015
5655 [43072]: https://github.com/rust-lang/rust/pull/43072
5656 [43077]: https://github.com/rust-lang/rust/pull/43077
5657 [43097]: https://github.com/rust-lang/rust/pull/43097
5658 [43099]: https://github.com/rust-lang/rust/pull/43099
5659 [43170]: https://github.com/rust-lang/rust/pull/43170
5660 [43178]: https://github.com/rust-lang/rust/pull/43178
5661 [43185]: https://github.com/rust-lang/rust/pull/43185
5662 [43228]: https://github.com/rust-lang/rust/pull/43228
5663 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5664 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5665 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5666 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5667 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5668 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5669 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5670 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5671 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5672 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5673 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5674 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5675 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5676 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5677 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5678 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5679 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5680 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5681 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5682 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5683 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5684 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5685 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5686 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5687 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5688 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5689 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5690 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5691 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5692 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5693 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5694 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5695 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5696 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5697 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5698 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5699 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5700 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5701
5702
5703 Version 1.19.0 (2017-07-20)
5704 ===========================
5705
5706 Language
5707 --------
5708
5709 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5710   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5711 - [Macro recursion limit increased to 1024 from 64.][41676]
5712 - [Added lint for detecting unused macros.][41907]
5713 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5714   For example: `let x = loop { break 7; };`
5715 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5716   contain `Copy` types and cannot have a `Drop` implementation.
5717   Example: `union Foo { bar: u8, baz: usize }`
5718 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5719   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5720
5721 Compiler
5722 --------
5723
5724 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5725 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5726   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5727   you should use `--target armv7-linux-androideabi`.
5728 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5729 - [Minor optimisation of string operations.][42037]
5730 - [Compiler error message is now `aborting due to previous error(s)` instead of
5731   `aborting due to N previous errors`][42150] This was previously inaccurate and
5732   would only count certain kinds of errors.
5733 - [The compiler now supports Visual Studio 2017][42225]
5734 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5735 - [Added a lot][42264] of [new error codes][42302]
5736 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5737   libraries with C Run-time Libraries(CRT) to be statically linked.
5738 - [Fixed various ARM codegen bugs][42740]
5739
5740 Libraries
5741 ---------
5742
5743 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5744   `Extend<Cow<'a, str>>`][41449]
5745 - [`Vec` now implements `From<&mut [T]>`][41530]
5746 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5747 - [`SplitWhitespace` now implements `Clone`][41659]
5748 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5749   1.5x faster][41764]
5750 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5751   macros, but for printing to stderr.
5752
5753 Stabilized APIs
5754 ---------------
5755
5756 - [`OsString::shrink_to_fit`]
5757 - [`cmp::Reverse`]
5758 - [`Command::envs`]
5759 - [`thread::ThreadId`]
5760
5761 Cargo
5762 -----
5763
5764 - [Build scripts can now add environment variables to the environment
5765   the crate is being compiled in.
5766   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5767 - [Subcommands now replace the current process rather than spawning a new
5768   child process][cargo/3970]
5769 - [Workspace members can now accept glob file patterns][cargo/3979]
5770 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5771   the members in a given workspace.][cargo/3988]
5772 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5773 - [Target directory path is now in the cargo metadata][cargo/4022]
5774 - [Cargo no longer checks out a local working directory for the
5775   crates.io index][cargo/4026] This should provide smaller file size for the
5776   registry, and improve cloning times, especially on Windows machines.
5777 - [Added an `--exclude` option for excluding certain packages when using the
5778   `--all` option][cargo/4031]
5779 - [Cargo will now automatically retry when receiving a 5xx error
5780   from crates.io][cargo/4032]
5781 - [The `--features` option now accepts multiple comma or space
5782   delimited values.][cargo/4084]
5783 - [Added support for custom target specific runners][cargo/3954]
5784
5785 Misc
5786 ----
5787
5788 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5789   Windows Debugger.
5790 - [Rust will now release XZ compressed packages][rust-installer/57]
5791 - [rustup will now prefer to download rust packages with
5792   XZ compression][rustup/1100] over GZip packages.
5793 - [Added the ability to escape `#` in rust documentation][41785] By adding
5794   additional `#`'s ie. `##` is now `#`
5795
5796 Compatibility Notes
5797 -------------------
5798
5799 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5800 - [`-Z` flags are now no longer allowed to be used on the stable
5801   compiler.][41751] This has been a warning for a year previous to this.
5802 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5803   longer works][42844]. Users should migrate to the built-in `check`
5804   command, which has been available since 1.16.
5805 - [Ending a float literal with `._` is now a hard error.
5806   Example: `42._` .][41946]
5807 - [Any use of a private `extern crate` outside of its module is now a
5808   hard error.][36886] This was previously a warning.
5809 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5810   relative while the `::` prefix makes a path absolute, but was ignored and the
5811   path was relative regardless.
5812 - [Floating point constants in match patterns is now a hard error][36890]
5813   This was previously a warning.
5814 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5815   match patterns is now a hard error][36891] This was previously a warning.
5816 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5817   a warning.
5818 - [From the pound escape, lines consisting of multiple `#`s are
5819   now visible][41785]
5820 - [It is an error to re-export private enum variants][42460]. This is
5821   known to break a number of crates that depend on an older version of
5822   mustache.
5823 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5824   to use it to find the linker, and the build will fail where it did
5825   not previously][42607]
5826
5827 [36886]: https://github.com/rust-lang/rust/issues/36886
5828 [36888]: https://github.com/rust-lang/rust/issues/36888
5829 [36890]: https://github.com/rust-lang/rust/issues/36890
5830 [36891]: https://github.com/rust-lang/rust/issues/36891
5831 [36892]: https://github.com/rust-lang/rust/issues/36892
5832 [37406]: https://github.com/rust-lang/rust/issues/37406
5833 [39983]: https://github.com/rust-lang/rust/pull/39983
5834 [41145]: https://github.com/rust-lang/rust/pull/41145
5835 [41192]: https://github.com/rust-lang/rust/pull/41192
5836 [41258]: https://github.com/rust-lang/rust/pull/41258
5837 [41370]: https://github.com/rust-lang/rust/pull/41370
5838 [41449]: https://github.com/rust-lang/rust/pull/41449
5839 [41530]: https://github.com/rust-lang/rust/pull/41530
5840 [41624]: https://github.com/rust-lang/rust/pull/41624
5841 [41656]: https://github.com/rust-lang/rust/pull/41656
5842 [41659]: https://github.com/rust-lang/rust/pull/41659
5843 [41676]: https://github.com/rust-lang/rust/pull/41676
5844 [41751]: https://github.com/rust-lang/rust/pull/41751
5845 [41764]: https://github.com/rust-lang/rust/pull/41764
5846 [41785]: https://github.com/rust-lang/rust/pull/41785
5847 [41873]: https://github.com/rust-lang/rust/pull/41873
5848 [41907]: https://github.com/rust-lang/rust/pull/41907
5849 [41946]: https://github.com/rust-lang/rust/pull/41946
5850 [42016]: https://github.com/rust-lang/rust/pull/42016
5851 [42037]: https://github.com/rust-lang/rust/pull/42037
5852 [42068]: https://github.com/rust-lang/rust/pull/42068
5853 [42150]: https://github.com/rust-lang/rust/pull/42150
5854 [42162]: https://github.com/rust-lang/rust/pull/42162
5855 [42225]: https://github.com/rust-lang/rust/pull/42225
5856 [42264]: https://github.com/rust-lang/rust/pull/42264
5857 [42302]: https://github.com/rust-lang/rust/pull/42302
5858 [42460]: https://github.com/rust-lang/rust/issues/42460
5859 [42607]: https://github.com/rust-lang/rust/issues/42607
5860 [42740]: https://github.com/rust-lang/rust/pull/42740
5861 [42844]: https://github.com/rust-lang/rust/issues/42844
5862 [42948]: https://github.com/rust-lang/rust/pull/42948
5863 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5864 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5865 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5866 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5867 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5868 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5869 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5870 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5871 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5872 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5873 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5874 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5875 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5876 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5877 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5878 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5879 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5880 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5881 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5882 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5883 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5884 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5885
5886
5887 Version 1.18.0 (2017-06-08)
5888 ===========================
5889
5890 Language
5891 --------
5892
5893 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5894   make the item visible to just that module tree. Also accepts the keyword
5895   `crate` to make something public to the whole crate but not users of the
5896   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5897 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5898   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5899 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5900   types like `Write + Send`, trailing `+` are now supported in trait objects,
5901   and better error reporting for trait objects starting with `?Sized`.
5902 - [0e+10 is now a valid floating point literal][40589]
5903 - [Now warns if you bind a lifetime parameter to 'static][40734]
5904 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5905   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5906   representation in some cases.][40377]
5907
5908 Compiler
5909 --------
5910
5911 - [rustc can now emit mir with `--emit mir`][39891]
5912 - [Improved LLVM IR for trivial functions][40367]
5913 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5914 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5915   opportunities found through profiling
5916 - [Improved backtrace formatting when panicking][38165]
5917
5918 Libraries
5919 ---------
5920
5921 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5922   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5923   iteration or reallocation.
5924 - [Simplified HashMap Bucket interface][40561] provides performance
5925   improvements for iterating and cloning.
5926 - [Specialize Vec::from_elem to use calloc][40409]
5927 - [Fixed Race condition in fs::create_dir_all][39799]
5928 - [No longer caching stdio on Windows][40516]
5929 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5930   2.50%~ faster and in one case now 12.50% faster.
5931 - [Optimized `AtomicBool::fetch_nand`][41143]
5932
5933 Stabilized APIs
5934 ---------------
5935
5936 - [`Child::try_wait`]
5937 - [`HashMap::retain`]
5938 - [`HashSet::retain`]
5939 - [`PeekMut::pop`]
5940 - [`TcpStream::peek`]
5941 - [`UdpSocket::peek`]
5942 - [`UdpSocket::peek_from`]
5943
5944 Cargo
5945 -----
5946
5947 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5948   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5949 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5950 - [Added Android build support][cargo/3885]
5951 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5952   of a certain type, for example `cargo build --bins` will build all
5953   binaries.
5954 - [Added support for haiku][cargo/3952]
5955
5956 Misc
5957 ----
5958
5959 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5960 - [Rust now uses the official cross compiler for NetBSD][40612]
5961 - [rustdoc now accepts `#` at the start of files][40828]
5962 - [Fixed jemalloc support for musl][41168]
5963
5964 Compatibility Notes
5965 -------------------
5966
5967 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5968   always placed after the sign if it exists and before the digits. With the `#`
5969   flag the zeroes are placed after the prefix and before the digits.
5970 - [Due to the struct field optimisation][40377], using `transmute` on structs
5971   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5972   always been undefined behavior, but is now more likely to break in practice.
5973 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5974   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5975   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5976 - [Overlapping inherent `impl`s are now a hard error][40728]
5977 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5978 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5979   `out.asm` and `out.ll` instead of only one of the filetypes.
5980 - [ calling a function that returns `Self` will no longer work][41805] when
5981   the size of `Self` cannot be statically determined.
5982 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5983   this has caused a few regressions namely:
5984
5985   - Changed the link order of local static/dynamic libraries (respecting the
5986     order on given rather than having the compiler reorder).
5987   - Changed how MinGW is linked, native code linked to dynamic libraries
5988     may require manually linking to the gcc support library (for the native
5989     code itself)
5990
5991 [38165]: https://github.com/rust-lang/rust/pull/38165
5992 [39799]: https://github.com/rust-lang/rust/pull/39799
5993 [39891]: https://github.com/rust-lang/rust/pull/39891
5994 [40043]: https://github.com/rust-lang/rust/pull/40043
5995 [40241]: https://github.com/rust-lang/rust/pull/40241
5996 [40338]: https://github.com/rust-lang/rust/pull/40338
5997 [40367]: https://github.com/rust-lang/rust/pull/40367
5998 [40377]: https://github.com/rust-lang/rust/pull/40377
5999 [40409]: https://github.com/rust-lang/rust/pull/40409
6000 [40516]: https://github.com/rust-lang/rust/pull/40516
6001 [40556]: https://github.com/rust-lang/rust/pull/40556
6002 [40561]: https://github.com/rust-lang/rust/pull/40561
6003 [40589]: https://github.com/rust-lang/rust/pull/40589
6004 [40612]: https://github.com/rust-lang/rust/pull/40612
6005 [40723]: https://github.com/rust-lang/rust/pull/40723
6006 [40728]: https://github.com/rust-lang/rust/pull/40728
6007 [40731]: https://github.com/rust-lang/rust/pull/40731
6008 [40734]: https://github.com/rust-lang/rust/pull/40734
6009 [40805]: https://github.com/rust-lang/rust/pull/40805
6010 [40807]: https://github.com/rust-lang/rust/pull/40807
6011 [40828]: https://github.com/rust-lang/rust/pull/40828
6012 [40870]: https://github.com/rust-lang/rust/pull/40870
6013 [41085]: https://github.com/rust-lang/rust/pull/41085
6014 [41143]: https://github.com/rust-lang/rust/pull/41143
6015 [41168]: https://github.com/rust-lang/rust/pull/41168
6016 [41270]: https://github.com/rust-lang/rust/issues/41270
6017 [41469]: https://github.com/rust-lang/rust/pull/41469
6018 [41805]: https://github.com/rust-lang/rust/issues/41805
6019 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
6020 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
6021 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
6022 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
6023 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
6024 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
6025 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
6026 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
6027 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
6028 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
6029 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
6030 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
6031 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
6032 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
6033
6034
6035 Version 1.17.0 (2017-04-27)
6036 ===========================
6037
6038 Language
6039 --------
6040
6041 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
6042 * [Fields of structs may be initialized without duplicating the field/variable
6043   names][39761]. [RFC 1682]
6044 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
6045 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6046   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
6047   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
6048   `'b`. Soundness fix.
6049 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
6050 * [Static variables may contain references to other statics][40027]
6051
6052 Compiler
6053 --------
6054
6055 * [Exit quickly on only `--emit dep-info`][40336]
6056 * [Make `-C relocation-model` more correctly determine whether the linker
6057   creates a position-independent executable][40245]
6058 * [Add `-C overflow-checks` to directly control whether integer overflow
6059   panics][40037]
6060 * [The rustc type checker now checks items on demand instead of in a single
6061   in-order pass][40008]. This is mostly an internal refactoring in support of
6062   future work, including incremental type checking, but also resolves [RFC
6063   1647], allowing `Self` to appear in `impl` `where` clauses.
6064 * [Optimize vtable loads][39995]
6065 * [Turn off vectorization for Emscripten targets][39990]
6066 * [Provide suggestions for unknown macros imported with `use`][39953]
6067 * [Fix ICEs in path resolution][39939]
6068 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
6069 * [Add clearer error message using `&str + &str`][39116]
6070
6071 Stabilized APIs
6072 ---------------
6073
6074 * [`Arc::into_raw`]
6075 * [`Arc::from_raw`]
6076 * [`Arc::ptr_eq`]
6077 * [`Rc::into_raw`]
6078 * [`Rc::from_raw`]
6079 * [`Rc::ptr_eq`]
6080 * [`Ordering::then`]
6081 * [`Ordering::then_with`]
6082 * [`BTreeMap::range`]
6083 * [`BTreeMap::range_mut`]
6084 * [`collections::Bound`]
6085 * [`process::abort`]
6086 * [`ptr::read_unaligned`]
6087 * [`ptr::write_unaligned`]
6088 * [`Result::expect_err`]
6089 * [`Cell::swap`]
6090 * [`Cell::replace`]
6091 * [`Cell::into_inner`]
6092 * [`Cell::take`]
6093
6094 Libraries
6095 ---------
6096
6097 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
6098 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
6099 * [`String` implements `FromIterator<&char>`][40028]
6100 * `Box` [implements][40009] a number of new conversions:
6101   `From<Box<str>> for String`,
6102   `From<Box<[T]>> for Vec<T>`,
6103   `From<Box<CStr>> for CString`,
6104   `From<Box<OsStr>> for OsString`,
6105   `From<Box<Path>> for PathBuf`,
6106   `Into<Box<str>> for String`,
6107   `Into<Box<[T]>> for Vec<T>`,
6108   `Into<Box<CStr>> for CString`,
6109   `Into<Box<OsStr>> for OsString`,
6110   `Into<Box<Path>> for PathBuf`,
6111   `Default for Box<str>`,
6112   `Default for Box<CStr>`,
6113   `Default for Box<OsStr>`,
6114   `From<&CStr> for Box<CStr>`,
6115   `From<&OsStr> for Box<OsStr>`,
6116   `From<&Path> for Box<Path>`
6117 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
6118 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
6119 * [Slightly optimize `slice::sort`][39538]
6120 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
6121 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
6122   `Box<str>` implements `From<&str>`][39438]
6123 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
6124   `From<(I, u16)> where I: Into<IpAddr>`][39372]
6125 * [`format!` estimates the needed capacity before writing a string][39356]
6126 * [Support unprivileged symlink creation in Windows][38921]
6127 * [`PathBuf` implements `Default`][38764]
6128 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
6129 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
6130   and poor hash functions.
6131
6132 Cargo
6133 -----
6134
6135 * [Add `cargo check --all`][cargo/3731]
6136 * [Add an option to ignore SSL revocation checking][cargo/3699]
6137 * [Add `cargo run --package`][cargo/3691]
6138 * [Add `required_features`][cargo/3667]
6139 * [Assume `build.rs` is a build script][cargo/3664]
6140 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
6141
6142 Misc
6143 ----
6144
6145 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
6146   `rustbook`][39633]
6147 * [The "Unstable Book" documents nightly-only features][ubook]
6148 * [Improve the style of the sidebar in rustdoc output][40265]
6149 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
6150 * [Fix MSP430 breakage due to `i128`][40257]
6151 * [Preliminary Solaris/SPARCv9 support][39903]
6152 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
6153   run without installing the MSVC runtime.
6154 * [`rustdoc --test` includes file names in test names][39788]
6155 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
6156   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
6157 * [Initial support for `aarch64-unknown-freebsd`][39491]
6158 * [Initial support for `i686-unknown-netbsd`][39426]
6159 * [This release no longer includes the old makefile build system][39431]. Rust
6160   is built with a custom build system, written in Rust, and with Cargo.
6161 * [Add Debug implementations for libcollection structs][39002]
6162 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
6163 * [`--test-threads=0` produces an error][38945]
6164 * [`rustup` installs documentation by default][40526]
6165 * [The Rust source includes NatVis visualizations][39843]. These can be used by
6166   WinDbg and Visual Studio to improve the debugging experience.
6167
6168 Compatibility Notes
6169 -------------------
6170
6171 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
6172   workaround, either use MSVC 2015 or run vcvars.bat.
6173 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
6174   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
6175   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
6176   fix.
6177 * [`format!` and `Display::to_string` panic if an underlying formatting
6178   implementation returns an error][40117]. Previously the error was silently
6179   ignored. It is incorrect for `write_fmt` to return an error when writing
6180   to a string.
6181 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
6182   crates were marked stable and could be accessed from the stable toolchain.
6183 * [Rust git source no longer includes vendored crates][39728]. Those that need
6184   to build with vendored crates should build from release tarballs.
6185 * [Fix inert attributes from `proc_macro_derives`][39572]
6186 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
6187   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
6188   build system.
6189 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
6190   existing code generally ignores the type of dead-code unless a type-hint is
6191   provided; this can cause surprising inference interactions particularly around
6192   defaulting. The new code uniformly ignores the result type of dead-code.
6193 * [Tuple-struct constructors with private fields are no longer visible][38932]
6194 * [Lifetime parameters that do not appear in the arguments are now considered
6195   early-bound][38897], resolving a soundness bug (#[32330]). The
6196   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
6197   April of 2016.
6198 * [rustdoc: fix doctests with non-feature crate attributes][38161]
6199 * [Make transmuting from fn item types to pointer-sized types a hard
6200   error][34198]
6201
6202 [27787]: https://github.com/rust-lang/rust/issues/27787
6203 [32330]: https://github.com/rust-lang/rust/issues/32330
6204 [34198]: https://github.com/rust-lang/rust/pull/34198
6205 [38161]: https://github.com/rust-lang/rust/pull/38161
6206 [38368]: https://github.com/rust-lang/rust/pull/38368
6207 [38584]: https://github.com/rust-lang/rust/issues/38584
6208 [38661]: https://github.com/rust-lang/rust/pull/38661
6209 [38764]: https://github.com/rust-lang/rust/pull/38764
6210 [38864]: https://github.com/rust-lang/rust/issues/38864
6211 [38897]: https://github.com/rust-lang/rust/pull/38897
6212 [38921]: https://github.com/rust-lang/rust/pull/38921
6213 [38932]: https://github.com/rust-lang/rust/pull/38932
6214 [38945]: https://github.com/rust-lang/rust/pull/38945
6215 [38981]: https://github.com/rust-lang/rust/pull/38981
6216 [39002]: https://github.com/rust-lang/rust/pull/39002
6217 [39116]: https://github.com/rust-lang/rust/pull/39116
6218 [39193]: https://github.com/rust-lang/rust/pull/39193
6219 [39265]: https://github.com/rust-lang/rust/pull/39265
6220 [39356]: https://github.com/rust-lang/rust/pull/39356
6221 [39372]: https://github.com/rust-lang/rust/pull/39372
6222 [39426]: https://github.com/rust-lang/rust/pull/39426
6223 [39431]: https://github.com/rust-lang/rust/pull/39431
6224 [39438]: https://github.com/rust-lang/rust/pull/39438
6225 [39440]: https://github.com/rust-lang/rust/pull/39440
6226 [39485]: https://github.com/rust-lang/rust/pull/39485
6227 [39491]: https://github.com/rust-lang/rust/pull/39491
6228 [39518]: https://github.com/rust-lang/rust/pull/39518
6229 [39538]: https://github.com/rust-lang/rust/pull/39538
6230 [39572]: https://github.com/rust-lang/rust/pull/39572
6231 [39633]: https://github.com/rust-lang/rust/pull/39633
6232 [39642]: https://github.com/rust-lang/rust/pull/39642
6233 [39728]: https://github.com/rust-lang/rust/pull/39728
6234 [39761]: https://github.com/rust-lang/rust/pull/39761
6235 [39788]: https://github.com/rust-lang/rust/pull/39788
6236 [39793]: https://github.com/rust-lang/rust/pull/39793
6237 [39837]: https://github.com/rust-lang/rust/pull/39837
6238 [39843]: https://github.com/rust-lang/rust/pull/39843
6239 [39851]: https://github.com/rust-lang/rust/pull/39851
6240 [39903]: https://github.com/rust-lang/rust/pull/39903
6241 [39939]: https://github.com/rust-lang/rust/pull/39939
6242 [39953]: https://github.com/rust-lang/rust/pull/39953
6243 [39960]: https://github.com/rust-lang/rust/pull/39960
6244 [39990]: https://github.com/rust-lang/rust/pull/39990
6245 [39995]: https://github.com/rust-lang/rust/pull/39995
6246 [40008]: https://github.com/rust-lang/rust/pull/40008
6247 [40009]: https://github.com/rust-lang/rust/pull/40009
6248 [40027]: https://github.com/rust-lang/rust/pull/40027
6249 [40028]: https://github.com/rust-lang/rust/pull/40028
6250 [40037]: https://github.com/rust-lang/rust/pull/40037
6251 [40117]: https://github.com/rust-lang/rust/pull/40117
6252 [40166]: https://github.com/rust-lang/rust/pull/40166
6253 [40245]: https://github.com/rust-lang/rust/pull/40245
6254 [40257]: https://github.com/rust-lang/rust/pull/40257
6255 [40261]: https://github.com/rust-lang/rust/pull/40261
6256 [40265]: https://github.com/rust-lang/rust/pull/40265
6257 [40319]: https://github.com/rust-lang/rust/pull/40319
6258 [40336]: https://github.com/rust-lang/rust/pull/40336
6259 [40526]: https://github.com/rust-lang/rust/pull/40526
6260 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
6261 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
6262 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
6263 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
6264 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
6265 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
6266 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
6267 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
6268 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
6269 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
6270 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
6271 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
6272 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
6273 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
6274 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
6275 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
6276 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
6277 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
6278 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
6279 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
6280 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
6281 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
6282 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
6283 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
6284 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
6285 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
6286 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
6287 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
6288 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
6289 [ubook]: https://doc.rust-lang.org/unstable-book/
6290
6291
6292 Version 1.16.0 (2017-03-16)
6293 ===========================
6294
6295 Language
6296 --------
6297
6298 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6299 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6300   match patterns][38069]
6301 * [Clean up semantics of `self` in an import list][38313]
6302 * [`Self` may appear in `impl` headers][38920]
6303 * [`Self` may appear in struct expressions][39282]
6304
6305 Compiler
6306 --------
6307
6308 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
6309   a `.rmeta` file containing only crate metadata][38571]. This can be
6310   used by tools like the Rust Language Service to perform
6311   metadata-only builds.
6312 * [Levenshtein based typo suggestions now work in most places, while
6313   previously they worked only for fields and sometimes for local
6314   variables][38927]. Together with the overhaul of "no
6315   resolution"/"unexpected resolution" errors (#[38154]) they result in
6316   large and systematic improvement in resolution diagnostics.
6317 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
6318   `U`][38670]
6319 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
6320 * [`rustc` no longer attempts to provide "consider using an explicit
6321   lifetime" suggestions][37057]. They were inaccurate.
6322
6323 Stabilized APIs
6324 ---------------
6325
6326 * [`VecDeque::truncate`]
6327 * [`VecDeque::resize`]
6328 * [`String::insert_str`]
6329 * [`Duration::checked_add`]
6330 * [`Duration::checked_sub`]
6331 * [`Duration::checked_div`]
6332 * [`Duration::checked_mul`]
6333 * [`str::replacen`]
6334 * [`str::repeat`]
6335 * [`SocketAddr::is_ipv4`]
6336 * [`SocketAddr::is_ipv6`]
6337 * [`IpAddr::is_ipv4`]
6338 * [`IpAddr::is_ipv6`]
6339 * [`Vec::dedup_by`]
6340 * [`Vec::dedup_by_key`]
6341 * [`Result::unwrap_or_default`]
6342 * [`<*const T>::wrapping_offset`]
6343 * [`<*mut T>::wrapping_offset`]
6344 * `CommandExt::creation_flags`
6345 * [`File::set_permissions`]
6346 * [`String::split_off`]
6347
6348 Libraries
6349 ---------
6350
6351 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
6352   their argument by `Borrow` parameter][37761]
6353 * [All public types in std implement `Debug`][38006]
6354 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
6355 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
6356 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6357   Windows][38274]
6358 * [std: Fix partial writes in `LineWriter`][38062]
6359 * [std: Clamp max read/write sizes on Unix][38622]
6360 * [Use more specific panic message for `&str` slicing errors][38066]
6361 * [`TcpListener::set_only_v6` is deprecated][38304]. This
6362   functionality cannot be achieved in std currently.
6363 * [`writeln!`, like `println!`, now accepts a form with no string
6364   or formatting arguments, to just print a newline][38469]
6365 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
6366 * [Reduce the size of static data in `std_unicode::tables`][38781]
6367 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
6368   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
6369   `Display`][38909]
6370 * [`Duration` implements `Sum`][38712]
6371 * [`String` implements `ToSocketAddrs`][39048]
6372
6373 Cargo
6374 -----
6375
6376 * [The `cargo check` command does a type check of a project without
6377   building it][cargo/3296]
6378 * [crates.io will display CI badges from Travis and AppVeyor, if
6379   specified in Cargo.toml][cargo/3546]
6380 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
6381 * [Compilation profiles accept integer values for `debug`, in addition
6382   to `true` and `false`. These are passed to `rustc` as the value to
6383   `-C debuginfo`][cargo/3534]
6384 * [Implement `cargo --version --verbose`][cargo/3604]
6385 * [All builds now output 'dep-info' build dependencies compatible with
6386   make and ninja][cargo/3557]
6387 * [Build all workspace members with `build --all`][cargo/3511]
6388 * [Document all workspace members with `doc --all`][cargo/3515]
6389 * [Path deps outside workspace are not members][cargo/3443]
6390
6391 Misc
6392 ----
6393
6394 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
6395   the path to the Rust implementation][38589]
6396 * [The `armv7-linux-androideabi` target no longer enables NEON
6397   extensions, per Google's ABI guide][38413]
6398 * [The stock standard library can be compiled for Redox OS][38401]
6399 * [Rust has initial SPARC support][38726]. Tier 3. No builds
6400   available.
6401 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
6402   builds available.
6403 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
6404
6405 Compatibility Notes
6406 -------------------
6407
6408 * [Uninhabitable enums (those without any variants) no longer permit wildcard
6409   match patterns][38069]
6410 * In this release, references to uninhabited types can not be
6411   pattern-matched. This was accidentally allowed in 1.15.
6412 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
6413 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
6414   Windows][38274]
6415 * [Clean up semantics of `self` in an import list][38313]
6416 * Reimplemented lifetime elision. This change was almost entirely compatible
6417   with existing code, but it did close a number of small bugs and loopholes,
6418   as well as being more accepting in some other [cases][41105].
6419
6420 [37057]: https://github.com/rust-lang/rust/pull/37057
6421 [37761]: https://github.com/rust-lang/rust/pull/37761
6422 [38006]: https://github.com/rust-lang/rust/pull/38006
6423 [38051]: https://github.com/rust-lang/rust/pull/38051
6424 [38062]: https://github.com/rust-lang/rust/pull/38062
6425 [38622]: https://github.com/rust-lang/rust/pull/38622
6426 [38066]: https://github.com/rust-lang/rust/pull/38066
6427 [38069]: https://github.com/rust-lang/rust/pull/38069
6428 [38131]: https://github.com/rust-lang/rust/pull/38131
6429 [38154]: https://github.com/rust-lang/rust/pull/38154
6430 [38274]: https://github.com/rust-lang/rust/pull/38274
6431 [38304]: https://github.com/rust-lang/rust/pull/38304
6432 [38313]: https://github.com/rust-lang/rust/pull/38313
6433 [38327]: https://github.com/rust-lang/rust/pull/38327
6434 [38401]: https://github.com/rust-lang/rust/pull/38401
6435 [38413]: https://github.com/rust-lang/rust/pull/38413
6436 [38469]: https://github.com/rust-lang/rust/pull/38469
6437 [38559]: https://github.com/rust-lang/rust/pull/38559
6438 [38571]: https://github.com/rust-lang/rust/pull/38571
6439 [38580]: https://github.com/rust-lang/rust/pull/38580
6440 [38589]: https://github.com/rust-lang/rust/pull/38589
6441 [38670]: https://github.com/rust-lang/rust/pull/38670
6442 [38712]: https://github.com/rust-lang/rust/pull/38712
6443 [38726]: https://github.com/rust-lang/rust/pull/38726
6444 [38781]: https://github.com/rust-lang/rust/pull/38781
6445 [38798]: https://github.com/rust-lang/rust/pull/38798
6446 [38909]: https://github.com/rust-lang/rust/pull/38909
6447 [38920]: https://github.com/rust-lang/rust/pull/38920
6448 [38927]: https://github.com/rust-lang/rust/pull/38927
6449 [39048]: https://github.com/rust-lang/rust/pull/39048
6450 [39282]: https://github.com/rust-lang/rust/pull/39282
6451 [39379]: https://github.com/rust-lang/rust/pull/39379
6452 [41105]: https://github.com/rust-lang/rust/issues/41105
6453 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6454 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
6455 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
6456 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
6457 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
6458 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
6459 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
6460 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
6461 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
6462 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
6463 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
6464 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
6465 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
6466 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
6467 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
6468 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
6469 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
6470 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
6471 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
6472 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
6473 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
6474 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
6475 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
6476 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
6477 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
6478 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
6479 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
6480 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
6481 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
6482
6483
6484 Version 1.15.1 (2017-02-09)
6485 ===========================
6486
6487 * [Fix IntoIter::as_mut_slice's signature][39466]
6488 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
6489
6490 [39466]: https://github.com/rust-lang/rust/pull/39466
6491 [39523]: https://github.com/rust-lang/rust/pull/39523
6492
6493
6494 Version 1.15.0 (2017-02-02)
6495 ===========================
6496
6497 Language
6498 --------
6499
6500 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
6501   stable. This allows popular code-generating crates like Serde and Diesel to
6502   work ergonomically. [RFC 1681].
6503 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
6504   with curly braces][36868]. Part of [RFC 1506].
6505 * [A number of minor changes to name resolution have been activated][37127].
6506   They add up to more consistent semantics, allowing for future evolution of
6507   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6508   details of what is different. The breaking changes here have been transitioned
6509   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6510 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
6511   bounds][38279]
6512 * [`?Sized` can be used in `where` clauses][37791]
6513 * [There is now a limit on the size of monomorphized types and it can be
6514   modified with the `#![type_size_limit]` crate attribute, similarly to
6515   the `#![recursion_limit]` attribute][37789]
6516
6517 Compiler
6518 --------
6519
6520 * [On Windows, the compiler will apply dllimport attributes when linking to
6521   extern functions][37973]. Additional attributes and flags can control which
6522   library kind is linked and its name. [RFC 1717].
6523 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6524 * [The `--test` flag works with procedural macro crates][38107]
6525 * [Fix `extern "aapcs" fn` ABI][37814]
6526 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
6527 * [The `format!` expander recognizes incorrect `printf` and shell-style
6528   formatting directives and suggests the correct format][37613].
6529 * [Only report one error for all unused imports in an import list][37456]
6530
6531 Compiler Performance
6532 --------------------
6533
6534 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
6535 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
6536 * [Don't clone in `UnificationTable::probe`][37848]
6537 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
6538 * [Use small vectors in type walker][37760]
6539 * [Macro expansion performance was improved][37701]
6540 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
6541 * [Replace FNV with a faster hash function][37229]
6542
6543 Stabilized APIs
6544 ---------------
6545
6546 * [`std::iter::Iterator::min_by`]
6547 * [`std::iter::Iterator::max_by`]
6548 * [`std::os::*::fs::FileExt`]
6549 * [`std::sync::atomic::Atomic*::get_mut`]
6550 * [`std::sync::atomic::Atomic*::into_inner`]
6551 * [`std::vec::IntoIter::as_slice`]
6552 * [`std::vec::IntoIter::as_mut_slice`]
6553 * [`std::sync::mpsc::Receiver::try_iter`]
6554 * [`std::os::unix::process::CommandExt::before_exec`]
6555 * [`std::rc::Rc::strong_count`]
6556 * [`std::rc::Rc::weak_count`]
6557 * [`std::sync::Arc::strong_count`]
6558 * [`std::sync::Arc::weak_count`]
6559 * [`std::char::encode_utf8`]
6560 * [`std::char::encode_utf16`]
6561 * [`std::cell::Ref::clone`]
6562 * [`std::io::Take::into_inner`]
6563
6564 Libraries
6565 ---------
6566
6567 * [The standard sorting algorithm has been rewritten for dramatic performance
6568   improvements][38192]. It is a hybrid merge sort, drawing influences from
6569   Timsort. Previously it was a naive merge sort.
6570 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6571 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6572   performance.
6573 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6574   and `char_indices().last()`][37882]
6575 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6576 * [Chinese characters display correctly in `fmt::Debug`][37855]
6577 * [Derive `Default` for `Duration`][37699]
6578 * [Support creation of anonymous pipes on WinXP/2k][37677]
6579 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6580 * [Don't pass overlapped handles to processes][38835]
6581
6582 Cargo
6583 -----
6584
6585 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6586   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6587   should instead check the variable at runtime with `std::env`. That the value
6588   was set at build time was a bug, and incorrect when cross-compiling. This
6589   change is known to cause breakage.
6590 * [Add `--all` flag to `cargo test`][cargo/3221]
6591 * [Compile statically against the MSVC CRT][cargo/3363]
6592 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6593 * [Link OpenSSL statically on OSX][cargo/3311]
6594 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6595 * [Test for bad path overrides with summaries][cargo/3336]
6596 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6597 * [Fix retrying crate downloads for network errors][cargo/3348]
6598 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6599 * [Emit more info on --message-format=json][cargo/3319]
6600 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6601 * [Don't ignore errors in workspace manifest][cargo/3409]
6602 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6603
6604 Tooling
6605 -------
6606
6607 * [Test runners (binaries built with `--test`) now support a `--list` argument
6608   that lists the tests it contains][38185]
6609 * [Test runners now support a `--exact` argument that makes the test filter
6610   match exactly, instead of matching only a substring of the test name][38181]
6611 * [rustdoc supports a `--playground-url` flag][37763]
6612 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6613
6614 Misc
6615 ----
6616
6617 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6618   continue to be used in this release by passing `--disable-rustbuild` to the
6619   configure script, but they will be deleted soon. Note that the new build
6620   system uses a different on-disk layout that will likely affect any scripts
6621   building Rust.
6622 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6623   releases.
6624 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6625 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6626   releases.
6627
6628 Compatibility Notes
6629 -------------------
6630
6631 * [A number of minor changes to name resolution have been activated][37127].
6632   They add up to more consistent semantics, allowing for future evolution of
6633   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6634   details of what is different. The breaking changes here have been transitioned
6635   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6636 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6637   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6638   should instead check the variable at runtime with `std::env`. That the value
6639   was set at build time was a bug, and incorrect when cross-compiling. This
6640   change is known to cause breakage.
6641 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6642   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6643   1.10 and is now an error by default. It will become a hard error in the near
6644   future.
6645 * [The semantics relating modules to file system directories are changing in
6646   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6647   lint, which is a warning in this release, and will become a hard error in the
6648   future.
6649 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6650 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6651   the underlying iterator][37834]
6652
6653 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6654 [33685]: https://github.com/rust-lang/rust/issues/33685
6655 [36868]: https://github.com/rust-lang/rust/pull/36868
6656 [37127]: https://github.com/rust-lang/rust/pull/37127
6657 [37229]: https://github.com/rust-lang/rust/pull/37229
6658 [37456]: https://github.com/rust-lang/rust/pull/37456
6659 [37527]: https://github.com/rust-lang/rust/pull/37527
6660 [37602]: https://github.com/rust-lang/rust/pull/37602
6661 [37613]: https://github.com/rust-lang/rust/pull/37613
6662 [37615]: https://github.com/rust-lang/rust/pull/37615
6663 [37636]: https://github.com/rust-lang/rust/pull/37636
6664 [37627]: https://github.com/rust-lang/rust/pull/37627
6665 [37642]: https://github.com/rust-lang/rust/pull/37642
6666 [37677]: https://github.com/rust-lang/rust/pull/37677
6667 [37699]: https://github.com/rust-lang/rust/pull/37699
6668 [37701]: https://github.com/rust-lang/rust/pull/37701
6669 [37705]: https://github.com/rust-lang/rust/pull/37705
6670 [37749]: https://github.com/rust-lang/rust/pull/37749
6671 [37760]: https://github.com/rust-lang/rust/pull/37760
6672 [37763]: https://github.com/rust-lang/rust/pull/37763
6673 [37764]: https://github.com/rust-lang/rust/pull/37764
6674 [37789]: https://github.com/rust-lang/rust/pull/37789
6675 [37791]: https://github.com/rust-lang/rust/pull/37791
6676 [37814]: https://github.com/rust-lang/rust/pull/37814
6677 [37817]: https://github.com/rust-lang/rust/pull/37817
6678 [37834]: https://github.com/rust-lang/rust/pull/37834
6679 [37848]: https://github.com/rust-lang/rust/pull/37848
6680 [37855]: https://github.com/rust-lang/rust/pull/37855
6681 [37882]: https://github.com/rust-lang/rust/pull/37882
6682 [37888]: https://github.com/rust-lang/rust/pull/37888
6683 [37973]: https://github.com/rust-lang/rust/pull/37973
6684 [37979]: https://github.com/rust-lang/rust/pull/37979
6685 [38086]: https://github.com/rust-lang/rust/pull/38086
6686 [38107]: https://github.com/rust-lang/rust/pull/38107
6687 [38117]: https://github.com/rust-lang/rust/pull/38117
6688 [38134]: https://github.com/rust-lang/rust/pull/38134
6689 [38146]: https://github.com/rust-lang/rust/pull/38146
6690 [38181]: https://github.com/rust-lang/rust/pull/38181
6691 [38182]: https://github.com/rust-lang/rust/pull/38182
6692 [38185]: https://github.com/rust-lang/rust/pull/38185
6693 [38192]: https://github.com/rust-lang/rust/pull/38192
6694 [38279]: https://github.com/rust-lang/rust/pull/38279
6695 [38835]: https://github.com/rust-lang/rust/pull/38835
6696 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6697 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6698 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6699 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6700 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6701 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6702 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6703 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6704 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6705 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6706 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6707 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6708 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6709 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6710 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6711 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6712 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6713 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6714 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6715 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6716 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6717 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6718 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6719 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6720 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6721 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6722 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6723 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6724 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6725 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6726 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6727 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6728 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6729 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6730 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6731 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6732 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6733
6734
6735 Version 1.14.0 (2016-12-22)
6736 ===========================
6737
6738 Language
6739 --------
6740
6741 * [`..` matches multiple tuple fields in enum variants, structs
6742   and tuples][36843]. [RFC 1492].
6743 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6744 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6745 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6746   dereferencing][36822]
6747
6748 Compiler
6749 --------
6750
6751 * [Mark enums with non-zero discriminant as non-zero][37224]
6752 * [Lower-case `static mut` names are linted like other
6753   statics and consts][37162]
6754 * [Fix ICE on some macros in const integer positions
6755    (e.g. `[u8; m!()]`)][36819]
6756 * [Improve error message and snippet for "did you mean `x`"][36798]
6757 * [Add a panic-strategy field to the target specification][36794]
6758 * [Include LLVM version in `--version --verbose`][37200]
6759
6760 Compile-time Optimizations
6761 --------------------------
6762
6763 * [Improve macro expansion performance][37569]
6764 * [Shrink `Expr_::ExprInlineAsm`][37445]
6765 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6766 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6767 * [Avoid more allocations when compiling html5ever][37373]
6768 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6769 * [Avoid some allocations in the macro parser][37318]
6770 * [Use a faster deflate setting][37298]
6771 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6772   during interning of slices][37270]
6773 * [Optimize `write_metadata`][37267]
6774 * [Don't process obligation forest cycles when stalled][37231]
6775 * [Avoid many `CrateConfig` clones][37161]
6776 * [Optimize `Substs::super_fold_with`][37108]
6777 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6778 * [Speed up `plug_leaks`][36917]
6779
6780 Libraries
6781 ---------
6782
6783 * [`println!()`, with no arguments, prints newline][36825].
6784   Previously, an empty string was required to achieve the same.
6785 * [`Wrapping` impls standard binary and unary operators, as well as
6786    the `Sum` and `Product` iterators][37356]
6787 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6788   Vec<T>`][37326]
6789 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6790   `VecDeque` iterators][37315]
6791 * [Improve `SipHasher` performance on small values][37312]
6792 * [Add Iterator trait TrustedLen to enable better FromIterator /
6793   Extend][37306]
6794 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6795 * [`ReadDir` implements `Debug`][37221]
6796 * [Implement `RefUnwindSafe` for atomic types][37178]
6797 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6798 * [Avoid allocations in `Decoder::read_str`][37064]
6799 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6800 * [Impl `Debug` for raw pointers to unsized data][36880]
6801 * [Don't reuse `HashMap` random seeds][37470]
6802 * [The internal memory layout of `HashMap` is more cache-friendly, for
6803   significant improvements in some operations][36692]
6804 * [`HashMap` uses less memory on 32-bit architectures][36595]
6805 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6806
6807 Cargo
6808 -----
6809
6810 * [Expose rustc cfg values to build scripts][cargo/3243]
6811 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6812 * [Fix passing --features when testing multiple packages][cargo/3280]
6813 * [Use a single profile set per workspace][cargo/3249]
6814 * [Load `replace` sections from lock files][cargo/3220]
6815 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6816
6817 Tooling
6818 -------
6819
6820 * [rustup is the recommended Rust installation method][1.14rustup]
6821 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6822   S390x. These are [tier 2] platforms and may have major defects. Follow the
6823   instructions on the website to install, or add the targets to an existing
6824   installation with `rustup target add`. The new target triples are:
6825   - `mips-unknown-linux-gnu`
6826   - `mipsel-unknown-linux-gnu`
6827   - `mips64-unknown-linux-gnuabi64`
6828   - `mips64el-unknown-linux-gnuabi64 `
6829   - `powerpc-unknown-linux-gnu`
6830   - `powerpc64-unknown-linux-gnu`
6831   - `powerpc64le-unknown-linux-gnu`
6832   - `s390x-unknown-linux-gnu `
6833 * This release includes target (std) builds for ARM Linux running MUSL
6834   libc. These are [tier 2] platforms and may have major defects. Add the
6835   following triples to an existing rustup installation with `rustup target add`:
6836   - `arm-unknown-linux-musleabi`
6837   - `arm-unknown-linux-musleabihf`
6838   - `armv7-unknown-linux-musleabihf`
6839 * This release includes [experimental support for WebAssembly][1.14wasm], via
6840   the `wasm32-unknown-emscripten` target. This target is known to have major
6841   defects. Please test, report, and fix.
6842 * rustup no longer installs documentation by default. Run `rustup
6843   component add rust-docs` to install.
6844 * [Fix line stepping in debugger][37310]
6845 * [Enable line number debuginfo in releases][37280]
6846
6847 Misc
6848 ----
6849
6850 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6851 * [Add support for Fuchsia OS][37313]
6852 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6853
6854 Compatibility Notes
6855 -------------------
6856
6857 * [A number of forward-compatibility lints used by the compiler
6858   to gradually introduce language changes have been converted
6859   to deny by default][36894]:
6860   - ["use of inaccessible extern crate erroneously allowed"][36886]
6861   - ["type parameter default erroneously allowed in invalid location"][36887]
6862   - ["detects super or self keywords at the beginning of global path"][36888]
6863   - ["two overlapping inherent impls define an item with the same name
6864     were erroneously allowed"][36889]
6865   - ["floating-point constants cannot be used in patterns"][36890]
6866   - ["constants of struct or enum type can only be used in a pattern if
6867      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6868   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6869 * [Prohibit patterns in trait methods without bodies][37378]
6870 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6871 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6872 * [The `$crate` macro variable is accepted in fewer locations][37213]
6873 * [Impls specifying extra region requirements beyond the trait
6874   they implement are rejected][37167]
6875 * [Enums may not be unsized][37111]. Unsized enums are intended to
6876   work but never have. For now they are forbidden.
6877 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6878
6879 [tier 2]: https://forge.rust-lang.org/platform-support.html
6880 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6881 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6882 [36430]: https://github.com/rust-lang/rust/pull/36430
6883 [36595]: https://github.com/rust-lang/rust/pull/36595
6884 [36692]: https://github.com/rust-lang/rust/pull/36692
6885 [36767]: https://github.com/rust-lang/rust/pull/36767
6886 [36794]: https://github.com/rust-lang/rust/pull/36794
6887 [36798]: https://github.com/rust-lang/rust/pull/36798
6888 [36819]: https://github.com/rust-lang/rust/pull/36819
6889 [36822]: https://github.com/rust-lang/rust/pull/36822
6890 [36825]: https://github.com/rust-lang/rust/pull/36825
6891 [36843]: https://github.com/rust-lang/rust/pull/36843
6892 [36880]: https://github.com/rust-lang/rust/pull/36880
6893 [36886]: https://github.com/rust-lang/rust/issues/36886
6894 [36887]: https://github.com/rust-lang/rust/issues/36887
6895 [36888]: https://github.com/rust-lang/rust/issues/36888
6896 [36889]: https://github.com/rust-lang/rust/issues/36889
6897 [36890]: https://github.com/rust-lang/rust/issues/36890
6898 [36891]: https://github.com/rust-lang/rust/issues/36891
6899 [36892]: https://github.com/rust-lang/rust/issues/36892
6900 [36894]: https://github.com/rust-lang/rust/pull/36894
6901 [36917]: https://github.com/rust-lang/rust/pull/36917
6902 [36993]: https://github.com/rust-lang/rust/pull/36993
6903 [37037]: https://github.com/rust-lang/rust/pull/37037
6904 [37064]: https://github.com/rust-lang/rust/pull/37064
6905 [37094]: https://github.com/rust-lang/rust/pull/37094
6906 [37108]: https://github.com/rust-lang/rust/pull/37108
6907 [37111]: https://github.com/rust-lang/rust/pull/37111
6908 [37161]: https://github.com/rust-lang/rust/pull/37161
6909 [37162]: https://github.com/rust-lang/rust/pull/37162
6910 [37167]: https://github.com/rust-lang/rust/pull/37167
6911 [37178]: https://github.com/rust-lang/rust/pull/37178
6912 [37200]: https://github.com/rust-lang/rust/pull/37200
6913 [37213]: https://github.com/rust-lang/rust/pull/37213
6914 [37221]: https://github.com/rust-lang/rust/pull/37221
6915 [37224]: https://github.com/rust-lang/rust/pull/37224
6916 [37230]: https://github.com/rust-lang/rust/pull/37230
6917 [37231]: https://github.com/rust-lang/rust/pull/37231
6918 [37247]: https://github.com/rust-lang/rust/pull/37247
6919 [37267]: https://github.com/rust-lang/rust/pull/37267
6920 [37270]: https://github.com/rust-lang/rust/pull/37270
6921 [37273]: https://github.com/rust-lang/rust/pull/37273
6922 [37280]: https://github.com/rust-lang/rust/pull/37280
6923 [37298]: https://github.com/rust-lang/rust/pull/37298
6924 [37306]: https://github.com/rust-lang/rust/pull/37306
6925 [37310]: https://github.com/rust-lang/rust/pull/37310
6926 [37312]: https://github.com/rust-lang/rust/pull/37312
6927 [37313]: https://github.com/rust-lang/rust/pull/37313
6928 [37315]: https://github.com/rust-lang/rust/pull/37315
6929 [37318]: https://github.com/rust-lang/rust/pull/37318
6930 [37322]: https://github.com/rust-lang/rust/pull/37322
6931 [37326]: https://github.com/rust-lang/rust/pull/37326
6932 [37351]: https://github.com/rust-lang/rust/pull/37351
6933 [37356]: https://github.com/rust-lang/rust/pull/37356
6934 [37367]: https://github.com/rust-lang/rust/pull/37367
6935 [37373]: https://github.com/rust-lang/rust/pull/37373
6936 [37378]: https://github.com/rust-lang/rust/pull/37378
6937 [37389]: https://github.com/rust-lang/rust/pull/37389
6938 [37392]: https://github.com/rust-lang/rust/pull/37392
6939 [37427]: https://github.com/rust-lang/rust/pull/37427
6940 [37439]: https://github.com/rust-lang/rust/pull/37439
6941 [37445]: https://github.com/rust-lang/rust/pull/37445
6942 [37470]: https://github.com/rust-lang/rust/pull/37470
6943 [37569]: https://github.com/rust-lang/rust/pull/37569
6944 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6945 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6946 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6947 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6948 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6949 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6950 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6951
6952
6953 Version 1.13.0 (2016-11-10)
6954 ===========================
6955
6956 Language
6957 --------
6958
6959 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6960   errors, like the `try!` macro, described in [RFC 0243].
6961 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6962 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6963 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6964 * [Fix lifetime rules for 'if' conditions][36029]
6965 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6966
6967 Compiler
6968 --------
6969
6970 * [Add the `-C link-arg` argument][36574]
6971 * [Remove the old AST-based backend from rustc_trans][35764]
6972 * [Don't enable NEON by default on armv7 Linux][35814]
6973 * [Fix debug line number info for macro expansions][35238]
6974 * [Do not emit "class method" debuginfo for types that are not
6975   DICompositeType][36008]
6976 * [Warn about multiple conflicting #[repr] hints][34623]
6977 * [When sizing DST, don't double-count nested struct prefixes][36351]
6978 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6979 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6980 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6981 * [Expand macros without recursing to avoid stack overflows][36214]
6982
6983 Diagnostics
6984 -----------
6985
6986 * [Replace macro backtraces with labeled local uses][35702]
6987 * [Improve error message for misplaced doc comments][33922]
6988 * [Buffer unix and lock windows to prevent message interleaving][35975]
6989 * [Update lifetime errors to specifically note temporaries][36171]
6990 * [Special case a few colors for Windows][36178]
6991 * [Suggest `use self` when such an import resolves][36289]
6992 * [Be more specific when type parameter shadows primitive type][36338]
6993 * Many minor improvements
6994
6995 Compile-time Optimizations
6996 --------------------------
6997
6998 * [Compute and cache HIR hashes at beginning][35854]
6999 * [Don't hash types in loan paths][36004]
7000 * [Cache projections in trans][35761]
7001 * [Optimize the parser's last token handling][36527]
7002 * [Only instantiate #[inline] functions in codegen units referencing
7003   them][36524]. This leads to big improvements in cases where crates export
7004   define many inline functions without using them directly.
7005 * [Lazily allocate TypedArena's first chunk][36592]
7006 * [Don't allocate during default HashSet creation][36734]
7007
7008 Stabilized APIs
7009 ---------------
7010
7011 * [`checked_abs`]
7012 * [`wrapping_abs`]
7013 * [`overflowing_abs`]
7014 * [`RefCell::try_borrow`]
7015 * [`RefCell::try_borrow_mut`]
7016
7017 Libraries
7018 ---------
7019
7020 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
7021 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
7022   covariant][35354]
7023 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
7024 * [Implement `Debug` for `std::vec::IntoIter`][35707]
7025 * [`CString`: avoid excessive growth just to 0-terminate][35871]
7026 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
7027 * [Use arc4rand on FreeBSD][35884]
7028 * [memrchr: Correct aligned offset computation][35969]
7029 * [Improve Demangling of Rust Symbols][36059]
7030 * [Use monotonic time in condition variables][35048]
7031 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
7032 * [Implement conversion traits for `char`][35755]
7033 * [Fix illegal instruction caused by overflow in channel cloning][36104]
7034 * [Zero first byte of CString on drop][36264]
7035 * [Inherit overflow checks for sum and product][36372]
7036 * [Add missing Eq implementations][36423]
7037 * [Implement `Debug` for `DirEntry`][36631]
7038 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
7039   `errno`][36754]
7040 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7041 * [Implement more traits for `std::io::ErrorKind`][35911]
7042 * [Optimize BinaryHeap bounds checking][36072]
7043 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
7044   `extend_with_element`][36355]
7045 * [Fix overflow checking in unsigned pow()][34942]
7046
7047 Cargo
7048 -----
7049
7050 * This release includes security fixes to both curl and OpenSSL.
7051 * [Fix transitive doctests when panic=abort][cargo/3021]
7052 * [Add --all-features flag to cargo][cargo/3038]
7053 * [Reject path-based dependencies in `cargo package`][cargo/3060]
7054 * [Don't parse the home directory more than once][cargo/3078]
7055 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
7056 * [Update OpenSSL to 1.0.2j][cargo/3121]
7057 * [Add license and license_file to cargo metadata output][cargo/3110]
7058 * [Make crates-io registry URL optional in config; ignore all changes to
7059   source.crates-io][cargo/3089]
7060 * [Don't download dependencies from other platforms][cargo/3123]
7061 * [Build transitive dev-dependencies when needed][cargo/3125]
7062 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
7063 * [Avoid updating registry when adding existing deps][cargo/3144]
7064 * [Warn about path overrides that won't work][cargo/3136]
7065 * [Use workspaces during `cargo install`][cargo/3146]
7066 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
7067 * [Add --message-format flag][cargo/3000]
7068 * [Pass target environment for rustdoc][cargo/3205]
7069 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
7070 * [Update curl and curl-sys][cargo/3241]
7071 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
7072
7073 Tooling
7074 -------
7075
7076 * [rustdoc: Add the `--sysroot` argument][36586]
7077 * [rustdoc: Fix a couple of issues with the search results][35655]
7078 * [rustdoc: remove the `!` from macro URLs and titles][35234]
7079 * [gdb: Fix pretty-printing special-cased Rust types][35585]
7080 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
7081
7082 Misc
7083 ----
7084
7085 * [Remove unmaintained style guide][35124]
7086 * [Add s390x support][36369]
7087 * [Initial work at Haiku OS support][36727]
7088 * [Add mips-uclibc targets][35734]
7089 * [Crate-ify compiler-rt into compiler-builtins][35021]
7090 * [Add rustc version info (git hash + date) to dist tarball][36213]
7091 * Many documentation improvements
7092
7093 Compatibility Notes
7094 -------------------
7095
7096 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
7097 * [Deny (by default) transmuting from fn item types to pointer-sized
7098   types][34923]. Continuing the long transition to zero-sized fn items,
7099   per [RFC 401].
7100 * [Fix `#[derive]` for empty tuple structs/variants][35728].
7101   Part of [RFC 1506].
7102 * [Issue deprecation warnings for safe accesses to extern statics][36173]
7103 * [Fix lifetime rules for 'if' conditions][36029].
7104 * [Inherit overflow checks for sum and product][36372].
7105 * [Forbid user-defined macros named "macro_rules"][36730].
7106
7107 [33922]: https://github.com/rust-lang/rust/pull/33922
7108 [34623]: https://github.com/rust-lang/rust/pull/34623
7109 [34923]: https://github.com/rust-lang/rust/pull/34923
7110 [34942]: https://github.com/rust-lang/rust/pull/34942
7111 [35021]: https://github.com/rust-lang/rust/pull/35021
7112 [35048]: https://github.com/rust-lang/rust/pull/35048
7113 [35074]: https://github.com/rust-lang/rust/pull/35074
7114 [35124]: https://github.com/rust-lang/rust/pull/35124
7115 [35234]: https://github.com/rust-lang/rust/pull/35234
7116 [35238]: https://github.com/rust-lang/rust/pull/35238
7117 [35354]: https://github.com/rust-lang/rust/pull/35354
7118 [35559]: https://github.com/rust-lang/rust/pull/35559
7119 [35585]: https://github.com/rust-lang/rust/pull/35585
7120 [35627]: https://github.com/rust-lang/rust/pull/35627
7121 [35655]: https://github.com/rust-lang/rust/pull/35655
7122 [35702]: https://github.com/rust-lang/rust/pull/35702
7123 [35707]: https://github.com/rust-lang/rust/pull/35707
7124 [35728]: https://github.com/rust-lang/rust/pull/35728
7125 [35734]: https://github.com/rust-lang/rust/pull/35734
7126 [35755]: https://github.com/rust-lang/rust/pull/35755
7127 [35761]: https://github.com/rust-lang/rust/pull/35761
7128 [35764]: https://github.com/rust-lang/rust/pull/35764
7129 [35814]: https://github.com/rust-lang/rust/pull/35814
7130 [35854]: https://github.com/rust-lang/rust/pull/35854
7131 [35871]: https://github.com/rust-lang/rust/pull/35871
7132 [35884]: https://github.com/rust-lang/rust/pull/35884
7133 [35911]: https://github.com/rust-lang/rust/pull/35911
7134 [35969]: https://github.com/rust-lang/rust/pull/35969
7135 [35975]: https://github.com/rust-lang/rust/pull/35975
7136 [36004]: https://github.com/rust-lang/rust/pull/36004
7137 [36008]: https://github.com/rust-lang/rust/pull/36008
7138 [36014]: https://github.com/rust-lang/rust/pull/36014
7139 [36029]: https://github.com/rust-lang/rust/pull/36029
7140 [36059]: https://github.com/rust-lang/rust/pull/36059
7141 [36072]: https://github.com/rust-lang/rust/pull/36072
7142 [36101]: https://github.com/rust-lang/rust/pull/36101
7143 [36104]: https://github.com/rust-lang/rust/pull/36104
7144 [36171]: https://github.com/rust-lang/rust/pull/36171
7145 [36173]: https://github.com/rust-lang/rust/pull/36173
7146 [36178]: https://github.com/rust-lang/rust/pull/36178
7147 [36213]: https://github.com/rust-lang/rust/pull/36213
7148 [36214]: https://github.com/rust-lang/rust/pull/36214
7149 [36264]: https://github.com/rust-lang/rust/pull/36264
7150 [36266]: https://github.com/rust-lang/rust/pull/36266
7151 [36289]: https://github.com/rust-lang/rust/pull/36289
7152 [36338]: https://github.com/rust-lang/rust/pull/36338
7153 [36351]: https://github.com/rust-lang/rust/pull/36351
7154 [36355]: https://github.com/rust-lang/rust/pull/36355
7155 [36369]: https://github.com/rust-lang/rust/pull/36369
7156 [36372]: https://github.com/rust-lang/rust/pull/36372
7157 [36423]: https://github.com/rust-lang/rust/pull/36423
7158 [36482]: https://github.com/rust-lang/rust/pull/36482
7159 [36505]: https://github.com/rust-lang/rust/pull/36505
7160 [36524]: https://github.com/rust-lang/rust/pull/36524
7161 [36527]: https://github.com/rust-lang/rust/pull/36527
7162 [36551]: https://github.com/rust-lang/rust/pull/36551
7163 [36574]: https://github.com/rust-lang/rust/pull/36574
7164 [36586]: https://github.com/rust-lang/rust/pull/36586
7165 [36592]: https://github.com/rust-lang/rust/pull/36592
7166 [36631]: https://github.com/rust-lang/rust/pull/36631
7167 [36721]: https://github.com/rust-lang/rust/pull/36721
7168 [36727]: https://github.com/rust-lang/rust/pull/36727
7169 [36730]: https://github.com/rust-lang/rust/pull/36730
7170 [36734]: https://github.com/rust-lang/rust/pull/36734
7171 [36754]: https://github.com/rust-lang/rust/pull/36754
7172 [36995]: https://github.com/rust-lang/rust/pull/36995
7173 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
7174 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
7175 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
7176 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
7177 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
7178 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
7179 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
7180 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
7181 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
7182 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
7183 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
7184 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
7185 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
7186 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
7187 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
7188 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
7189 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
7190 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
7191 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
7192 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
7193 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
7194 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
7195 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
7196 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
7197 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
7198 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
7199 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
7200 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
7201 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
7202 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
7203 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
7204 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
7205
7206
7207 Version 1.12.1 (2016-10-20)
7208 ===========================
7209
7210 Regression Fixes
7211 ----------------
7212
7213 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
7214 * [Confusion with double negation and booleans][36856]
7215 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
7216 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
7217 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
7218 * [Corrupted memory after updated to 1.12][36936]
7219 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
7220 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
7221 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
7222
7223 [36381]: https://github.com/rust-lang/rust/issues/36381
7224 [36856]: https://github.com/rust-lang/rust/issues/36856
7225 [36875]: https://github.com/rust-lang/rust/issues/36875
7226 [36924]: https://github.com/rust-lang/rust/issues/36924
7227 [36926]: https://github.com/rust-lang/rust/issues/36926
7228 [36936]: https://github.com/rust-lang/rust/issues/36936
7229 [37026]: https://github.com/rust-lang/rust/issues/37026
7230 [37112]: https://github.com/rust-lang/rust/issues/37112
7231 [37153]: https://github.com/rust-lang/rust/issues/37153
7232
7233
7234 Version 1.12.0 (2016-09-29)
7235 ===========================
7236
7237 Highlights
7238 ----------
7239
7240 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7241   This translation pass is far simpler than the previous AST->LLVM pass, and
7242   creates opportunities to perform new optimizations directly on the MIR. It
7243   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7244 * [`rustc` presents a new, more readable error format, along with
7245   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7246   Most common editors supporting Rust have been updated to work with it. It was
7247   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7248
7249 Compiler
7250 --------
7251
7252 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
7253   This translation pass is far simpler than the previous AST->LLVM pass, and
7254   creates opportunities to perform new optimizations directly on the MIR. It
7255   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
7256 * [Print the Rust target name, not the LLVM target name, with
7257   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
7258 * [The computation of `TypeId` is correct in some cases where it was previously
7259   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
7260 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
7261 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
7262   `--print relocation-models`, and `--print code-models` print the available
7263   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
7264   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
7265 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
7266   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
7267   These targets produce statically-linked binaries. There are no binary release
7268   builds yet though.
7269
7270 Diagnostics
7271 -----------
7272
7273 * [`rustc` presents a new, more readable error format, along with
7274   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
7275   Most common editors supporting Rust have been updated to work with it. It was
7276   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
7277 * [In error descriptions, references are now described in plain English,
7278   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
7279 * [In error type descriptions, unknown numeric types are named `{integer}` or
7280   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
7281 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
7282
7283 Language
7284 --------
7285
7286 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
7287 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
7288 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
7289   useful](https://github.com/rust-lang/rust/pull/34908)
7290 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
7291   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
7292 * [Semicolons are properly required as statement delimiters inside
7293   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
7294 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
7295
7296 Stabilized APIs
7297 ---------------
7298
7299 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
7300 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
7301 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
7302 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
7303 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
7304 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
7305 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
7306 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
7307 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
7308 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
7309   Both on Unix and Windows.
7310 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
7311 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
7312 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
7313 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
7314 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
7315 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
7316 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
7317 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
7318
7319 Libraries
7320 ---------
7321
7322 * [The `format!` macro and friends now allow a single argument to be formatted
7323   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
7324 * [The lifetime bounds on `[T]::binary_search_by` and
7325   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
7326 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
7327 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
7328 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
7329 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
7330 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
7331 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
7332 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
7333 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
7334   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
7335 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
7336   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
7337 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
7338 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
7339   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
7340 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
7341 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
7342 * [`mpsc::sync_channel` `Receiver`s return any available message before
7343   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
7344 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
7345 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
7346
7347 Cargo
7348 -----
7349
7350 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
7351 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
7352 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
7353 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
7354 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
7355 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
7356 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
7357 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
7358 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
7359 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
7360 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
7361 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
7362 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
7363 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
7364 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
7365 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
7366
7367 Performance
7368 -----------
7369
7370 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
7371 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
7372
7373 Tooling
7374 -------
7375
7376 * [Test binaries now support a `--test-threads` argument to specify the number
7377   of threads used to run tests, and which acts the same as the
7378   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
7379 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
7380 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
7381 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7382 * [Rust releases now come with source packages that can be installed by rustup
7383   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
7384   The resulting source code can be used by tools and IDES, located in the
7385   sysroot under `lib/rustlib/src`.
7386
7387 Misc
7388 ----
7389
7390 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
7391 * Many minor improvements to the documentation.
7392 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
7393
7394 Compatibility Notes
7395 -------------------
7396
7397 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
7398   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
7399 * [When formatting strings, if "precision" is specified, the "fill",
7400   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
7401 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
7402
7403
7404 Version 1.11.0 (2016-08-18)
7405 ===========================
7406
7407 Language
7408 --------
7409
7410 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
7411 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
7412 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
7413 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
7414
7415 Stabilized APIs
7416 ---------------
7417
7418 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
7419 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
7420 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
7421 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
7422 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
7423 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
7424   (in libcore - previously stabilized in libstd)
7425 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
7426   (in libcore - previously stabilized in libstd)
7427 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
7428   (in libcore - previously stabilized in libstd)
7429 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
7430   (in libcore - previously stabilized in libstd)
7431 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7432 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
7433 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
7434 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
7435
7436 Libraries
7437 ---------
7438
7439 * [The `thread_local!` macro supports multiple definitions in a single
7440    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
7441 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
7442 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
7443   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
7444 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
7445 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
7446 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
7447 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
7448
7449 Cargo
7450 -----
7451
7452 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
7453 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
7454 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
7455 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
7456 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
7457   and `-vv` prints warnings for all crates.
7458 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
7459 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
7460   This provides room for expansion by arbitrary tools.
7461 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
7462 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
7463 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
7464 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
7465 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
7466 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
7467 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
7468
7469 Performance
7470 -----------
7471
7472 * [Caching projections speeds up type check dramatically for some
7473   workloads](https://github.com/rust-lang/rust/pull/33816)
7474 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
7475   This hasher is faster, but is believed to provide sufficient
7476   protection from collision attacks.
7477 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
7478
7479 Rustdoc
7480 -------
7481
7482 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
7483 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
7484 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
7485 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
7486 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
7487
7488 Tooling
7489 -------
7490
7491 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
7492 * [When emitting debug info, rustc emits frame pointers for closures,
7493   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
7494 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
7495 * Many more errors have been given error codes and extended
7496   explanations
7497 * API documentation continues to be improved, with many new examples
7498
7499 Misc
7500 ----
7501
7502 * [rustc no longer hangs when dependencies recursively re-export
7503   submodules](https://github.com/rust-lang/rust/pull/34542)
7504 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
7505 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
7506   rewritten](https://github.com/rust-lang/rust/pull/33895)
7507 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
7508   No targets use this yet, but it works toward AVR support.
7509
7510 Compatibility Notes
7511 -------------------
7512
7513 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
7514 * [The new follow-set rules that place restrictions on `macro_rules!`
7515   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
7516   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
7517   and has been a warning since 1.10.
7518 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
7519   This causes breakage in some corner cases.
7520
7521
7522 Version 1.10.0 (2016-07-07)
7523 ===========================
7524
7525 Language
7526 --------
7527
7528 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
7529   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
7530 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
7531 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
7532 * [`panic!` can be converted to a runtime abort with the
7533   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
7534   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7535 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
7536   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
7537   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
7538   Note that Cargo does not yet directly support cdylibs.
7539
7540 Stabilized APIs
7541 ---------------
7542
7543 * `os::windows::fs::OpenOptionsExt::access_mode`
7544 * `os::windows::fs::OpenOptionsExt::share_mode`
7545 * `os::windows::fs::OpenOptionsExt::custom_flags`
7546 * `os::windows::fs::OpenOptionsExt::attributes`
7547 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
7548 * `os::unix::fs::OpenOptionsExt::custom_flags`
7549 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
7550 * `Default for sync::Weak`
7551 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
7552 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
7553 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
7554 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7555 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7556 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7557 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7558 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7559 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7560 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7561 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7562 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7563 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7564 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7565 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7566 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7567 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7568 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7569 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7570 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7571 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7572 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7573 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7574 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7575 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7576 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7577 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7578 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7579 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7580 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7581 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7582 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7583 * Read/Write/RawFd impls for `UnixStream`
7584 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7585 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7586 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7587 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7588 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7589 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7590 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7591 * RawFd impls for `UnixListener`
7592 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7593 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7594 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7595 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7596 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7597 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7598 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7599 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7600 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7601 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7602 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7603 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7604 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7605 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7606 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7607 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7608 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7609 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7610 * RawFd impls for `UnixDatagram`
7611 * `{BTree,Hash}Map::values_mut`
7612 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7613
7614 Libraries
7615 ---------
7616
7617 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7618   The semantics of this minor method are subtle and probably not what
7619   most people want.
7620 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7621 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7622   will fall back to `/dev/urandom` temporarily to avoid blocking
7623   during early boot](https://github.com/rust-lang/rust/pull/33086).
7624 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7625 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7626 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7627 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7628 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7629 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7630   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7631
7632 Cargo
7633 -----
7634 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7635   This controls the runtime behavior of the `panic!` macro
7636   and can be either "unwind" (the default), or "abort".
7637   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7638 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7639 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7640 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7641   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7642 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7643 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7644 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7645   By default they are retried twice, which can be customized with the
7646   `net.retry` value in `.cargo/config`.
7647 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7648 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7649 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7650 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7651   Makes it possible to install multiple crates in parallel.
7652 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7653 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7654 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7655 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7656 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7657 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7658
7659 Performance
7660 -----------
7661
7662 * [rustc memory usage was reduced by refactoring the context used for
7663   type checking](https://github.com/rust-lang/rust/pull/33425).
7664 * [Speed up creation of `HashMap`s by caching the random keys used
7665   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7666 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7667 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7668 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7669   10x faster than the previous lookup tables.
7670 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7671
7672 Usability
7673 ---------
7674
7675 * Many incremental improvements to documentation and rustdoc.
7676 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7677 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7678 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7679 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7680 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7681 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7682 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7683
7684 Misc
7685 ----
7686
7687 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7688 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7689 * [`std` no longer prints backtraces on platforms where the running
7690   module must be loaded with `env::current_exe`, which can't be relied
7691   on](https://github.com/rust-lang/rust/pull/33554).
7692 * This release includes std binaries for the i586-unknown-linux-gnu,
7693   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7694   i586 target is for old x86 hardware without SSE2, and the armv7
7695   target is for Android running on modern ARM architectures.
7696 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7697   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7698 * [On Unix the runtime aborts by calling `libc::abort` instead of
7699   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7700 * [Rust is now bootstrapped from the previous release of Rust,
7701   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7702
7703 Compatibility Notes
7704 -------------------
7705
7706 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7707 * [`target_env` for Linux ARM targets is just `gnu`, not
7708   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7709 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7710 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7711 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7712   Affects how macros are parsed.
7713 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7714 * [Feature-gated attributes on macro-generated macro invocations are
7715   now rejected](https://github.com/rust-lang/rust/pull/32791).
7716 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7717   This caused some minor changes to type inference.
7718
7719
7720 Version 1.9.0 (2016-05-26)
7721 ==========================
7722
7723 Language
7724 --------
7725
7726 * The `#[deprecated]` attribute when applied to an API will generate
7727   warnings when used. The warnings may be suppressed with
7728   `#[allow(deprecated)]`. [RFC 1270].
7729 * [`fn` item types are zero sized, and each `fn` names a unique
7730   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7731   `transmute` on a `fn` type will generate a warning for a few cycles,
7732   then will be converted to an error.
7733 * [Field and method resolution understand visibility, so private
7734   fields and methods cannot prevent the proper use of public fields
7735   and methods][1.9fv].
7736 * [The parser considers unicode codepoints in the
7737   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7738
7739 Stabilized APIs
7740 ---------------
7741
7742 * [`std::panic`]
7743 * [`std::panic::catch_unwind`] (renamed from `recover`)
7744 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7745 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7746 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7747 * [`str::is_char_boundary`]
7748 * [`<*const T>::as_ref`]
7749 * [`<*mut T>::as_ref`]
7750 * [`<*mut T>::as_mut`]
7751 * [`AsciiExt::make_ascii_uppercase`]
7752 * [`AsciiExt::make_ascii_lowercase`]
7753 * [`char::decode_utf16`]
7754 * [`char::DecodeUtf16`]
7755 * [`char::DecodeUtf16Error`]
7756 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7757 * [`BTreeSet::take`]
7758 * [`BTreeSet::replace`]
7759 * [`BTreeSet::get`]
7760 * [`HashSet::take`]
7761 * [`HashSet::replace`]
7762 * [`HashSet::get`]
7763 * [`OsString::with_capacity`]
7764 * [`OsString::clear`]
7765 * [`OsString::capacity`]
7766 * [`OsString::reserve`]
7767 * [`OsString::reserve_exact`]
7768 * [`OsStr::is_empty`]
7769 * [`OsStr::len`]
7770 * [`std::os::unix::thread`]
7771 * [`RawPthread`]
7772 * [`JoinHandleExt`]
7773 * [`JoinHandleExt::as_pthread_t`]
7774 * [`JoinHandleExt::into_pthread_t`]
7775 * [`HashSet::hasher`]
7776 * [`HashMap::hasher`]
7777 * [`CommandExt::exec`]
7778 * [`File::try_clone`]
7779 * [`SocketAddr::set_ip`]
7780 * [`SocketAddr::set_port`]
7781 * [`SocketAddrV4::set_ip`]
7782 * [`SocketAddrV4::set_port`]
7783 * [`SocketAddrV6::set_ip`]
7784 * [`SocketAddrV6::set_port`]
7785 * [`SocketAddrV6::set_flowinfo`]
7786 * [`SocketAddrV6::set_scope_id`]
7787 * [`slice::copy_from_slice`]
7788 * [`ptr::read_volatile`]
7789 * [`ptr::write_volatile`]
7790 * [`OpenOptions::create_new`]
7791 * [`TcpStream::set_nodelay`]
7792 * [`TcpStream::nodelay`]
7793 * [`TcpStream::set_ttl`]
7794 * [`TcpStream::ttl`]
7795 * [`TcpStream::set_only_v6`]
7796 * [`TcpStream::only_v6`]
7797 * [`TcpStream::take_error`]
7798 * [`TcpStream::set_nonblocking`]
7799 * [`TcpListener::set_ttl`]
7800 * [`TcpListener::ttl`]
7801 * [`TcpListener::set_only_v6`]
7802 * [`TcpListener::only_v6`]
7803 * [`TcpListener::take_error`]
7804 * [`TcpListener::set_nonblocking`]
7805 * [`UdpSocket::set_broadcast`]
7806 * [`UdpSocket::broadcast`]
7807 * [`UdpSocket::set_multicast_loop_v4`]
7808 * [`UdpSocket::multicast_loop_v4`]
7809 * [`UdpSocket::set_multicast_ttl_v4`]
7810 * [`UdpSocket::multicast_ttl_v4`]
7811 * [`UdpSocket::set_multicast_loop_v6`]
7812 * [`UdpSocket::multicast_loop_v6`]
7813 * [`UdpSocket::set_multicast_ttl_v6`]
7814 * [`UdpSocket::multicast_ttl_v6`]
7815 * [`UdpSocket::set_ttl`]
7816 * [`UdpSocket::ttl`]
7817 * [`UdpSocket::set_only_v6`]
7818 * [`UdpSocket::only_v6`]
7819 * [`UdpSocket::join_multicast_v4`]
7820 * [`UdpSocket::join_multicast_v6`]
7821 * [`UdpSocket::leave_multicast_v4`]
7822 * [`UdpSocket::leave_multicast_v6`]
7823 * [`UdpSocket::take_error`]
7824 * [`UdpSocket::connect`]
7825 * [`UdpSocket::send`]
7826 * [`UdpSocket::recv`]
7827 * [`UdpSocket::set_nonblocking`]
7828
7829 Libraries
7830 ---------
7831
7832 * [`std::sync::Once` is poisoned if its initialization function
7833   fails][1.9o].
7834 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7835 * [Most types implement `fmt::Debug`][1.9db].
7836 * [The default buffer size used by `BufReader` and `BufWriter` was
7837   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7838   used by other languages.
7839 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7840   `Duration` additionally implements `*=` and `/=`][1.9ta].
7841 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7842 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7843 * [`Chain` implements `BufRead`][1.9ch].
7844 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7845
7846 Cargo
7847 -----
7848
7849 * [Cargo can now run concurrently][1.9cc].
7850 * [Top-level overrides allow specific revisions of crates to be
7851   overridden through the entire crate graph][1.9ct].  This is intended
7852   to make upgrades easier for large projects, by allowing crates to be
7853   forked temporarily until they've been upgraded and republished.
7854 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7855 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7856   on the commandline][1.9cf]. `rustc` arguments can also be specified
7857   in the `build.rustflags` configuration key.
7858
7859 Performance
7860 -----------
7861
7862 * [The time complexity of comparing variables for equivalence during type
7863   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7864   to major compilation time improvement in some scenarios.
7865 * [`ToString` is specialized for `str`, giving it the same performance
7866   as `to_owned`][1.9ts].
7867 * [Spawning processes with `Command::output` no longer creates extra
7868   threads][1.9sp].
7869 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7870   for C-like enums][1.9cl].
7871
7872 Misc
7873 ----
7874
7875 * [Passing the `--quiet` flag to a test runner will produce
7876   much-abbreviated output][1.9q].
7877 * The Rust Project now publishes std binaries for the
7878   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7879   `i586-pc-windows-msvc` targets.
7880
7881 Compatibility Notes
7882 -------------------
7883
7884 * [`std::sync::Once` is poisoned if its initialization function
7885   fails][1.9o].
7886 * [It is illegal to define methods with the same name in overlapping
7887   inherent `impl` blocks][1.9sn].
7888 * [`fn` item types are zero sized, and each `fn` names a unique
7889   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7890   `transmute` on a `fn` type will generate a warning for a few cycles,
7891   then will be converted to an error.
7892 * [Improvements to const evaluation may trigger new errors when integer
7893   literals are out of range][1.9ce].
7894
7895
7896 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7897 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7898 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7899 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7900 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7901 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7902 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7903 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7904 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7905 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7906 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7907 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7908 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7909 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7910 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7911 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7912 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7913 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7914 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7915 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7916 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7917 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7918 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7919 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7920 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7921 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7922 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7923 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7924 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7925 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7926 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7927 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7928 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7929 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7930 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7931 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7932 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7933 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7934 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7935 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7936 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7937 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7938 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7939 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7940 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7941 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7942 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7943 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7944 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7945 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7946 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7947 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7948 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7949 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7950 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7951 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7952 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7953 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7954 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7955 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7956 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7957 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7958 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7959 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7960 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7961 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7962 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7963 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7964 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7965 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7966 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7967 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7968 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7969 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7970 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7971 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7972 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7973 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7974 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7975 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7976 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7977 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7978 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7979 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7980 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7981 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7982 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7983 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7984 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7985 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7986 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7987 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7988 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7989 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7990 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7991 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7992 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7993 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7994 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7995 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7996 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7997 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7998 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7999 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
8000 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
8001 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
8002 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
8003 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
8004 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
8005 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
8006
8007
8008 Version 1.8.0 (2016-04-14)
8009 ==========================
8010
8011 Language
8012 --------
8013
8014 * Rust supports overloading of compound assignment statements like
8015   `+=` by implementing the [`AddAssign`], [`SubAssign`],
8016   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
8017   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
8018   traits. [RFC 953].
8019 * Empty structs can be defined with braces, as in `struct Foo { }`, in
8020   addition to the non-braced form, `struct Foo;`. [RFC 218].
8021
8022 Libraries
8023 ---------
8024
8025 * Stabilized APIs:
8026   * [`str::encode_utf16`] (renamed from `utf16_units`)
8027   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
8028   * [`Ref::map`]
8029   * [`RefMut::map`]
8030   * [`ptr::drop_in_place`]
8031   * [`time::Instant`]
8032   * [`time::SystemTime`]
8033   * [`Instant::now`]
8034   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
8035   * [`Instant::elapsed`]
8036   * [`SystemTime::now`]
8037   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
8038   * [`SystemTime::elapsed`]
8039   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
8040   * [`SystemTimeError`]
8041   * [`SystemTimeError::duration`]
8042   * Various impls for `SystemTimeError`
8043   * [`UNIX_EPOCH`]
8044   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
8045     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
8046     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
8047 * [The `write!` and `writeln!` macros correctly emit errors if any of
8048   their arguments can't be formatted][1.8w].
8049 * [Various I/O functions support large files on 32-bit Linux][1.8l].
8050 * [The Unix-specific `raw` modules, which contain a number of
8051   redefined C types are deprecated][1.8r], including `os::raw::unix`,
8052   `os::raw::macos`, and `os::raw::linux`. These modules defined types
8053   such as `ino_t` and `dev_t`. The inconsistency of these definitions
8054   across platforms was making it difficult to implement `std`
8055   correctly. Those that need these definitions should use the `libc`
8056   crate. [RFC 1415].
8057 * The Unix-specific `MetadataExt` traits, including
8058   `os::unix::fs::MetadataExt`, which expose values such as inode
8059   numbers [no longer return platform-specific types][1.8r], but
8060   instead return widened integers. [RFC 1415].
8061 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
8062 * [Atomic loads and stores are not volatile][1.8a].
8063 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
8064
8065 Performance
8066 -----------
8067
8068 * [Inlining hash functions lead to a 3% compile-time improvement in
8069   some workloads][1.8h].
8070 * When using jemalloc, its symbols are [unprefixed so that it
8071   overrides the libc malloc implementation][1.8h]. This means that for
8072   rustc, LLVM is now using jemalloc, which results in a 6%
8073   compile-time improvement on a specific workload.
8074 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
8075
8076 Misc
8077 ----
8078
8079 * [32-bit MSVC builds finally implement unwinding][1.8ms].
8080   i686-pc-windows-msvc is now considered a tier-1 platform.
8081 * [The `--print targets` flag prints a list of supported targets][1.8t].
8082 * [The `--print cfg` flag prints the `cfg`s defined for the current
8083   target][1.8cf].
8084 * [`rustc` can be built with an new Cargo-based build system, written
8085   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
8086   build system. To enable it configure with `configure --rustbuild`.
8087 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
8088   variants while also indicating the total number of missing variants
8089   if more than 3][1.8m].
8090 * [Executable stacks are disabled on Linux and BSD][1.8nx].
8091 * The Rust Project now publishes binary releases of the standard
8092   library for a number of tier-2 targets:
8093   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
8094   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
8095   `x86_64-rumprun-netbsd`. These can be installed with
8096   tools such as [multirust][1.8mr].
8097
8098 Cargo
8099 -----
8100
8101 * [`cargo init` creates a new Cargo project in the current
8102   directory][1.8ci].  It is otherwise like `cargo new`.
8103 * [Cargo has configuration keys for `-v` and
8104   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
8105   `[term]` section of `.cargo/config`.
8106 * [Configuration keys that evaluate to strings or integers can be set
8107   via environment variables][1.8ce]. For example the `build.jobs` key
8108   can be set via `CARGO_BUILD_JOBS`. Environment variables take
8109   precedence over config files.
8110 * [Target-specific dependencies support Rust `cfg` syntax for
8111   describing targets][1.8cfg] so that dependencies for multiple
8112   targets can be specified together. [RFC 1361].
8113 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
8114   `RUSTDOC` take precedence over the `build.target-dir`,
8115   `build.rustc`, and `build.rustdoc` configuration values][1.8cfv].
8116 * [The child process tree is killed on Windows when Cargo is
8117   killed][1.8ck].
8118 * [The `build.target` configuration value sets the target platform,
8119   like `--target`][1.8ct].
8120
8121 Compatibility Notes
8122 -------------------
8123
8124 * [Unstable compiler flags have been further restricted][1.8u]. Since
8125   1.0 `-Z` flags have been considered unstable, and other flags that
8126   were considered unstable additionally required passing `-Z
8127   unstable-options` to access. Unlike unstable language and library
8128   features though, these options have been accessible on the stable
8129   release channel. Going forward, *new unstable flags will not be
8130   available on the stable release channel*, and old unstable flags
8131   will warn about their usage. In the future, all unstable flags will
8132   be unavailable on the stable release channel.
8133 * [It is no longer possible to `match` on empty enum variants using
8134   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
8135 * The Unix-specific `MetadataExt` traits, including
8136   `os::unix::fs::MetadataExt`, which expose values such as inode
8137   numbers [no longer return platform-specific types][1.8r], but
8138   instead return widened integers. [RFC 1415].
8139 * [Modules sourced from the filesystem cannot appear within arbitrary
8140   blocks, but only within other modules][1.8mf].
8141 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
8142 * On Unix, [stack overflow triggers a runtime abort instead of a
8143   SIGSEGV][1.8so].
8144 * [`Command::spawn` and its equivalents return an error if any of
8145   its command-line arguments contain interior `NUL`s][1.8n].
8146 * [Tuple and unit enum variants from other crates are in the type
8147   namespace][1.8tn].
8148 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
8149   type instead of `.a` files][1.8st]. Additionally, for the MSVC
8150   toolchain, `rustc` emits import libraries named `foo.dll.lib`
8151   instead of `foo.lib`.
8152
8153
8154 [1.8a]: https://github.com/rust-lang/rust/pull/30962
8155 [1.8b]: https://github.com/rust-lang/rust/pull/31123
8156 [1.8c]: https://github.com/rust-lang/rust/pull/31530
8157 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
8158 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
8159 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
8160 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
8161 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
8162 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
8163 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
8164 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
8165 [1.8cfv]: https://github.com/rust-lang/cargo/issues/2365
8166 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
8167 [1.8h]: https://github.com/rust-lang/rust/pull/31460
8168 [1.8l]: https://github.com/rust-lang/rust/pull/31668
8169 [1.8m]: https://github.com/rust-lang/rust/pull/31020
8170 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
8171 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
8172 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
8173 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
8174 [1.8n]: https://github.com/rust-lang/rust/pull/31056
8175 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
8176 [1.8r]: https://github.com/rust-lang/rust/pull/31551
8177 [1.8so]: https://github.com/rust-lang/rust/pull/31333
8178 [1.8st]: https://github.com/rust-lang/rust/pull/29520
8179 [1.8t]: https://github.com/rust-lang/rust/pull/31358
8180 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
8181 [1.8u]: https://github.com/rust-lang/rust/pull/31793
8182 [1.8v]: https://github.com/rust-lang/rust/pull/31757
8183 [1.8w]: https://github.com/rust-lang/rust/pull/31904
8184 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
8185 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
8186 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
8187 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
8188 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
8189 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
8190 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
8191 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
8192 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
8193 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
8194 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
8195 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
8196 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
8197 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
8198 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
8199 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
8200 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
8201 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
8202 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
8203 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
8204 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
8205 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
8206 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
8207 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
8208 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
8209 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
8210 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
8211 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
8212 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
8213 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
8214
8215
8216 Version 1.7.0 (2016-03-03)
8217 ==========================
8218
8219 Libraries
8220 ---------
8221
8222 * Stabilized APIs
8223   * `Path`
8224     * [`Path::strip_prefix`] (renamed from relative_from)
8225     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
8226   * `Ipv4Addr`
8227     * [`Ipv4Addr::is_loopback`]
8228     * [`Ipv4Addr::is_private`]
8229     * [`Ipv4Addr::is_link_local`]
8230     * [`Ipv4Addr::is_multicast`]
8231     * [`Ipv4Addr::is_broadcast`]
8232     * [`Ipv4Addr::is_documentation`]
8233   * `Ipv6Addr`
8234     * [`Ipv6Addr::is_unspecified`]
8235     * [`Ipv6Addr::is_loopback`]
8236     * [`Ipv6Addr::is_multicast`]
8237   * `Vec`
8238     * [`Vec::as_slice`]
8239     * [`Vec::as_mut_slice`]
8240   * `String`
8241     * [`String::as_str`]
8242     * [`String::as_mut_str`]
8243   * Slices
8244     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
8245     be the same length
8246     * `<[T]>::`[`sort_by_key`]
8247   * checked, saturated, and overflowing operations
8248     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
8249     * [`i32::saturating_mul`]
8250     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
8251     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
8252     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
8253     * [`u32::saturating_mul`]
8254     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
8255     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
8256     * and checked, saturated, and overflowing operations for other primitive types
8257   * FFI
8258     * [`ffi::IntoStringError`]
8259     * [`CString::into_string`]
8260     * [`CString::into_bytes`]
8261     * [`CString::into_bytes_with_nul`]
8262     * `From<CString> for Vec<u8>`
8263   * `IntoStringError`
8264     * [`IntoStringError::into_cstring`]
8265     * [`IntoStringError::utf8_error`]
8266     * `Error for IntoStringError`
8267   * Hashing
8268     * [`std::hash::BuildHasher`]
8269     * [`BuildHasher::Hasher`]
8270     * [`BuildHasher::build_hasher`]
8271     * [`std::hash::BuildHasherDefault`]
8272     * [`HashMap::with_hasher`]
8273     * [`HashMap::with_capacity_and_hasher`]
8274     * [`HashSet::with_hasher`]
8275     * [`HashSet::with_capacity_and_hasher`]
8276     * [`std::collections::hash_map::RandomState`]
8277     * [`RandomState::new`]
8278 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
8279   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
8280   from bytes is faster.
8281 * [The performance of `LineWriter` (and thus `io::stdout`) was
8282   improved by using `memchr` to search for newlines][1.7m].
8283 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
8284   `f64` variants were stabilized previously.
8285 * [`BTreeMap` was rewritten to use less memory and improve the performance
8286   of insertion and iteration, the latter by as much as 5x][1.7bm].
8287 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
8288   covariant over their contained type][1.7bt].
8289 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
8290   over their contained type][1.7ll].
8291 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
8292   searching methods.
8293 * [`Any` is implemented for unsized types][1.7a].
8294 * [`Hash` is implemented for `Duration`][1.7h].
8295
8296 Misc
8297 ----
8298
8299 * [When running tests with `--test`, rustdoc will pass `--cfg`
8300   arguments to the compiler][1.7dt].
8301 * [The compiler is built with RPATH information by default][1.7rpa].
8302   This means that it will be possible to run `rustc` when installed in
8303   unusual configurations without configuring the dynamic linker search
8304   path explicitly.
8305 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
8306   any RPATH entries (emitted with `-C rpath`) *not* take precedence
8307   over `LD_LIBRARY_PATH`.
8308
8309 Cargo
8310 -----
8311
8312 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
8313   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
8314 * [The `rerun-if-changed` build script directive no longer causes the
8315   build script to incorrectly run twice in certain scenarios][1.7rr].
8316
8317 Compatibility Notes
8318 -------------------
8319
8320 * Soundness fixes to the interactions between associated types and
8321   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
8322   code that violates the new rules. This is a significant change that
8323   is known to break existing code, so it has emitted warnings for the
8324   new error cases since 1.4 to give crate authors time to adapt. The
8325   details of what is changing are subtle; read the RFC for more.
8326 * [Several bugs in the compiler's visibility calculations were
8327   fixed][1.7v]. Since this was found to break significant amounts of
8328   code, the new errors will be emitted as warnings for several release
8329   cycles, under the `private_in_public` lint.
8330 * Defaulted type parameters were accidentally accepted in positions
8331   that were not intended. In this release, [defaulted type parameters
8332   appearing outside of type definitions will generate a
8333   warning][1.7d], which will become an error in future releases.
8334 * [Parsing "." as a float results in an error instead of 0][1.7p].
8335   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
8336 * [Borrows of closure parameters may not outlive the closure][1.7bc].
8337
8338 [1.7a]: https://github.com/rust-lang/rust/pull/30928
8339 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
8340 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
8341 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
8342 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
8343 [1.7d]: https://github.com/rust-lang/rust/pull/30724
8344 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
8345 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
8346 [1.7f]: https://github.com/rust-lang/rust/pull/30672
8347 [1.7h]: https://github.com/rust-lang/rust/pull/30818
8348 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
8349 [1.7m]: https://github.com/rust-lang/rust/pull/30381
8350 [1.7p]: https://github.com/rust-lang/rust/pull/30681
8351 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
8352 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
8353 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
8354 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
8355 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
8356 [1.7v]: https://github.com/rust-lang/rust/pull/29973
8357 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8358 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8359 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
8360 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
8361 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
8362 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
8363 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
8364 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
8365 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
8366 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
8367 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
8368 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
8369 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
8370 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
8371 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
8372 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
8373 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
8374 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
8375 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
8376 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
8377 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
8378 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
8379 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
8380 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
8381 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
8382 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
8383 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
8384 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
8385 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
8386 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
8387 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
8388 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
8389 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
8390 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
8391 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
8392 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
8393 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
8394 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
8395 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
8396 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
8397 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
8398 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
8399 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
8400 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
8401 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
8402 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
8403 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
8404 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8405 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
8406 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
8407 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
8408 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
8409 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
8410 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
8411 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
8412 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
8413 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
8414 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
8415 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
8416 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
8417
8418
8419 Version 1.6.0 (2016-01-21)
8420 ==========================
8421
8422 Language
8423 --------
8424
8425 * The `#![no_std]` attribute causes a crate to not be linked to the
8426   standard library, but only the [core library][1.6co], as described
8427   in [RFC 1184]. The core library defines common types and traits but
8428   has no platform dependencies whatsoever, and is the basis for Rust
8429   software in environments that cannot support a full port of the
8430   standard library, such as operating systems. Most of the core
8431   library is now stable.
8432
8433 Libraries
8434 ---------
8435
8436 * Stabilized APIs:
8437   [`Read::read_exact`],
8438   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
8439   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
8440   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
8441   [`os::unix::fs::DirBuilderExt`],
8442   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
8443   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
8444   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
8445   [`collections::hash_map::Drain`],
8446   [`collections::hash_map::HashMap::drain`],
8447   [`collections::hash_set::Drain`],
8448   [`collections::hash_set::HashSet::drain`],
8449   [`collections::binary_heap::Drain`],
8450   [`collections::binary_heap::BinaryHeap::drain`],
8451   [`Vec::extend_from_slice`] (renamed from `push_all`),
8452   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
8453   [`RwLock::into_inner`],
8454   [`Iterator::min_by_key`] (renamed from `min_by`),
8455   [`Iterator::max_by_key`] (renamed from `max_by`).
8456 * The [core library][1.6co] is stable, as are most of its APIs.
8457 * [The `assert_eq!` macro supports arguments that don't implement
8458   `Sized`][1.6ae], such as arrays. In this way it behaves more like
8459   `assert!`.
8460 * Several timer functions that take duration in milliseconds [are
8461   deprecated in favor of those that take `Duration`][1.6ms]. These
8462   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
8463   `thread::park_timeout_ms`.
8464 * The algorithm by which `Vec` reserves additional elements was
8465   [tweaked to not allocate excessive space][1.6a] while still growing
8466   exponentially.
8467 * `From` conversions are [implemented from integers to floats][1.6f]
8468   in cases where the conversion is lossless. Thus they are not
8469   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
8470   or `f64`. They are also not implemented for `isize` and `usize`
8471   because the implementations would be platform-specific. `From` is
8472   also implemented from `f32` to `f64`.
8473 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
8474 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
8475 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
8476 * [`BinaryHeap` was refactored][1.6bh] for modest performance
8477   improvements.
8478 * Sorting slices that are already sorted [is 50% faster in some
8479   cases][1.6s].
8480
8481 Cargo
8482 -----
8483
8484 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
8485 * Cargo build scripts can specify their dependencies by emitting the
8486   [`rerun-if-changed`][1.6rr] key.
8487 * crates.io will reject publication of crates with dependencies that
8488   have a wildcard version constraint. Crates with wildcard
8489   dependencies were seen to cause a variety of problems, as described
8490   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
8491   warning.
8492 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
8493   release folder.  A variety of artifacts that Cargo failed to clean
8494   are now correctly deleted.
8495
8496 Misc
8497 ----
8498
8499 * The `unreachable_code` lint [warns when a function call's argument
8500   diverges][1.6dv].
8501 * The parser indicates [failures that may be caused by
8502   confusingly-similar Unicode characters][1.6uc]
8503 * Certain macro errors [are reported at definition time][1.6m], not
8504   expansion.
8505
8506 Compatibility Notes
8507 -------------------
8508
8509 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
8510   environment variable when locating crates. This was a pre-cargo
8511   feature for integrating with the package manager that was
8512   accidentally never removed.
8513 * [A number of bugs were fixed in the privacy checker][1.6p] that
8514   could cause previously-accepted code to break.
8515 * [Modules and unit/tuple structs may not share the same name][1.6ts].
8516 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
8517   struct pattern syntax (`Foo(..)`) can no longer be used to match
8518   unit structs. This is a warning now, but will become an error in
8519   future releases. Patterns that share the same name as a const are
8520   now an error.
8521 * A bug was fixed that causes [rustc not to apply default type
8522   parameters][1.6xc] when resolving certain method implementations of
8523   traits defined in other crates.
8524
8525 [1.6a]: https://github.com/rust-lang/rust/pull/29454
8526 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
8527 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
8528 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
8529 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
8530 [1.6co]: http://doc.rust-lang.org/core/index.html
8531 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
8532 [1.6f]: https://github.com/rust-lang/rust/pull/29129
8533 [1.6m]: https://github.com/rust-lang/rust/pull/29828
8534 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
8535 [1.6p]: https://github.com/rust-lang/rust/pull/29726
8536 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
8537 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
8538 [1.6s]: https://github.com/rust-lang/rust/pull/29675
8539 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
8540 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
8541 [1.6us]: https://github.com/rust-lang/rust/pull/29383
8542 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
8543 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
8544 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8545 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
8546 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
8547 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
8548 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
8549 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
8550 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
8551 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
8552 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
8553 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
8554 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8555 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8556 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8557 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8558 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8559 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8560 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8561 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8562 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8563 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8564 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8565 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8566 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8567 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8568 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8569 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8570 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8571 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8572
8573
8574 Version 1.5.0 (2015-12-10)
8575 ==========================
8576
8577 * ~700 changes, numerous bugfixes
8578
8579 Highlights
8580 ----------
8581
8582 * Stabilized APIs:
8583   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8584   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8585   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8586   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8587   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8588   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8589   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8590   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8591   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8592   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8593   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8594   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8595   [`Path::read_link`], [`Path::symlink_metadata`],
8596   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8597   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8598   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8599   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8600   [`slice::split_first_mut`], [`slice::split_first`],
8601   [`slice::split_last_mut`], [`slice::split_last`],
8602   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8603   [`str::MatchIndices`], [`str::RMatchIndices`],
8604   [`str::match_indices`], [`str::rmatch_indices`],
8605   [`str::slice_mut_unchecked`], [`string::ParseError`].
8606 * Rust applications hosted on crates.io can be installed locally to
8607   `~/.cargo/bin` with the [`cargo install`] command. Among other
8608   things this makes it easier to augment Cargo with new subcommands:
8609   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8610   invoked as `cargo foo`.
8611 * Crates with wildcard (`*`) dependencies will [emit warnings when
8612   published][1.5w]. In 1.6 it will no longer be possible to publish
8613   crates with wildcard dependencies.
8614
8615 Breaking Changes
8616 ----------------
8617
8618 * The rules determining when a particular lifetime must outlive
8619   a particular value (known as '[dropck]') have been [modified
8620   to not rely on parametricity][1.5p].
8621 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8622   and `Arc`][1.5a]. Because these smart pointer types implement
8623   `Deref`, this causes breakage in cases where the interior type
8624   contains methods of the same name.
8625 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8626   that they could drop their content. Soundness fix.
8627 * All method invocations are [properly checked][1.5wf1] for
8628   [well-formedness][1.5wf2]. Soundness fix.
8629 * Traits whose supertraits contain `Self` are [not object
8630   safe][1.5o]. Soundness fix.
8631 * Target specifications support a [`no_default_libraries`][1.5nd]
8632   setting that controls whether `-nodefaultlibs` is passed to the
8633   linker, and in turn the `is_like_windows` setting no longer affects
8634   the `-nodefaultlibs` flag.
8635 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8636 * The `#[inline]` and `#[repr]` attributes [can only appear
8637   in valid locations][1.5at].
8638 * Native libraries linked from the local crate are [passed to
8639   the linker before native libraries from upstream crates][1.5nl].
8640 * Two rarely-used attributes, `#[no_debug]` and
8641   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8642 * Negation of unsigned integers, which has been a warning for
8643   several releases, [is now behind a feature gate and will
8644   generate errors][1.5nu].
8645 * The parser accidentally accepted visibility modifiers on
8646   enum variants, a bug [which has been fixed][1.5ev].
8647 * [A bug was fixed that allowed `use` statements to import unstable
8648   features][1.5use].
8649
8650 Language
8651 --------
8652
8653 * When evaluating expressions at compile-time that are not
8654   compile-time constants (const-evaluating expressions in non-const
8655   contexts), incorrect code such as overlong bitshifts and arithmetic
8656   overflow will [generate a warning instead of an error][1.5ce],
8657   delaying the error until runtime. This will allow the
8658   const-evaluator to be expanded in the future backwards-compatibly.
8659 * The `improper_ctypes` lint [no longer warns about using `isize` and
8660   `usize` in FFI][1.5ict].
8661
8662 Libraries
8663 ---------
8664
8665 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8666   invariant][1.5c].
8667 * `Default` is [implemented for mutable slices][1.5d].
8668 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8669 * There are now `From` conversions [between floating point
8670   types][1.5f] where the conversions are lossless.
8671 * There are now `From` conversions [between integer types][1.5i] where
8672   the conversions are lossless.
8673 * [`fs::Metadata` implements `Clone`][1.5fs].
8674 * The `parse` method [accepts a leading "+" when parsing
8675   integers][1.5pi].
8676 * [`AsMut` is implemented for `Vec`][1.5am].
8677 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8678   been optimized][1.5cf] and no longer rely on the default impl.
8679 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8680   `unsafe extern "C"` function types now [implement `Clone`,
8681   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8682   `fmt::Debug` for up to 12 arguments][1.5fp].
8683 * [Dropping `Vec`s is much faster in unoptimized builds when the
8684   element types don't implement `Drop`][1.5dv].
8685 * A bug that caused in incorrect behavior when [combining `VecDeque`
8686   with zero-sized types][1.5vdz] was resolved.
8687 * [`PartialOrd` for slices is faster][1.5po].
8688
8689 Miscellaneous
8690 -------------
8691
8692 * [Crate metadata size was reduced by 20%][1.5md].
8693 * [Improvements to code generation reduced the size of libcore by 3.3
8694   MB and rustc's memory usage by 18MB][1.5m].
8695 * [Improvements to deref translation increased performance in
8696   unoptimized builds][1.5dr].
8697 * Various errors in trait resolution [are deduplicated to only be
8698   reported once][1.5te].
8699 * Rust has preliminary [support for rumprun kernels][1.5rr].
8700 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8701
8702 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8703 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8704 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8705 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8706 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8707 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8708 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8709 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8710 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8711 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8712 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8713 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8714 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8715 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8716 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8717 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8718 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8719 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8720 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8721 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8722 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8723 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8724 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8725 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8726 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8727 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8728 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8729 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8730 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8731 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8732 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8733 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8734 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8735 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8736 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8737 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8738 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8739 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8740 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8741 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8742 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8743 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8744 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8745 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8746 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8747 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8748 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8749 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8750 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8751 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8752 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8753 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8754 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8755 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8756 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8757 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8758 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8759 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8760 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8761 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8762 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8763 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8764 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8765 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8766 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8767 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8768 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8769 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8770 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8771 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8772 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8773 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8774 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8775 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8776 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8777 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8778 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8779 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8780 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8781 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8782 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8783 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8784 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8785 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8786 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8787 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8788 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8789 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8790 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8791
8792 Version 1.4.0 (2015-10-29)
8793 ==========================
8794
8795 * ~1200 changes, numerous bugfixes
8796
8797 Highlights
8798 ----------
8799
8800 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8801   GNU) are now supported and recommended for use.
8802
8803 Breaking Changes
8804 ----------------
8805
8806 * [Several changes have been made to fix type soundness and improve
8807   the behavior of associated types][sound]. See [RFC 1214]. Although
8808   we have mostly introduced these changes as warnings this release, to
8809   become errors next release, there are still some scenarios that will
8810   see immediate breakage.
8811 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8812   line breaks in addition to `\n`][crlf].
8813 * [Loans of `'static` lifetime extend to the end of a function][stat].
8814 * [`str::parse` no longer introduces avoidable rounding error when
8815   parsing floating point numbers. Together with earlier changes to
8816   float formatting/output, "round trips" like f.to_string().parse()
8817   now preserve the value of f exactly. Additionally, leading plus
8818   signs are now accepted][fp3].
8819
8820
8821 Language
8822 --------
8823
8824 * `use` statements that import multiple items [can now rename
8825   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8826 * [Binops work correctly on fat pointers][binfat].
8827 * `pub extern crate`, which does not behave as expected, [issues a
8828   warning][pec] until a better solution is found.
8829
8830 Libraries
8831 ---------
8832
8833 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8834   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8835   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8836   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8837   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8838   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8839   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8840   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8841   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8842   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8843   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8844   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8845   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8846   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8847   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8848   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8849   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8850   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8851   [`thread::sleep`].
8852 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8853   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8854   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8855   `f64::from_str_radix`.
8856 * [Reverse-searching strings is faster with the 'two-way'
8857   algorithm][s].
8858 * [`std::io::copy` allows `?Sized` arguments][cc].
8859 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8860   [override `count`, `nth` and `last` with an *O*(1)
8861   implementation][it].
8862 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8863 * [`IntoRawFd` has been added to the Unix-specific prelude,
8864   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8865   prelude][pr].
8866 * [`Extend<String>` and `FromIterator<String` are both implemented for
8867   `String`][es].
8868 * [`IntoIterator` is implemented for references to `Option` and
8869   `Result`][into2].
8870 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8871   Copy`][ext] as part of [RFC 839]. This will cause type inference
8872   breakage in rare situations.
8873 * [`BinaryHeap` implements `Debug`][bh2].
8874 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8875   arrays][bm].
8876 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8877   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8878 * [String comparison is faster][faststr].
8879 * `&mut T` where `T: std::fmt::Write` [also implements
8880   `std::fmt::Write`][mutw].
8881 * [A stable regression in `VecDeque::push_back` and other
8882   capacity-altering methods that caused panics for zero-sized types
8883   was fixed][vd].
8884 * [Function pointers implement traits for up to 12 parameters][fp2].
8885
8886 Miscellaneous
8887 -------------
8888
8889 * The compiler [no longer uses the 'morestack' feature to prevent
8890   stack overflow][mm]. Instead it uses guard pages and stack
8891   probes (though stack probes are not yet implemented on any platform
8892   but Windows).
8893 * [The compiler matches traits faster when projections are involved][p].
8894 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8895   `usize`][ffi].
8896 * [Cargo now displays useful information about what its doing during
8897   `cargo update`][cu].
8898
8899 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8900 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8901 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8902 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8903 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8904 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8905 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8906 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8907 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8908 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8909 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8910 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8911 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8912 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8913 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8914 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8915 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8916 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8917 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8918 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8919 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8920 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8921 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8922 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8923 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8924 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8925 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8926 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8927 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8928 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8929 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8930 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8931 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8932 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8933 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8934 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8935 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8936 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8937 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8938 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8939 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8940 [bh2]: https://github.com/rust-lang/rust/pull/28156
8941 [binfat]: https://github.com/rust-lang/rust/pull/28270
8942 [bm]: https://github.com/rust-lang/rust/pull/28197
8943 [cc]: https://github.com/rust-lang/rust/pull/27531
8944 [crlf]: https://github.com/rust-lang/rust/pull/28034
8945 [cu]: https://github.com/rust-lang/cargo/pull/1931
8946 [d]: https://github.com/rust-lang/rust/pull/27825
8947 [dep]: https://github.com/rust-lang/rust/pull/28339
8948 [es]: https://github.com/rust-lang/rust/pull/27956
8949 [ext]: https://github.com/rust-lang/rust/pull/28094
8950 [faststr]: https://github.com/rust-lang/rust/pull/28338
8951 [ffi]: https://github.com/rust-lang/rust/pull/28779
8952 [fp]: https://github.com/rust-lang/rust/pull/28268
8953 [fp2]: https://github.com/rust-lang/rust/pull/28560
8954 [fp3]: https://github.com/rust-lang/rust/pull/27307
8955 [i]: https://github.com/rust-lang/rust/pull/27451
8956 [into2]: https://github.com/rust-lang/rust/pull/28039
8957 [it]: https://github.com/rust-lang/rust/pull/27652
8958 [mm]: https://github.com/rust-lang/rust/pull/27338
8959 [mutw]: https://github.com/rust-lang/rust/pull/28368
8960 [sound]: https://github.com/rust-lang/rust/pull/27641
8961 [p]: https://github.com/rust-lang/rust/pull/27866
8962 [pec]: https://github.com/rust-lang/rust/pull/28486
8963 [pr]: https://github.com/rust-lang/rust/pull/27896
8964 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8965 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8966 [s]: https://github.com/rust-lang/rust/pull/27474
8967 [stab]: https://github.com/rust-lang/rust/pull/28339
8968 [stat]: https://github.com/rust-lang/rust/pull/28321
8969 [vd]: https://github.com/rust-lang/rust/pull/28494
8970
8971 Version 1.3.0 (2015-09-17)
8972 ==============================
8973
8974 * ~900 changes, numerous bugfixes
8975
8976 Highlights
8977 ----------
8978
8979 * The [new object lifetime defaults][nold] have been [turned
8980   on][nold2] after a cycle of warnings about the change. Now types
8981   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8982   being interpreted as `&'a Box<Trait+'a>` to `&'a
8983   Box<Trait+'static>`.
8984 * [The Rustonomicon][nom] is a new book in the official documentation
8985   that dives into writing unsafe Rust.
8986 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8987   timekeeping is employed by other std APIs, as well as out-of-tree
8988   time crates.
8989
8990 Breaking Changes
8991 ----------------
8992
8993 * The [new object lifetime defaults][nold] have been [turned
8994   on][nold2] after a cycle of warnings about the change.
8995 * There is a known [regression][lr] in how object lifetime elision is
8996   interpreted, the proper solution for which is undetermined.
8997 * The `#[prelude_import]` attribute, an internal implementation
8998   detail, was accidentally stabilized previously. [It has been put
8999   behind the `prelude_import` feature gate][pi]. This change is
9000   believed to break no existing code.
9001 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9002   [more sane for dynamically sized types][dst3]. Code that relied on
9003   the previous behavior is thought to be broken.
9004 * The `dropck` rules, which checks that destructors can't access
9005   destroyed values, [have been updated][dropck] to match the
9006   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
9007   cause some previously-compiling code to no longer build.
9008
9009 Language
9010 --------
9011
9012 * The [new object lifetime defaults][nold] have been [turned
9013   on][nold2] after a cycle of warnings about the change.
9014 * Semicolons may [now follow types and paths in
9015   macros](https://github.com/rust-lang/rust/pull/27000).
9016 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
9017   [more sane for dynamically sized types][dst3]. Code that relied on
9018   the previous behavior is not known to exist, and suspected to be
9019   broken.
9020 * `'static` variables [may now be recursive][st].
9021 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
9022   implementations correctly.
9023 * The `dropck` rules, which checks that destructors can't access
9024   destroyed values, [have been updated][dropck] to match the
9025   [RFC][dropckrfc].
9026
9027 Libraries
9028 ---------
9029
9030 * The [`Duration`] API, [has been stabilized][ds], as well as the
9031   `std::time` module, which presently contains only `Duration`.
9032 * `Box<str>` and `Box<[T]>` both implement `Clone`.
9033 * The owned C string, [`CString`], implements [`Borrow`] and the
9034   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
9035   these allow C strings to be borrowed and cloned in generic code.
9036 * [`CStr`] implements [`Debug`].
9037 * [`AtomicPtr`] implements [`Debug`].
9038 * [`Error`] trait objects [can be downcast to their concrete types][e]
9039   in many common configurations, using the [`is`], [`downcast`],
9040   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
9041   [`Any`] trait.
9042 * Searching for substrings now [employs the two-way algorithm][search]
9043   instead of doing a naive search. This gives major speedups to a
9044   number of methods, including [`contains`][sc], [`find`][sf],
9045   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
9046   [`ends_with`][sew] are also faster.
9047 * The performance of `PartialEq` for slices is [much faster][ps].
9048 * The [`Hash`] trait offers the default method, [`hash_slice`], which
9049   is overridden and optimized by the implementations for scalars.
9050 * The [`Hasher`] trait now has a number of specialized `write_*`
9051   methods for primitive types, for efficiency.
9052 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
9053   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
9054   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
9055   of [`std::error::Error::cause`][iec] also delegates to the inner
9056   error.
9057 * [`process::Child`][pc] gained the [`id`] method, which returns a
9058   `u32` representing the platform-specific process identifier.
9059 * The [`connect`] method on slices is deprecated, replaced by the new
9060   [`join`] method (note that both of these are on the *unstable*
9061   [`SliceConcatExt`] trait, but through the magic of the prelude are
9062   available to stable code anyway).
9063 * The [`Div`] operator is implemented for [`Wrapping`] types.
9064 * [`DerefMut` is implemented for `String`][dms].
9065 * Performance of SipHash (the default hasher for `HashMap`) is
9066   [better for long data][sh].
9067 * [`AtomicPtr`] implements [`Send`].
9068 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
9069   are now [specialized to use uninitialized buffers for increased
9070   performance][rte].
9071 * Lifetime parameters of foreign functions [are now resolved
9072   properly][f].
9073
9074 Misc
9075 ----
9076
9077 * Rust can now, with some coercion, [produce programs that run on
9078   Windows XP][xp], though XP is not considered a supported platform.
9079 * Porting Rust on Windows from the GNU toolchain to MSVC continues
9080   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
9081   recommended for use in 1.3, though should be fully-functional
9082   in the [64-bit 1.4 beta][b14].
9083 * On Fedora-based systems installation will [properly configure the
9084   dynamic linker][fl].
9085 * The compiler gained many new extended error descriptions, which can
9086   be accessed with the `--explain` flag.
9087 * The `dropck` pass, which checks that destructors can't access
9088   destroyed values, [has been rewritten][27261]. This fixes some
9089   soundness holes, and as such will cause some previously-compiling
9090   code to no longer build.
9091 * `rustc` now uses [LLVM to write archive files where possible][ar].
9092   Eventually this will eliminate the compiler's dependency on the ar
9093   utility.
9094 * Rust has [preliminary support for i686 FreeBSD][26959] (it has long
9095   supported FreeBSD on x86_64).
9096 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
9097   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
9098   more strict.
9099 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
9100   will kill the process instead of leaking][nlp].
9101
9102 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
9103 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
9104 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
9105 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
9106 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
9107 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9108 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9109 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
9110 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
9111 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
9112 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
9113 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
9114 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
9115 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
9116 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
9117 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
9118 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
9119 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
9120 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9121 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
9122 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
9123 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
9124 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
9125 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
9126 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
9127 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
9128 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
9129 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
9130 [ar]: https://github.com/rust-lang/rust/pull/26926
9131 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
9132 [dms]: https://github.com/rust-lang/rust/pull/26241
9133 [27261]: https://github.com/rust-lang/rust/pull/27261
9134 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9135 [ds]: https://github.com/rust-lang/rust/pull/26818
9136 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
9137 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
9138 [dst3]: https://github.com/rust-lang/rust/pull/27351
9139 [e]: https://github.com/rust-lang/rust/pull/24793
9140 [f]: https://github.com/rust-lang/rust/pull/26588
9141 [26959]: https://github.com/rust-lang/rust/pull/26959
9142 [fl]: https://github.com/rust-lang/rust-installer/pull/41
9143 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
9144 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
9145 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
9146 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
9147 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
9148 [lic]: https://github.com/rust-lang/rust/pull/26583
9149 [lnu]: https://github.com/rust-lang/rust/pull/27026
9150 [lr]: https://github.com/rust-lang/rust/issues/27248
9151 [lum]: https://github.com/rust-lang/rust/pull/26378
9152 [lur]: https://github.com/rust-lang/rust/pull/26783
9153 [nlp]: https://github.com/rust-lang/rust/pull/27176
9154 [nold2]: https://github.com/rust-lang/rust/pull/27045
9155 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
9156 [nom]: http://doc.rust-lang.org/nightly/nomicon/
9157 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
9158 [pi]: https://github.com/rust-lang/rust/pull/26699
9159 [ps]: https://github.com/rust-lang/rust/pull/26884
9160 [rte]: https://github.com/rust-lang/rust/pull/26950
9161 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
9162 [search]: https://github.com/rust-lang/rust/pull/26327
9163 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
9164 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
9165 [sh]: https://github.com/rust-lang/rust/pull/27280
9166 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
9167 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
9168 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
9169 [st]: https://github.com/rust-lang/rust/pull/26630
9170 [win1]: https://github.com/rust-lang/rust/pull/26569
9171 [win2]: https://github.com/rust-lang/rust/pull/26741
9172 [win3]: https://github.com/rust-lang/rust/pull/26741
9173 [win4]: https://github.com/rust-lang/rust/pull/27210
9174 [xp]: https://github.com/rust-lang/rust/pull/26569
9175
9176 Version 1.2.0 (2015-08-07)
9177 ==========================
9178
9179 * ~1200 changes, numerous bugfixes
9180
9181 Highlights
9182 ----------
9183
9184 * [Dynamically-sized-type coercions][dst] allow smart pointer types
9185   like `Rc` to contain types without a fixed size, arrays and trait
9186   objects, finally enabling use of `Rc<[T]>` and completing the
9187   implementation of DST.
9188 * [Parallel codegen][parcodegen] is now working again, which can
9189   substantially speed up large builds in debug mode; It also gets
9190   another ~33% speedup when bootstrapping on a 4 core machine (using 8
9191   jobs). It's not enabled by default, but will be "in the near
9192   future". It can be activated with the `-C codegen-units=N` flag to
9193   `rustc`.
9194 * This is the first release with [experimental support for linking
9195   with the MSVC linker and lib C on Windows (instead of using the GNU
9196   variants via MinGW)][win]. It is yet recommended only for the most
9197   intrepid Rustaceans.
9198 * Benchmark compilations are showing a 30% improvement in
9199   bootstrapping over 1.1.
9200
9201 Breaking Changes
9202 ----------------
9203
9204 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
9205   unicode case mapping, which is a previously-planned change in
9206   behavior and considered a bugfix.
9207 * [`mem::align_of`] now specifies [the *minimum alignment* for
9208   T][align], which is usually the alignment programs are interested
9209   in, and the same value reported by clang's
9210   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
9211   break real code.
9212 * [The `#[packed]` attribute is no longer silently accepted by the
9213   compiler][packed]. This attribute did nothing and code that
9214   mentioned it likely did not work as intended.
9215 * Associated type defaults are [now behind the
9216   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
9217   defaults *did not work*, but could be mentioned syntactically. As
9218   such this breakage has minimal impact.
9219
9220 Language
9221 --------
9222
9223 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
9224   matching against dereferenceable values.
9225
9226 Libraries
9227 ---------
9228
9229 * The [`Extend`] trait, which grows a collection from an iterator, is
9230   implemented over iterators of references, for `String`, `Vec`,
9231   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
9232   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
9233 * The [`iter::once`] function returns an iterator that yields a single
9234   element, and [`iter::empty`] returns an iterator that yields no
9235   elements.
9236 * The [`matches`] and [`rmatches`] methods on `str` return iterators
9237   over substring matches.
9238 * [`Cell`] and [`RefCell`] both implement `Eq`.
9239 * A number of methods for wrapping arithmetic are added to the
9240   integral types, [`wrapping_div`], [`wrapping_rem`],
9241   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
9242   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
9243   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
9244   type.. It is illegal for the default arithmetic operations in Rust
9245   to overflow; the desire to wrap must be explicit.
9246 * The `{:#?}` formatting specifier [displays the alternate,
9247   pretty-printed][debugfmt] form of the `Debug` formatter. This
9248   feature was actually introduced prior to 1.0 with little
9249   fanfare.
9250 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
9251   for writing data to formatted strings, similar to [`io::Write`].
9252 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
9253   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
9254   are used by code generators to emit implementations of [`Debug`].
9255 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
9256   methods that convert case, following Unicode case mapping.
9257 * It is now easier to handle poisoned locks. The [`PoisonError`]
9258   type, returned by failing lock operations, exposes `into_inner`,
9259   `get_ref`, and `get_mut`, which all give access to the inner lock
9260   guard, and allow the poisoned lock to continue to operate. The
9261   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
9262   poisoned lock without attempting to take the lock.
9263 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
9264   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
9265   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
9266   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
9267   `ChildStderr`.
9268 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
9269   malformed input.
9270
9271 Misc
9272 ----
9273
9274 * `rustc` employs smarter heuristics for guessing at [typos].
9275 * `rustc` emits more efficient code for [no-op conversions between
9276   unsafe pointers][nop].
9277 * Fat pointers are now [passed in pairs of immediate arguments][fat],
9278   resulting in faster compile times and smaller code.
9279
9280 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
9281 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
9282 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
9283 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
9284 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
9285 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
9286 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
9287 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
9288 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
9289 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
9290 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
9291 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
9292 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
9293 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
9294 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
9295 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
9296 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
9297 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
9298 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
9299 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
9300 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
9301 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
9302 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
9303 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
9304 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
9305 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
9306 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
9307 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
9308 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
9309 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
9310 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
9311 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
9312 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
9313 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9314 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9315 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
9316 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
9317 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
9318 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
9319 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
9320 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
9321 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
9322 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
9323 [align]: https://github.com/rust-lang/rust/pull/25646
9324 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
9325 [typos]: https://github.com/rust-lang/rust/pull/26087
9326 [nop]: https://github.com/rust-lang/rust/pull/26336
9327 [fat]: https://github.com/rust-lang/rust/pull/26411
9328 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
9329 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
9330 [packed]: https://github.com/rust-lang/rust/pull/25541
9331 [ad]: https://github.com/rust-lang/rust/pull/27382
9332 [win]: https://github.com/rust-lang/rust/pull/25350
9333
9334 Version 1.1.0 (2015-06-25)
9335 =========================
9336
9337 * ~850 changes, numerous bugfixes
9338
9339 Highlights
9340 ----------
9341
9342 * The [`std::fs` module has been expanded][fs] to expand the set of
9343   functionality exposed:
9344   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
9345     don't incur a syscall on some platforms.
9346   * A `symlink_metadata` function has been added.
9347   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
9348     access to all underlying information.
9349 * The compiler now contains extended explanations of many errors. When an error
9350   with an explanation occurs the compiler suggests using the `--explain` flag
9351   to read the explanation. Error explanations are also [available online][err-index].
9352 * Thanks to multiple [improvements][sk] to [type checking][pre], as
9353   well as other work, the time to bootstrap the compiler decreased by
9354   32%.
9355
9356 Libraries
9357 ---------
9358
9359 * The [`str::split_whitespace`] method splits a string on unicode
9360   whitespace boundaries.
9361 * On both Windows and Unix, new extension traits provide conversion of
9362   I/O types to and from the underlying system handles. On Unix, these
9363   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
9364   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
9365   `TcpListener`, and `UpdSocket`. Further implementations for
9366   `std::process` will be stabilized later.
9367 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
9368   Windows, symlinks can be created with
9369   `std::os::windows::symlink_dir` and
9370   `std::os::windows::symlink_file`.
9371 * The `mpsc::Receiver` type can now be converted into an iterator with
9372   `into_iter` on the [`IntoIterator`] trait.
9373 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
9374   implementation of the [`From`] trait.
9375 * The `Debug` implementation for `RangeFull` [creates output that is
9376   more consistent with other implementations][rf].
9377 * [`Debug` is implemented for `File`][file].
9378 * The `Default` implementation for `Arc` [no longer requires `Sync +
9379   Send`][arc].
9380 * [The `Iterator` methods `count`, `nth`, and `last` have been
9381   overridden for slices to have *O*(1) performance instead of *O*(*n*)][si].
9382 * Incorrect handling of paths on Windows has been improved in both the
9383   compiler and the standard library.
9384 * [`AtomicPtr` gained a `Default` implementation][ap].
9385 * In accordance with Rust's policy on arithmetic overflow `abs` now
9386   [panics on overflow when debug assertions are enabled][abs].
9387 * The [`Cloned`] iterator, which was accidentally left unstable for
9388   1.0 [has been stabilized][c].
9389 * The [`Incoming`] iterator, which iterates over incoming TCP
9390   connections, and which was accidentally unnamable in 1.0, [is now
9391   properly exported][inc].
9392 * [`BinaryHeap`] no longer corrupts itself [when functions called by
9393   `sift_up` or `sift_down` panic][bh].
9394 * The [`split_off`] method of `LinkedList` [no longer corrupts
9395   the list in certain scenarios][ll].
9396
9397 Misc
9398 ----
9399
9400 * Type checking performance [has improved notably][sk] with
9401   [multiple improvements][pre].
9402 * The compiler [suggests code changes][ch] for more errors.
9403 * rustc and it's build system have experimental support for [building
9404   toolchains against MUSL][m] instead of glibc on Linux.
9405 * The compiler defines the `target_env` cfg value, which is used for
9406   distinguishing toolchains that are otherwise for the same
9407   platform. Presently this is set to `gnu` for common GNU Linux
9408   targets and for MinGW targets, and `musl` for MUSL Linux targets.
9409 * The [`cargo rustc`][crc] command invokes a build with custom flags
9410   to rustc.
9411 * [Android executables are always position independent][pie].
9412 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
9413   with `Drop`][24935].
9414
9415 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
9416 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
9417 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
9418 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
9419 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
9420 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
9421 [rf]: https://github.com/rust-lang/rust/pull/24491
9422 [err-index]: https://doc.rust-lang.org/error-index.html
9423 [sk]: https://github.com/rust-lang/rust/pull/24615
9424 [pre]: https://github.com/rust-lang/rust/pull/25323
9425 [file]: https://github.com/rust-lang/rust/pull/24598
9426 [ch]: https://github.com/rust-lang/rust/pull/24683
9427 [arc]: https://github.com/rust-lang/rust/pull/24695
9428 [si]: https://github.com/rust-lang/rust/pull/24701
9429 [ap]: https://github.com/rust-lang/rust/pull/24834
9430 [m]: https://github.com/rust-lang/rust/pull/24777
9431 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
9432 [crc]: https://github.com/rust-lang/cargo/pull/1568
9433 [pie]: https://github.com/rust-lang/rust/pull/24953
9434 [abs]: https://github.com/rust-lang/rust/pull/25441
9435 [c]: https://github.com/rust-lang/rust/pull/25496
9436 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
9437 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
9438 [inc]: https://github.com/rust-lang/rust/pull/25522
9439 [bh]: https://github.com/rust-lang/rust/pull/25856
9440 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
9441 [ll]: https://github.com/rust-lang/rust/pull/26022
9442 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
9443 [24935]: https://github.com/rust-lang/rust/pull/24935
9444
9445 Version 1.0.0 (2015-05-15)
9446 ========================
9447
9448 * ~1500 changes, numerous bugfixes
9449
9450 Highlights
9451 ----------
9452
9453 * The vast majority of the standard library is now `#[stable]`. It is
9454   no longer possible to use unstable features with a stable build of
9455   the compiler.
9456 * Many popular crates on [crates.io] now work on the stable release
9457   channel.
9458 * Arithmetic on basic integer types now [checks for overflow in debug
9459   builds][overflow].
9460
9461 Language
9462 --------
9463
9464 * Several [restrictions have been added to trait coherence][coh] in
9465   order to make it easier for upstream authors to change traits
9466   without breaking downstream code.
9467 * Digits of binary and octal literals are [lexed more eagerly][lex] to
9468   improve error messages and macro behavior. For example, `0b1234` is
9469   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
9470 * Trait bounds [are always invariant][inv], eliminating the need for
9471   the `PhantomFn` and `MarkerTrait` lang items, which have been
9472   removed.
9473 * ["-" is no longer a valid character in crate names][cr], the `extern crate
9474   "foo" as bar` syntax has been replaced with `extern crate foo as
9475   bar`, and Cargo now automatically translates "-" in *package* names
9476   to underscore for the crate name.
9477 * [Lifetime shadowing is an error][lt].
9478 * [`Send` no longer implies `'static`][send-rfc].
9479 * [UFCS now supports trait-less associated paths][moar-ufcs] like
9480   `MyType::default()`.
9481 * Primitive types [now have inherent methods][prim-inherent],
9482   obviating the need for extension traits like `SliceExt`.
9483 * Methods with `Self: Sized` in their `where` clause are [considered
9484   object-safe][self-sized], allowing many extension traits like
9485   `IteratorExt` to be merged into the traits they extended.
9486 * You can now [refer to associated types][assoc-where] whose
9487   corresponding trait bounds appear only in a `where` clause.
9488 * The final bits of [OIBIT landed][oibit-final], meaning that traits
9489   like `Send` and `Sync` are now library-defined.
9490 * A [Reflect trait][reflect] was introduced, which means that
9491   downcasting via the `Any` trait is effectively limited to concrete
9492   types. This helps retain the potentially-important "parametricity"
9493   property: generic code cannot behave differently for different type
9494   arguments except in minor ways.
9495 * The `unsafe_destructor` feature is now deprecated in favor of the
9496   [new `dropck`][rfc769]. This change is a major reduction in unsafe
9497   code.
9498
9499 Libraries
9500 ---------
9501
9502 * The `thread_local` module [has been renamed to `std::thread`][th].
9503 * The methods of `IteratorExt` [have been moved to the `Iterator`
9504   trait itself][23300].
9505 * Several traits that implement Rust's conventions for type
9506   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
9507   [centralized in the `std::convert` module][con].
9508 * The `FromError` trait [was removed in favor of `From`][fe].
9509 * The basic sleep function [has moved to
9510   `std::thread::sleep_ms`][slp].
9511 * The `splitn` function now takes an `n` parameter that represents the
9512   number of items yielded by the returned iterator [instead of the
9513   number of 'splits'][spl].
9514 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
9515 * [Derived implementations of `PartialOrd` now order enums according
9516   to their explicitly-assigned discriminants][po].
9517 * [Methods for searching strings are generic over `Pattern`s][pat],
9518   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
9519   some others.
9520 * [In method resolution, object methods are resolved before inherent
9521   methods][meth].
9522 * [`String::from_str` has been deprecated in favor of the `From` impl,
9523   `String::from`][24517].
9524 * [`io::Error` implements `Sync`][ios].
9525 * [The `words` method on `&str` has been replaced with
9526   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
9527   a word?'
9528 * The new path and IO modules are complete and `#[stable]`. This
9529   was the major library focus for this cycle.
9530 * The path API was [revised][path-normalize] to normalize `.`,
9531   adjusting the tradeoffs in favor of the most common usage.
9532 * A large number of remaining APIs in `std` were also stabilized
9533   during this cycle; about 75% of the non-deprecated API surface
9534   is now stable.
9535 * The new [string pattern API][string-pattern] landed, which makes
9536   the string slice API much more internally consistent and flexible.
9537 * A new set of [generic conversion traits][conversion] replaced
9538   many existing ad hoc traits.
9539 * Generic numeric traits were [completely removed][num-traits]. This
9540   was made possible thanks to inherent methods for primitive types,
9541   and the removal gives maximal flexibility for designing a numeric
9542   hierarchy in the future.
9543 * The `Fn` traits are now related via [inheritance][fn-inherit]
9544   and provide ergonomic [blanket implementations][fn-blanket].
9545 * The `Index` and `IndexMut` traits were changed to
9546   [take the index by value][index-value], enabling code like
9547   `hash_map["string"]` to work.
9548 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
9549   `Copy` data is known to be `Clone` as well.
9550
9551 Misc
9552 ----
9553
9554 * Many errors now have extended explanations that can be accessed with
9555   the `--explain` flag to `rustc`.
9556 * Many new examples have been added to the standard library
9557   documentation.
9558 * rustdoc has received a number of improvements focused on completion
9559   and polish.
9560 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9561 * Much headway was made on ecosystem-wide CI, making it possible
9562   to [compare builds for breakage][ci-compare].
9563
9564
9565 [crates.io]: http://crates.io
9566 [clo]: https://github.com/rust-lang/rust/pull/24034
9567 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9568 [con]: https://github.com/rust-lang/rust/pull/23875
9569 [cr]: https://github.com/rust-lang/rust/pull/23419
9570 [fe]: https://github.com/rust-lang/rust/pull/23879
9571 [23300]: https://github.com/rust-lang/rust/pull/23300
9572 [inv]: https://github.com/rust-lang/rust/pull/23938
9573 [ios]: https://github.com/rust-lang/rust/pull/24133
9574 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9575 [lt]: https://github.com/rust-lang/rust/pull/24057
9576 [meth]: https://github.com/rust-lang/rust/pull/24056
9577 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9578 [po]: https://github.com/rust-lang/rust/pull/24270
9579 [24517]: https://github.com/rust-lang/rust/pull/24517
9580 [slp]: https://github.com/rust-lang/rust/pull/23949
9581 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9582 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9583 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9584 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9585 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9586 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9587 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9588 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9589 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9590 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9591 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9592 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9593 [reflect]: https://github.com/rust-lang/rust/pull/23712
9594 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9595 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9596 [index-value]: https://github.com/rust-lang/rust/pull/23601
9597 [rfc769]: https://github.com/rust-lang/rfcs/pull/769
9598 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9599 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9600 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9601 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9602 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9603
9604
9605 Version 1.0.0-alpha.2 (2015-02-20)
9606 =====================================
9607
9608 * ~1300 changes, numerous bugfixes
9609
9610 * Highlights
9611
9612     * The various I/O modules were [overhauled][io-rfc] to reduce
9613       unnecessary abstractions and provide better interoperation with
9614       the underlying platform. The old `io` module remains temporarily
9615       at `std::old_io`.
9616     * The standard library now [participates in feature gating][feat],
9617       so use of unstable libraries now requires a `#![feature(...)]`
9618       attribute. The impact of this change is [described on the
9619       forum][feat-forum]. [RFC][feat-rfc].
9620
9621 * Language
9622
9623     * `for` loops [now operate on the `IntoIterator` trait][into],
9624       which eliminates the need to call `.iter()`, etc. to iterate
9625       over collections. There are some new subtleties to remember
9626       though regarding what sort of iterators various types yield, in
9627       particular that `for foo in bar { }` yields values from a move
9628       iterator, destroying the original collection. [RFC][into-rfc].
9629     * Objects now have [default lifetime bounds][obj], so you don't
9630       have to write `Box<Trait+'static>` when you don't care about
9631       storing references. [RFC][obj-rfc].
9632     * In types that implement `Drop`, [lifetimes must outlive the
9633       value][drop]. This will soon make it possible to safely
9634       implement `Drop` for types where `#[unsafe_destructor]` is now
9635       required. Read the [gorgeous RFC][drop-rfc] for details.
9636     * The fully qualified <T as Trait>::X syntax lets you set the Self
9637       type for a trait method or associated type. [RFC][ufcs-rfc].
9638     * References to types that implement `Deref<U>` now [automatically
9639       coerce to references][deref] to the dereferenced type `U`,
9640       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9641       should eliminate many unsightly uses of `&*`, as when converting
9642       from references to vectors into references to
9643       slices. [RFC][deref-rfc].
9644     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9645       `|:|`) is obsolete and closure kind is inferred from context.
9646     * [`Self` is a keyword][Self].
9647
9648 * Libraries
9649
9650     * The `Show` and `String` formatting traits [have been
9651       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9652       their related purposes. Automatically getting a string
9653       conversion to use with `format!("{:?}", something_to_debug)` is
9654       now written `#[derive(Debug)]`.
9655     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9656       OsStr}`, provide strings in platform-specific encodings for easier
9657       interop with system APIs. [RFC][osstr-rfc].
9658     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9659       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9660       creating raw pointers.
9661
9662 * Tooling
9663
9664     * Certain long error messages of the form 'expected foo found bar'
9665       are now [split neatly across multiple
9666       lines][multiline]. Examples in the PR.
9667     * On Unix Rust can be [uninstalled][un] by running
9668       `/usr/local/lib/rustlib/uninstall.sh`.
9669     * The `#[rustc_on_unimplemented]` attribute, requiring the
9670       'on_unimplemented' feature, lets rustc [display custom error
9671       messages when a trait is expected to be implemented for a type
9672       but is not][onun].
9673
9674 * Misc
9675
9676     * Rust is tested against a [LALR grammar][lalr], which parses
9677       almost all the Rust files that rustc does.
9678
9679 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9680 [close]: https://github.com/rust-lang/rust/pull/21843
9681 [deref]: https://github.com/rust-lang/rust/pull/21351
9682 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9683 [drop]: https://github.com/rust-lang/rust/pull/21972
9684 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9685 [feat]: https://github.com/rust-lang/rust/pull/21248
9686 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9687 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9688 [fmt]: https://github.com/rust-lang/rust/pull/21457
9689 [into]: https://github.com/rust-lang/rust/pull/20790
9690 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9691 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9692 [lalr]: https://github.com/rust-lang/rust/pull/21452
9693 [multiline]: https://github.com/rust-lang/rust/pull/19870
9694 [obj]: https://github.com/rust-lang/rust/pull/22230
9695 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9696 [onun]: https://github.com/rust-lang/rust/pull/20889
9697 [osstr]: https://github.com/rust-lang/rust/pull/21488
9698 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9699 [Self]: https://github.com/rust-lang/rust/pull/22158
9700 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9701 [un]: https://github.com/rust-lang/rust/pull/22256
9702
9703
9704 Version 1.0.0-alpha (2015-01-09)
9705 ==================================
9706
9707   * ~2400 changes, numerous bugfixes
9708
9709   * Highlights
9710
9711     * The language itself is considered feature complete for 1.0,
9712       though there will be many usability improvements and bugfixes
9713       before the final release.
9714     * Nearly 50% of the public API surface of the standard library has
9715       been declared 'stable'. Those interfaces are unlikely to change
9716       before 1.0.
9717     * The long-running debate over integer types has been
9718       [settled][ints]: Rust will ship with types named `isize` and
9719       `usize`, rather than `int` and `uint`, for pointer-sized
9720       integers. Guidelines will be rolled out during the alpha cycle.
9721     * Most crates that are not `std` have been moved out of the Rust
9722       distribution into the Cargo ecosystem so they can evolve
9723       separately and don't need to be stabilized as quickly, including
9724       'time', 'getopts', 'num', 'regex', and 'term'.
9725     * Documentation continues to be expanded with more API coverage, more
9726       examples, and more in-depth explanations. The guides have been
9727       consolidated into [The Rust Programming Language][trpl].
9728     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9729     * All official Rust binary installers now come with [Cargo], the
9730       Rust package manager.
9731
9732 * Language
9733
9734     * Closures have been [completely redesigned][unboxed] to be
9735       implemented in terms of traits, can now be used as generic type
9736       bounds and thus monomorphized and inlined, or via an opaque
9737       pointer (boxed) as in the old system. The new system is often
9738       referred to as 'unboxed' closures.
9739     * Traits now support [associated types][assoc], allowing families
9740       of related types to be defined together and used generically in
9741       powerful ways.
9742     * Enum variants are [namespaced by their type names][enum].
9743     * [`where` clauses][where] provide a more versatile and attractive
9744       syntax for specifying generic bounds, though the previous syntax
9745       remains valid.
9746     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9747       numeric types.
9748     * Rust [no longer has a runtime][rt] of any description, and only
9749       supports OS threads, not green threads.
9750     * At long last, Rust has been overhauled for 'dynamically-sized
9751       types' ([DST]), which integrates 'fat pointers' (object types,
9752       arrays, and `str`) more deeply into the type system, making it
9753       more consistent.
9754     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9755       `..j` that produce range types and which, when combined with the
9756       `Index` operator and multidispatch, leads to a convenient slice
9757       notation, `[i..j]`.
9758     * The new range syntax revealed an ambiguity in the fixed-length
9759       array syntax, so now fixed length arrays [are written `[T;
9760       N]`][arrays].
9761     * The `Copy` trait is no longer implemented automatically. Unsafe
9762       pointers no longer implement `Sync` and `Send` so types
9763       containing them don't automatically either. `Sync` and `Send`
9764       are now 'unsafe traits' so one can "forcibly" implement them via
9765       `unsafe impl` if a type confirms to the requirements for them
9766       even though the internals do not (e.g. structs containing unsafe
9767       pointers like `Arc`). These changes are intended to prevent some
9768       footguns and are collectively known as [opt-in built-in
9769       traits][oibit] (though `Sync` and `Send` will soon become pure
9770       library types unknown to the compiler).
9771     * Operator traits now take their operands [by value][ops], and
9772       comparison traits can use multidispatch to compare one type
9773       against multiple other types, allowing e.g. `String` to be
9774       compared with `&str`.
9775     * `if let` and `while let` are no longer feature-gated.
9776     * Rust has adopted a more [uniform syntax for escaping unicode
9777       characters][unicode].
9778     * `macro_rules!` [has been declared stable][mac]. Though it is a
9779       flawed system it is sufficiently popular that it must be usable
9780       for 1.0. Effort has gone into [future-proofing][mac-future] it
9781       in ways that will allow other macro systems to be developed in
9782       parallel, and won't otherwise impact the evolution of the
9783       language.
9784     * The prelude has been [pared back significantly][prelude] such
9785       that it is the minimum necessary to support the most pervasive
9786       code patterns, and through [generalized where clauses][where]
9787       many of the prelude extension traits have been consolidated.
9788     * Rust's rudimentary reflection [has been removed][refl], as it
9789       incurred too much code generation for little benefit.
9790     * [Struct variants][structvars] are no longer feature-gated.
9791     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9792       known as 'higher-ranked trait bounds', this crucially allows
9793       unboxed closures to work.
9794     * Macros invocations surrounded by parens or square brackets and
9795       not terminated by a semicolon are [parsed as
9796       expressions][macros], which makes expressions like `vec![1i32,
9797       2, 3].len()` work as expected.
9798     * Trait objects now implement their traits automatically, and
9799       traits that can be coerced to objects now must be [object
9800       safe][objsafe].
9801     * Automatically deriving traits is now done with `#[derive(...)]`
9802       not `#[deriving(...)]` for [consistency with other naming
9803       conventions][derive].
9804     * Importing the containing module or enum at the same time as
9805       items or variants they contain is [now done with `self` instead
9806       of `mod`][self], as in use `foo::{self, bar}`
9807     * Glob imports are no longer feature-gated.
9808     * The `box` operator and `box` patterns have been feature-gated
9809       pending a redesign. For now unique boxes should be allocated
9810       like other containers, with `Box::new`.
9811
9812 * Libraries
9813
9814     * A [series][coll1] of [efforts][coll2] to establish
9815       [conventions][coll3] for collections types has resulted in API
9816       improvements throughout the standard library.
9817     * New [APIs for error handling][err] provide ergonomic interop
9818       between error types, and [new conventions][err-conv] describe
9819       more clearly the recommended error handling strategies in Rust.
9820     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9821       it is easier to discuss failure in the context of error handling
9822       without making clarifications as to whether you are referring to
9823       the 'fail' macro or failure more generally.
9824     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9825       syscall when available.
9826     * The 'serialize' crate has been renamed 'rustc-serialize' and
9827       moved out of the distribution to Cargo. Although it is widely
9828       used now, it is expected to be superseded in the near future.
9829     * The `Show` formatter, typically implemented with
9830       `#[derive(Show)]` is [now requested with the `{:?}`
9831       specifier][show] and is intended for use by all types, for uses
9832       such as `println!` debugging. The new `String` formatter must be
9833       implemented by hand, uses the `{}` specifier, and is intended
9834       for full-fidelity conversions of things that can logically be
9835       represented as strings.
9836
9837 * Tooling
9838
9839     * [Flexible target specification][flex] allows rustc's code
9840       generation to be configured to support otherwise-unsupported
9841       platforms.
9842     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9843       respective debuggers with Rust-appropriate pretty-printing.
9844     * The Windows installation of Rust is distributed with the
9845       MinGW components currently required to link binaries on that
9846       platform.
9847
9848 * Misc
9849
9850     * Nullable enum optimizations have been extended to more types so
9851       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9852       space than the inner types themselves.
9853     * Work has begun on supporting AArch64.
9854
9855 [Cargo]: https://crates.io
9856 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9857 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9858 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9859 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9860 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9861 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9862 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9863 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9864 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9865 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9866 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9867 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9868 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9869 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9870 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9871 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9872 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9873 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9874 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9875 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9876 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9877 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9878 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9879 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9880 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9881 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9882 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9883 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9884 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9885 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9886 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9887 [trpl]: https://doc.rust-lang.org/book/index.html
9888 [rbe]: http://rustbyexample.com/
9889
9890
9891 Version 0.12.0 (2014-10-09)
9892 =============================
9893
9894   * ~1900 changes, numerous bugfixes
9895
9896   * Highlights
9897
9898     * The introductory documentation (now called The Rust Guide) has
9899       been completely rewritten, as have a number of supplementary
9900       guides.
9901     * Rust's package manager, Cargo, continues to improve and is
9902       sometimes considered to be quite awesome.
9903     * Many API's in `std` have been reviewed and updated for
9904       consistency with the in-development Rust coding
9905       guidelines. The standard library documentation tracks
9906       stabilization progress.
9907     * Minor libraries have been moved out-of-tree to the rust-lang org
9908       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9909       be installed with Cargo.
9910     * Lifetime elision allows lifetime annotations to be left off of
9911       function declarations in many common scenarios.
9912     * Rust now works on 64-bit Windows.
9913
9914   * Language
9915     * Indexing can be overloaded with the `Index` and `IndexMut`
9916       traits.
9917     * The `if let` construct takes a branch only if the `let` pattern
9918       matches, currently behind the 'if_let' feature gate.
9919     * 'where clauses', a more flexible syntax for specifying trait
9920       bounds that is more aesthetic, have been added for traits and
9921       free functions. Where clauses will in the future make it
9922       possible to constrain associated types, which would be
9923       impossible with the existing syntax.
9924     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9925       the 'slicing_syntax' feature gate, and can be overloaded with
9926       the `Slice` or `SliceMut` traits.
9927     * The syntax for matching of sub-slices has been changed to use a
9928       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9929       consistency with other uses of `..` and to future-proof
9930       potential additional uses of the syntax.
9931     * The syntax for matching inclusive ranges in patterns has changed
9932       from `0..3` to `0...4` to be consistent with the exclusive range
9933       syntax for slicing.
9934     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9935       c]`) has been put behind the 'advanced_slice_patterns' feature
9936       gate and may be removed in the future.
9937     * Components of tuples and tuple structs can be extracted using
9938       the `value.0` syntax, currently behind the `tuple_indexing`
9939       feature gate.
9940     * The `#[crate_id]` attribute is no longer supported; versioning
9941       is handled by the package manager.
9942     * Renaming crate imports are now written `extern crate foo as bar`
9943       instead of `extern crate bar = foo`.
9944     * Renaming use statements are now written `use foo as bar` instead
9945       of `use bar = foo`.
9946     * `let` and `match` bindings and argument names in macros are now
9947       hygienic.
9948     * The new, more efficient, closure types ('unboxed closures') have
9949       been added under a feature gate, 'unboxed_closures'. These will
9950       soon replace the existing closure types, once higher-ranked
9951       trait lifetimes are added to the language.
9952     * `move` has been added as a keyword, for indicating closures
9953       that capture by value.
9954     * Mutation and assignment is no longer allowed in pattern guards.
9955     * Generic structs and enums can now have trait bounds.
9956     * The `Share` trait is now called `Sync` to free up the term
9957       'shared' to refer to 'shared reference' (the default reference
9958       type.
9959     * Dynamically-sized types have been mostly implemented,
9960       unifying the behavior of fat-pointer types with the rest of the
9961       type system.
9962     * As part of dynamically-sized types, the `Sized` trait has been
9963       introduced, which qualifying types implement by default, and
9964       which type parameters expect by default. To specify that a type
9965       parameter does not need to be sized, write `<Sized? T>`. Most
9966       types are `Sized`, notable exceptions being unsized arrays
9967       (`[T]`) and trait types.
9968     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9969     * Lifetime bounds can now be applied to type parameters and object
9970       types.
9971     * The old, reference counted GC type, `Gc<T>` which was once
9972       denoted by the `@` sigil, has finally been removed. GC will be
9973       revisited in the future.
9974
9975   * Libraries
9976     * Library documentation has been improved for a number of modules.
9977     * Bit-vectors, collections::bitv has been modernized.
9978     * The url crate is deprecated in favor of
9979       http://github.com/servo/rust-url, which can be installed with
9980       Cargo.
9981     * Most I/O stream types can be cloned and subsequently closed from
9982       a different thread.
9983     * A `std::time::Duration` type has been added for use in I/O
9984       methods that rely on timers, as well as in the 'time' crate's
9985       `Timespec` arithmetic.
9986     * The runtime I/O abstraction layer that enabled the green thread
9987       scheduler to do non-thread-blocking I/O has been removed, along
9988       with the libuv-based implementation employed by the green thread
9989       scheduler. This will greatly simplify the future I/O work.
9990     * `collections::btree` has been rewritten to have a more
9991       idiomatic and efficient design.
9992
9993   * Tooling
9994     * rustdoc output now indicates the stability levels of API's.
9995     * The `--crate-name` flag can specify the name of the crate
9996       being compiled, like `#[crate_name]`.
9997     * The `-C metadata` specifies additional metadata to hash into
9998       symbol names, and `-C extra-filename` specifies additional
9999       information to put into the output filename, for use by the
10000       package manager for versioning.
10001     * debug info generation has continued to improve and should be
10002       more reliable under both gdb and lldb.
10003     * rustc has experimental support for compiling in parallel
10004       using the `-C codegen-units` flag.
10005     * rustc no longer encodes rpath information into binaries by
10006       default.
10007
10008   * Misc
10009     * Stack usage has been optimized with LLVM lifetime annotations.
10010     * Official Rust binaries on Linux are more compatible with older
10011       kernels and distributions, built on CentOS 5.10.
10012
10013
10014 Version 0.11.0 (2014-07-02)
10015 ==========================
10016
10017   * ~1700 changes, numerous bugfixes
10018
10019   * Language
10020     * ~[T] has been removed from the language. This type is superseded by
10021       the Vec<T> type.
10022     * ~str has been removed from the language. This type is superseded by
10023       the String type.
10024     * ~T has been removed from the language. This type is superseded by the
10025       Box<T> type.
10026     * @T has been removed from the language. This type is superseded by the
10027       standard library's std::gc::Gc<T> type.
10028     * Struct fields are now all private by default.
10029     * Vector indices and shift amounts are both required to be a `uint`
10030       instead of any integral type.
10031     * Byte character, byte string, and raw byte string literals are now all
10032       supported by prefixing the normal literal with a `b`.
10033     * Multiple ABIs are no longer allowed in an ABI string
10034     * The syntax for lifetimes on closures/procedures has been tweaked
10035       slightly: `<'a>|A, B|: 'b + K -> T`
10036     * Floating point modulus has been removed from the language; however it
10037       is still provided by a library implementation.
10038     * Private enum variants are now disallowed.
10039     * The `priv` keyword has been removed from the language.
10040     * A closure can no longer be invoked through a &-pointer.
10041     * The `use foo, bar, baz;` syntax has been removed from the language.
10042     * The transmute intrinsic no longer works on type parameters.
10043     * Statics now allow blocks/items in their definition.
10044     * Trait bounds are separated from objects with + instead of : now.
10045     * Objects can no longer be read while they are mutably borrowed.
10046     * The address of a static is now marked as insignificant unless the
10047       #[inline(never)] attribute is placed it.
10048     * The #[unsafe_destructor] attribute is now behind a feature gate.
10049     * Struct literals are no longer allowed in ambiguous positions such as
10050       if, while, match, and for..in.
10051     * Declaration of lang items and intrinsics are now feature-gated by
10052       default.
10053     * Integral literals no longer default to `int`, and floating point
10054       literals no longer default to `f64`. Literals must be suffixed with an
10055       appropriate type if inference cannot determine the type of the
10056       literal.
10057     * The Box<T> type is no longer implicitly borrowed to &mut T.
10058     * Procedures are now required to not capture borrowed references.
10059
10060   * Libraries
10061     * The standard library is now a "facade" over a number of underlying
10062       libraries. This means that development on the standard library should
10063       be speedier due to smaller crates, as well as a clearer line between
10064       all dependencies.
10065     * A new library, libcore, lives under the standard library's facade
10066       which is Rust's "0-assumption" library, suitable for embedded and
10067       kernel development for example.
10068     * A regex crate has been added to the standard distribution. This crate
10069       includes statically compiled regular expressions.
10070     * The unwrap/unwrap_err methods on Result require a Show bound for
10071       better error messages.
10072     * The return types of the std::comm primitives have been centralized
10073       around the Result type.
10074     * A number of I/O primitives have gained the ability to time out their
10075       operations.
10076     * A number of I/O primitives have gained the ability to close their
10077       reading/writing halves to cancel pending operations.
10078     * Reverse iterator methods have been removed in favor of `rev()` on
10079       their forward-iteration counterparts.
10080     * A bitflags! macro has been added to enable easy interop with C and
10081       management of bit flags.
10082     * A debug_assert! macro is now provided which is disabled when
10083       `--cfg ndebug` is passed to the compiler.
10084     * A graphviz crate has been added for creating .dot files.
10085     * The std::cast module has been migrated into std::mem.
10086     * The std::local_data api has been migrated from freestanding functions
10087       to being based on methods.
10088     * The Pod trait has been renamed to Copy.
10089     * jemalloc has been added as the default allocator for types.
10090     * The API for allocating memory has been changed to use proper alignment
10091       and sized deallocation
10092     * Connecting a TcpStream or binding a TcpListener is now based on a
10093       string address and a u16 port. This allows connecting to a hostname as
10094       opposed to an IP.
10095     * The Reader trait now contains a core method, read_at_least(), which
10096       correctly handles many repeated 0-length reads.
10097     * The process-spawning API is now centered around a builder-style
10098       Command struct.
10099     * The :? printing qualifier has been moved from the standard library to
10100       an external libdebug crate.
10101     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
10102       have been renamed to Eq/Ord.
10103     * The select/plural methods have been removed from format!. The escapes
10104       for { and } have also changed from \{ and \} to {{ and }},
10105       respectively.
10106     * The TaskBuilder API has been re-worked to be a true builder, and
10107       extension traits for spawning native/green tasks have been added.
10108
10109   * Tooling
10110     * All breaking changes to the language or libraries now have their
10111       commit message annotated with `[breaking-change]` to allow for easy
10112       discovery of breaking changes.
10113     * The compiler will now try to suggest how to annotate lifetimes if a
10114       lifetime-related error occurs.
10115     * Debug info continues to be improved greatly with general bug fixes and
10116       better support for situations like link time optimization (LTO).
10117     * Usage of syntax extensions when cross-compiling has been fixed.
10118     * Functionality equivalent to GCC & Clang's -ffunction-sections,
10119       -fdata-sections and --gc-sections has been enabled by default
10120     * The compiler is now stricter about where it will load module files
10121       from when a module is declared via `mod foo;`.
10122     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
10123       Syntax extensions are now discovered via a "plugin registrar" type
10124       which will be extended in the future to other various plugins.
10125     * Lints have been restructured to allow for dynamically loadable lints.
10126     * A number of rustdoc improvements:
10127       * The HTML output has been visually redesigned.
10128       * Markdown is now powered by hoedown instead of sundown.
10129       * Searching heuristics have been greatly improved.
10130       * The search index has been reduced in size by a great amount.
10131       * Cross-crate documentation via `pub use` has been greatly improved.
10132       * Primitive types are now hyperlinked and documented.
10133     * Documentation has been moved from static.rust-lang.org/doc to
10134       doc.rust-lang.org
10135     * A new sandbox, play.rust-lang.org, is available for running and
10136       sharing rust code examples on-line.
10137     * Unused attributes are now more robustly warned about.
10138     * The dead_code lint now warns about unused struct fields.
10139     * Cross-compiling to iOS is now supported.
10140     * Cross-compiling to mipsel is now supported.
10141     * Stability attributes are now inherited by default and no longer apply
10142       to intra-crate usage, only inter-crate usage.
10143     * Error message related to non-exhaustive match expressions have been
10144       greatly improved.
10145
10146
10147 Version 0.10 (2014-04-03)
10148 =========================
10149
10150   * ~1500 changes, numerous bugfixes
10151
10152   * Language
10153     * A new RFC process is now in place for modifying the language.
10154     * Patterns with `@`-pointers have been removed from the language.
10155     * Patterns with unique vectors (`~[T]`) have been removed from the
10156       language.
10157     * Patterns with unique strings (`~str`) have been removed from the
10158       language.
10159     * `@str` has been removed from the language.
10160     * `@[T]` has been removed from the language.
10161     * `@self` has been removed from the language.
10162     * `@Trait` has been removed from the language.
10163     * Headers on `~` allocations which contain `@` boxes inside the type for
10164       reference counting have been removed.
10165     * The semantics around the lifetimes of temporary expressions have changed,
10166       see #3511 and #11585 for more information.
10167     * Cross-crate syntax extensions are now possible, but feature gated. See
10168       #11151 for more information. This includes both `macro_rules!` macros as
10169       well as syntax extensions such as `format!`.
10170     * New lint modes have been added, and older ones have been turned on to be
10171       warn-by-default.
10172       * Unnecessary parentheses
10173       * Uppercase statics
10174       * Camel Case types
10175       * Uppercase variables
10176       * Publicly visible private types
10177       * `#[deriving]` with raw pointers
10178     * Unsafe functions can no longer be coerced to closures.
10179     * Various obscure macros such as `log_syntax!` are now behind feature gates.
10180     * The `#[simd]` attribute is now behind a feature gate.
10181     * Visibility is no longer allowed on `extern crate` statements, and
10182       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
10183     * Trailing commas are now allowed in argument lists and tuple patterns.
10184     * The `do` keyword has been removed, it is now a reserved keyword.
10185     * Default type parameters have been implemented, but are feature gated.
10186     * Borrowed variables through captures in closures are now considered soundly.
10187     * `extern mod` is now `extern crate`
10188     * The `Freeze` trait has been removed.
10189     * The `Share` trait has been added for types that can be shared among
10190       threads.
10191     * Labels in macros are now hygienic.
10192     * Expression/statement macro invocations can be delimited with `{}` now.
10193     * Treatment of types allowed in `static mut` locations has been tweaked.
10194     * The `*` and `.` operators are now overloadable through the `Deref` and
10195       `DerefMut` traits.
10196     * `~Trait` and `proc` no longer have `Send` bounds by default.
10197     * Partial type hints are now supported with the `_` type marker.
10198     * An `Unsafe` type was introduced for interior mutability. It is now
10199       considered undefined to transmute from `&T` to `&mut T` without using the
10200       `Unsafe` type.
10201     * The #[linkage] attribute was implemented for extern statics/functions.
10202     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
10203     * `Pod` was renamed to `Copy`.
10204
10205   * Libraries
10206     * The `libextra` library has been removed. It has now been decomposed into
10207       component libraries with smaller and more focused nuggets of
10208       functionality. The full list of libraries can be found on the
10209       documentation index page.
10210     * std: `std::condition` has been removed. All I/O errors are now propagated
10211       through the `Result` type. In order to assist with error handling, a
10212       `try!` macro for unwrapping errors with an early return and a lint for
10213       unused results has been added. See #12039 for more information.
10214     * std: The `vec` module has been renamed to `slice`.
10215     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
10216       This will become the only growable vector in the future.
10217     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
10218       are now found at `std::io::BufferedReader` instead of
10219       `std::io::buffered::BufferedReader`.
10220     * std: `print` and `println` are no longer in the prelude, the `print!` and
10221       `println!` macros are intended to be used instead.
10222     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
10223       attempts to statically prevent cycles.
10224     * std: The standard distribution is adopting the policy of pushing failure
10225       to the user rather than failing in libraries. Many functions (such as
10226       `slice::last()`) now return `Option<T>` instead of `T` + failing.
10227     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
10228       deriving mode: `#[deriving(Show)]`.
10229     * std: `ToStr` is now implemented for all types implementing `Show`.
10230     * std: The formatting trait methods now take `&self` instead of `&T`
10231     * std: The `invert()` method on iterators has been renamed to `rev()`
10232     * std: `std::num` has seen a reduction in the genericity of its traits,
10233       consolidating functionality into a few core traits.
10234     * std: Backtraces are now printed on task failure if the environment
10235       variable `RUST_BACKTRACE` is present.
10236     * std: Naming conventions for iterators have been standardized. More details
10237       can be found on the wiki's style guide.
10238     * std: `eof()` has been removed from the `Reader` trait. Specific types may
10239       still implement the function.
10240     * std: Networking types are now cloneable to allow simultaneous reads/writes.
10241     * std: `assert_approx_eq!` has been removed
10242     * std: The `e` and `E` formatting specifiers for floats have been added to
10243       print them in exponential notation.
10244     * std: The `Times` trait has been removed
10245     * std: Indications of variance and opting out of builtin bounds is done
10246       through marker types in `std::kinds::marker` now
10247     * std: `hash` has been rewritten, `IterBytes` has been removed, and
10248       `#[deriving(Hash)]` is now possible.
10249     * std: `SharedChan` has been removed, `Sender` is now cloneable.
10250     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
10251     * std: `Chan::new` is now `channel()`.
10252     * std: A new synchronous channel type has been implemented.
10253     * std: A `select!` macro is now provided for selecting over `Receiver`s.
10254     * std: `hashmap` and `trie` have been moved to `libcollections`
10255     * std: `run` has been rolled into `io::process`
10256     * std: `assert_eq!` now uses `{}` instead of `{:?}`
10257     * std: The equality and comparison traits have seen some reorganization.
10258     * std: `rand` has moved to `librand`.
10259     * std: `to_{lower,upper}case` has been implemented for `char`.
10260     * std: Logging has been moved to `liblog`.
10261     * collections: `HashMap` has been rewritten for higher performance and less
10262       memory usage.
10263     * native: The default runtime is now `libnative`. If `libgreen` is desired,
10264       it can be booted manually. The runtime guide has more information and
10265       examples.
10266     * native: All I/O functionality except signals has been implemented.
10267     * green: Task spawning with `libgreen` has been optimized with stack caching
10268       and various trimming of code.
10269     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
10270     * sync: The `extra::sync` module has been updated to modern rust (and moved
10271       to the `sync` library), tweaking and improving various interfaces while
10272       dropping redundant functionality.
10273     * sync: A new `Barrier` type has been added to the `sync` library.
10274     * sync: An efficient mutex for native and green tasks has been implemented.
10275     * serialize: The `base64` module has seen some improvement. It treats
10276       newlines better, has non-string error values, and has seen general
10277       cleanup.
10278     * fourcc: A `fourcc!` macro was introduced
10279     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
10280       hexadecimal literal.
10281
10282   * Tooling
10283     * `rustpkg` has been deprecated and removed from the main repository. Its
10284       replacement, `cargo`, is under development.
10285     * Nightly builds of rust are now available
10286     * The memory usage of rustc has been improved many times throughout this
10287       release cycle.
10288     * The build process supports disabling rpath support for the rustc binary
10289       itself.
10290     * Code generation has improved in some cases, giving more information to the
10291       LLVM optimization passes to enable more extensive optimizations.
10292     * Debuginfo compatibility with lldb on OSX has been restored.
10293     * The master branch is now gated on an android bot, making building for
10294       android much more reliable.
10295     * Output flags have been centralized into one `--emit` flag.
10296     * Crate type flags have been centralized into one `--crate-type` flag.
10297     * Codegen flags have been consolidated behind a `-C` flag.
10298     * Linking against outdated crates now has improved error messages.
10299     * Error messages with lifetimes will often suggest how to annotate the
10300       function to fix the error.
10301     * Many more types are documented in the standard library, and new guides
10302       were written.
10303     * Many `rustdoc` improvements:
10304       * code blocks are syntax highlighted.
10305       * render standalone markdown files.
10306       * the --test flag tests all code blocks by default.
10307       * exported macros are displayed.
10308       * re-exported types have their documentation inlined at the location of the
10309         first re-export.
10310       * search works across crates that have been rendered to the same output
10311         directory.
10312
10313
10314 Version 0.9 (2014-01-09)
10315 ==========================
10316
10317    * ~1800 changes, numerous bugfixes
10318
10319    * Language
10320       * The `float` type has been removed. Use `f32` or `f64` instead.
10321       * A new facility for enabling experimental features (feature gating) has
10322         been added, using the crate-level `#[feature(foo)]` attribute.
10323       * Managed boxes (@) are now behind a feature gate
10324         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
10325         standard library's `Gc` or `Rc` types instead.
10326       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
10327       * Jumping back to the top of a loop is now done with `continue` instead of
10328         `loop`.
10329       * Strings can no longer be mutated through index assignment.
10330       * Raw strings can be created via the basic `r"foo"` syntax or with matched
10331         hash delimiters, as in `r###"foo"###`.
10332       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
10333         called once.
10334       * The `&fn` type is now written `|args| -> ret` to match the literal form.
10335       * `@fn`s have been removed.
10336       * `do` only works with procs in order to make it obvious what the cost
10337         of `do` is.
10338       * Single-element tuple-like structs can no longer be dereferenced to
10339         obtain the inner value. A more comprehensive solution for overloading
10340         the dereference operator will be provided in the future.
10341       * The `#[link(...)]` attribute has been replaced with
10342         `#[crate_id = "name#vers"]`.
10343       * Empty `impl`s must be terminated with empty braces and may not be
10344         terminated with a semicolon.
10345       * Keywords are no longer allowed as lifetime names; the `self` lifetime
10346         no longer has any special meaning.
10347       * The old `fmt!` string formatting macro has been removed.
10348       * `printf!` and `printfln!` (old-style formatting) removed in favor of
10349         `print!` and `println!`.
10350       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
10351       * The `extern mod foo (name = "bar")` syntax has been removed. Use
10352         `extern mod foo = "bar"` instead.
10353       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
10354       * Macros can have attributes.
10355       * Macros can expand to items with attributes.
10356       * Macros can expand to multiple items.
10357       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
10358       * Comments may be nested.
10359       * Values automatically coerce to trait objects they implement, without
10360         an explicit `as`.
10361       * Enum discriminants are no longer an entire word but as small as needed to
10362         contain all the variants. The `repr` attribute can be used to override
10363         the discriminant size, as in `#[repr(int)]` for integer-sized, and
10364         `#[repr(C)]` to match C enums.
10365       * Non-string literals are not allowed in attributes (they never worked).
10366       * The FFI now supports variadic functions.
10367       * Octal numeric literals, as in `0o7777`.
10368       * The `concat!` syntax extension performs compile-time string concatenation.
10369       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
10370         removed as Rust no longer uses segmented stacks.
10371       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
10372       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
10373         not `*`; ignoring remaining fields of a struct is also done with `..`,
10374         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
10375       * `rustc` supports the "win64" calling convention via `extern "win64"`.
10376       * `rustc` supports the "system" calling convention, which defaults to the
10377         preferred convention for the target platform, "stdcall" on 32-bit Windows,
10378         "C" elsewhere.
10379       * The `type_overflow` lint (default: warn) checks literals for overflow.
10380       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
10381       * The `attribute_usage` lint (default: warn) warns about unknown
10382         attributes.
10383       * The `unknown_features` lint (default: warn) warns about unknown
10384         feature gates.
10385       * The `dead_code` lint (default: warn) checks for dead code.
10386       * Rust libraries can be linked statically to one another
10387       * `#[link_args]` is behind the `link_args` feature gate.
10388       * Native libraries are now linked with `#[link(name = "foo")]`
10389       * Native libraries can be statically linked to a rust crate
10390         (`#[link(name = "foo", kind = "static")]`).
10391       * Native OS X frameworks are now officially supported
10392         (`#[link(name = "foo", kind = "framework")]`).
10393       * The `#[thread_local]` attribute creates thread-local (not task-local)
10394         variables. Currently behind the `thread_local` feature gate.
10395       * The `return` keyword may be used in closures.
10396       * Types that can be copied via a memcpy implement the `Pod` kind.
10397       * The `cfg` attribute can now be used on struct fields and enum variants.
10398
10399    * Libraries
10400       * std: The `option` and `result` API's have been overhauled to make them
10401         simpler, more consistent, and more composable.
10402       * std: The entire `std::io` module has been replaced with one that is
10403         more comprehensive and that properly interfaces with the underlying
10404         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
10405         implemented.
10406       * std: `io::util` contains a number of useful implementations of
10407         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
10408         `ZeroReader`, `TeeReader`.
10409       * std: The reference counted pointer type `extra::rc` moved into std.
10410       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
10411         just a wrapper around it).
10412       * std: The `Either` type has been removed.
10413       * std: `fmt::Default` can be implemented for any type to provide default
10414         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
10415       * std: The `rand` API continues to be tweaked.
10416       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
10417         on failure in gdb, is now named `rust_fail`.
10418       * std: The `each_key` and `each_value` methods on `HashMap` have been
10419         replaced by the `keys` and `values` iterators.
10420       * std: Functions dealing with type size and alignment have moved from the
10421         `sys` module to the `mem` module.
10422       * std: The `path` module was written and API changed.
10423       * std: `str::from_utf8` has been changed to cast instead of allocate.
10424       * std: `starts_with` and `ends_with` methods added to vectors via the
10425         `ImmutableEqVector` trait, which is in the prelude.
10426       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
10427         if the index is out of bounds.
10428       * std: Task failure no longer propagates between tasks, as the model was
10429         complex, expensive, and incompatible with thread-based tasks.
10430       * std: The `Any` type can be used for dynamic typing.
10431       * std: `~Any` can be passed to the `fail!` macro and retrieved via
10432         `task::try`.
10433       * std: Methods that produce iterators generally do not have an `_iter`
10434         suffix now.
10435       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
10436         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
10437       * std: `util::ignore` renamed to `prelude::drop`.
10438       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
10439         trait.
10440       * std: `vec::raw` has seen a lot of cleanup and API changes.
10441       * std: The standard library no longer includes any C++ code, and very
10442         minimal C, eliminating the dependency on libstdc++.
10443       * std: Runtime scheduling and I/O functionality has been factored out into
10444         extensible interfaces and is now implemented by two different crates:
10445         libnative, for native threading and I/O; and libgreen, for green threading
10446         and I/O. This paves the way for using the standard library in more limited
10447         embedded environments.
10448       * std: The `comm` module has been rewritten to be much faster, have a
10449         simpler, more consistent API, and to work for both native and green
10450         threading.
10451       * std: All libuv dependencies have been moved into the rustuv crate.
10452       * native: New implementations of runtime scheduling on top of OS threads.
10453       * native: New native implementations of TCP, UDP, file I/O, process spawning,
10454         and other I/O.
10455       * green: The green thread scheduler and message passing types are almost
10456         entirely lock-free.
10457       * extra: The `flatpipes` module had bitrotted and was removed.
10458       * extra: All crypto functions have been removed and Rust now has a policy of
10459         not reimplementing crypto in the standard library. In the future crypto
10460         will be provided by external crates with bindings to established libraries.
10461       * extra: `c_vec` has been modernized.
10462       * extra: The `sort` module has been removed. Use the `sort` method on
10463         mutable slices.
10464
10465    * Tooling
10466       * The `rust` and `rusti` commands have been removed, due to lack of
10467         maintenance.
10468       * `rustdoc` was completely rewritten.
10469       * `rustdoc` can test code examples in documentation.
10470       * `rustpkg` can test packages with the argument, 'test'.
10471       * `rustpkg` supports arbitrary dependencies, including C libraries.
10472       * `rustc`'s support for generating debug info is improved again.
10473       * `rustc` has better error reporting for unbalanced delimiters.
10474       * `rustc`'s JIT support was removed due to bitrot.
10475       * Executables and static libraries can be built with LTO (-Z lto)
10476       * `rustc` adds a `--dep-info` flag for communicating dependencies to
10477         build tools.
10478
10479
10480 Version 0.8 (2013-09-26)
10481 ============================
10482
10483    * ~2200 changes, numerous bugfixes
10484
10485    * Language
10486       * The `for` loop syntax has changed to work with the `Iterator` trait.
10487       * At long last, unwinding works on Windows.
10488       * Default methods are ready for use.
10489       * Many trait inheritance bugs fixed.
10490       * Owned and borrowed trait objects work more reliably.
10491       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
10492       * rustc can omit emission of code for the `debug!` macro if it is passed
10493         `--cfg ndebug`
10494       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
10495         for foo.rs, then foo/mod.rs, and will generate an error when both are
10496         present.
10497       * Strings no longer contain trailing nulls. The new `std::c_str` module
10498         provides new mechanisms for converting to C strings.
10499       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
10500       * The FFI has been overhauled such that foreign functions are called directly,
10501         instead of through a stack-switching wrapper.
10502       * Calling a foreign function must be done through a Rust function with the
10503         `#[fixed_stack_segment]` attribute.
10504       * The `externfn!` macro can be used to declare both a foreign function and
10505         a `#[fixed_stack_segment]` wrapper at once.
10506       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
10507       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
10508       * `priv` is disallowed everywhere except for struct fields and enum variants.
10509       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
10510       * `ref` bindings in irrefutable patterns work correctly now.
10511       * `char` is now prevented from containing invalid code points.
10512       * Casting to `bool` is no longer allowed.
10513       * `\0` is now accepted as an escape in chars and strings.
10514       * `yield` is a reserved keyword.
10515       * `typeof` is a reserved keyword.
10516       * Crates may be imported by URL with `extern mod foo = "url";`.
10517       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
10518       * Static vectors can be initialized with repeating elements,
10519         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
10520       * Static structs can be initialized with functional record update,
10521         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
10522       * `cfg!` can be used to conditionally execute code based on the crate
10523         configuration, similarly to `#[cfg(...)]`.
10524       * The `unnecessary_qualification` lint detects unneeded module
10525         prefixes (default: allow).
10526       * Arithmetic operations have been implemented on the SIMD types in
10527         `std::unstable::simd`.
10528       * Exchange allocation headers were removed, reducing memory usage.
10529       * `format!` implements a completely new, extensible, and higher-performance
10530         string formatting system. It will replace `fmt!`.
10531       * `print!` and `println!` write formatted strings (using the `format!`
10532         extension) to stdout.
10533       * `write!` and `writeln!` write formatted strings (using the `format!`
10534         extension) to the new Writers in `std::rt::io`.
10535       * The library section in which a function or static is placed may
10536         be specified with `#[link_section = "..."]`.
10537       * The `proto!` syntax extension for defining bounded message protocols
10538         was removed.
10539       * `macro_rules!` is hygienic for `let` declarations.
10540       * The `#[export_name]` attribute specifies the name of a symbol.
10541       * `unreachable!` can be used to indicate unreachable code, and fails
10542         if executed.
10543
10544    * Libraries
10545       * std: Transitioned to the new runtime, written in Rust.
10546       * std: Added an experimental I/O library, `rt::io`, based on the new
10547         runtime.
10548       * std: A new generic `range` function was added to the prelude, replacing
10549         `uint::range` and friends.
10550       * std: `range_rev` no longer exists. Since range is an iterator it can be
10551         reversed with `range(lo, hi).invert()`.
10552       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
10553         renamed to `unwrap_or`.
10554       * std: The `iterator` module was renamed to `iter`.
10555       * std: Integral types now support the `checked_add`, `checked_sub`, and
10556         `checked_mul` operations for detecting overflow.
10557       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10558         consistency.
10559       * std: Methods are standardizing on conventions for casting methods:
10560         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10561         and cheap casts.
10562       * std: The `CString` type in `c_str` provides new ways to convert to and
10563         from C strings.
10564       * std: `DoubleEndedIterator` can yield elements in two directions.
10565       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10566         two splices.
10567       * std: `str::from_bytes` renamed to `str::from_utf8`.
10568       * std: `pop_opt` and `shift_opt` methods added to vectors.
10569       * std: The task-local data interface no longer uses @, and keys are
10570         no longer function pointers.
10571       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10572       * std: Added `SharedPort` to `comm`.
10573       * std: `Eq` has a default method for `ne`; only `eq` is required
10574         in implementations.
10575       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10576         is required in implementations.
10577       * std: `is_utf8` performance is improved, impacting many string functions.
10578       * std: `os::MemoryMap` provides cross-platform mmap.
10579       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10580         are not 'in-bounds' are considered undefined.
10581       * std: Many freestanding functions in `vec` removed in favor of methods.
10582       * std: Many freestanding functions on scalar types removed in favor of
10583         methods.
10584       * std: Many options to task builders were removed since they don't make
10585         sense in the new scheduler design.
10586       * std: More containers implement `FromIterator` so can be created by the
10587         `collect` method.
10588       * std: More complete atomic types in `unstable::atomics`.
10589       * std: `comm::PortSet` removed.
10590       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10591         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10592         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10593         default implementations.
10594       * std: Various `from_str` functions were removed in favor of a generic
10595         `from_str` which is available in the prelude.
10596       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10597       * extra: `dlist`, the doubly-linked list was modernized.
10598       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10599       * extra: Added `glob` module, replacing `std::os::glob`.
10600       * extra: `rope` was removed.
10601       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10602       * extra: `net`, and `timer` were removed. The experimental replacements
10603         are `std::rt::io::net` and `std::rt::io::timer`.
10604       * extra: Iterators implemented for `SmallIntMap`.
10605       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10606       * extra: `SmallIntSet` removed. Use `BitvSet`.
10607       * extra: Performance of JSON parsing greatly improved.
10608       * extra: `semver` updated to SemVer 2.0.0.
10609       * extra: `term` handles more terminals correctly.
10610       * extra: `dbg` module removed.
10611       * extra: `par` module removed.
10612       * extra: `future` was cleaned up, with some method renames.
10613       * extra: Most free functions in `getopts` were converted to methods.
10614
10615    * Other
10616       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10617       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10618         similarly to gcc's `--march` flag.
10619       * rustc's performance compiling small crates is much better.
10620       * rustpkg has received many improvements.
10621       * rustpkg supports git tags as package IDs.
10622       * rustpkg builds into target-specific directories so it can be used for
10623         cross-compiling.
10624       * The number of concurrent test tasks is controlled by the environment
10625         variable RUST_TEST_TASKS.
10626       * The test harness can now report metrics for benchmarks.
10627       * All tools have man pages.
10628       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10629       * The runtime uses jemalloc for allocations.
10630       * Segmented stacks are temporarily disabled as part of the transition to
10631         the new runtime. Stack overflows are possible!
10632       * A new documentation backend, rustdoc_ng, is available for use. It is
10633         still invoked through the normal `rustdoc` command.
10634
10635
10636 Version 0.7 (2013-07-03)
10637 =======================
10638
10639    * ~2000 changes, numerous bugfixes
10640
10641    * Language
10642       * `impl`s no longer accept a visibility qualifier. Put them on methods
10643         instead.
10644       * The borrow checker has been rewritten with flow-sensitivity, fixing
10645         many bugs and inconveniences.
10646       * The `self` parameter no longer implicitly means `&'self self`,
10647         and can be explicitly marked with a lifetime.
10648       * Overloadable compound operators (`+=`, etc.) have been temporarily
10649         removed due to bugs.
10650       * The `for` loop protocol now requires `for`-iterators to return `bool`
10651         so they compose better.
10652       * The `Durable` trait is replaced with the `'static` bounds.
10653       * Trait default methods work more often.
10654       * Structs with the `#[packed]` attribute have byte alignment and
10655         no padding between fields.
10656       * Type parameters bound by `Copy` must now be copied explicitly with
10657         the `copy` keyword.
10658       * It is now illegal to move out of a dereferenced unsafe pointer.
10659       * `Option<~T>` is now represented as a nullable pointer.
10660       * `@mut` does dynamic borrow checks correctly.
10661       * The `main` function is only detected at the topmost level of the crate.
10662         The `#[main]` attribute is still valid anywhere.
10663       * Struct fields may no longer be mutable. Use inherited mutability.
10664       * The `#[no_send]` attribute makes a type that would otherwise be
10665         `Send`, not.
10666       * The `#[no_freeze]` attribute makes a type that would otherwise be
10667         `Freeze`, not.
10668       * Unbounded recursion will abort the process after reaching the limit
10669         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10670       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10671         are never implicitly copyable.
10672       * `#[static_assert]` makes compile-time assertions about static bools.
10673       * At long last, 'argument modes' no longer exist.
10674       * The rarely used `use mod` statement no longer exists.
10675
10676    * Syntax extensions
10677       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10678         argument list.
10679       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10680         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10681         `#[deriving(...)]`.
10682       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10683         and unsuffixed integer literals.
10684
10685    * Libraries
10686       * The `core` crate was renamed to `std`.
10687       * The `std` crate was renamed to `extra`.
10688       * More and improved documentation.
10689       * std: `iterator` module for external iterator objects.
10690       * Many old-style (internal, higher-order function) iterators replaced by
10691         implementations of `Iterator`.
10692       * std: Many old internal vector and string iterators,
10693         incl. `any`, `all`. removed.
10694       * std: The `finalize` method of `Drop` renamed to `drop`.
10695       * std: The `drop` method now takes `&mut self` instead of `&self`.
10696       * std: The prelude no longer re-exports any modules, only types and traits.
10697       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10698         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10699       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10700         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10701       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10702         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10703       * std: Many types implement `Clone`.
10704       * std: `path` type renamed to `Path`.
10705       * std: `mut` module and `Mut` type removed.
10706       * std: Many standalone functions removed in favor of methods and iterators
10707         in `vec`, `str`. In the future methods will also work as functions.
10708       * std: `reinterpret_cast` removed. Use `transmute`.
10709       * std: ascii string handling in `std::ascii`.
10710       * std: `Rand` is implemented for ~/@.
10711       * std: `run` module for spawning processes overhauled.
10712       * std: Various atomic types added to `unstable::atomic`.
10713       * std: Various types implement `Zero`.
10714       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10715       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10716       * std: Added `os::mkdir_recursive`.
10717       * std: Added `os::glob` function performs filesystems globs.
10718       * std: `FuzzyEq` renamed to `ApproxEq`.
10719       * std: `Map` now defines `pop` and `swap` methods.
10720       * std: `Cell` constructors converted to static methods.
10721       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10722       * extra: `flate` module moved from `std` to `extra`.
10723       * extra: `fileinput` module for iterating over a series of files.
10724       * extra: `Complex` number type and `complex` module.
10725       * extra: `Rational` number type and `rational` module.
10726       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10727       * extra: `term` uses terminfo now, is more correct.
10728       * extra: `arc` functions converted to methods.
10729       * extra: Implementation of fixed output size variations of SHA-2.
10730
10731    * Tooling
10732       * `unused_variables` lint mode for unused variables (default: warn).
10733       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10734         (default: warn).
10735       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10736         (default: warn).
10737       * `dead_assignment` lint mode for unread variables (default: warn).
10738       * `unnecessary_allocation` lint mode detects some heap allocations that are
10739         immediately borrowed so could be written without allocating (default: warn).
10740       * `missing_doc` lint mode (default: allow).
10741       * `unreachable_code` lint mode (default: warn).
10742       * The `rusti` command has been rewritten and a number of bugs addressed.
10743       * rustc outputs in color on more terminals.
10744       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10745       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10746       * Compiling with `-g` will make the binary record information about
10747         dynamic borrowcheck failures for debugging.
10748       * rustdoc has a nicer stylesheet.
10749       * Various improvements to rustdoc.
10750       * Improvements to rustpkg (see the detailed release notes).
10751
10752
10753 Version 0.6 (2013-04-03)
10754 ========================
10755
10756    * ~2100 changes, numerous bugfixes
10757
10758    * Syntax changes
10759       * The self type parameter in traits is now spelled `Self`
10760       * The `self` parameter in trait and impl methods must now be explicitly
10761         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10762       * Static methods no longer require the `static` keyword and instead
10763         are distinguished by the lack of a `self` parameter
10764       * Replaced the `Durable` trait with the `'static` lifetime
10765       * The old closure type syntax with the trailing sigil has been
10766         removed in favor of the more consistent leading sigil
10767       * `super` is a keyword, and may be prefixed to paths
10768       * Trait bounds are separated with `+` instead of whitespace
10769       * Traits are implemented with `impl Trait for Type`
10770         instead of `impl Type: Trait`
10771       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10772       * The `export` keyword has finally been removed
10773       * The `move` keyword has been removed (see "Semantic changes")
10774       * The interior mutability qualifier on vectors, `[mut T]`, has been
10775         removed. Use `&mut [T]`, etc.
10776       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10777       * `fail` is no longer a keyword. Use `fail!()`
10778       * `assert` is no longer a keyword. Use `assert!()`
10779       * `log` is no longer a keyword. use `debug!`, etc.
10780       * 1-tuples may be represented as `(T,)`
10781       * Struct fields may no longer be `mut`. Use inherited mutability,
10782         `@mut T`, `core::mut` or `core::cell`
10783       * `extern mod { ... }` is no longer valid syntax for foreign
10784         function modules. Use extern blocks: `extern { ... }`
10785       * Newtype enums removed. Use tuple-structs.
10786       * Trait implementations no longer support visibility modifiers
10787       * Pattern matching over vectors improved and expanded
10788       * `const` renamed to `static` to correspond to lifetime name,
10789         and make room for future `static mut` unsafe mutable globals.
10790       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10791       * `Clone` implementations can be automatically generated with
10792         `#[deriving(Clone)]`
10793       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10794         instead of `foo as Bar`.
10795       * Fixed length vector types are now written as `[int, .. 3]`
10796         instead of `[int * 3]`.
10797       * Fixed length vector types can express the length as a constant
10798         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10799
10800    * Semantic changes
10801       * Types with owned pointers or custom destructors move by default,
10802         eliminating the `move` keyword
10803       * All foreign functions are considered unsafe
10804       * &mut is now unaliasable
10805       * Writes to borrowed @mut pointers are prevented dynamically
10806       * () has size 0
10807       * The name of the main function can be customized using #[main]
10808       * The default type of an inferred closure is &fn instead of @fn
10809       * `use` statements may no longer be "chained" - they cannot import
10810         identifiers imported by previous `use` statements
10811       * `use` statements are crate relative, importing from the "top"
10812         of the crate by default. Paths may be prefixed with `super::`
10813         or `self::` to change the search behavior.
10814       * Method visibility is inherited from the implementation declaration
10815       * Structural records have been removed
10816       * Many more types can be used in static items, including enums
10817         'static-lifetime pointers and vectors
10818       * Pattern matching over vectors improved and expanded
10819       * Typechecking of closure types has been overhauled to
10820         improve inference and eliminate unsoundness
10821       * Macros leave scope at the end of modules, unless that module is
10822         tagged with #[macro_escape]
10823
10824    * Libraries
10825       * Added big integers to `std::bigint`
10826       * Removed `core::oldcomm` module
10827       * Added pipe-based `core::comm` module
10828       * Numeric traits have been reorganized under `core::num`
10829       * `vec::slice` finally returns a slice
10830       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10831       * Containers reorganized around traits in `core::container`
10832       * `core::dvec` removed, `~[T]` is a drop-in replacement
10833       * `core::send_map` renamed to `core::hashmap`
10834       * `std::map` removed; replaced with `core::hashmap`
10835       * `std::treemap` reimplemented as an owned balanced tree
10836       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10837       * `core::trie` added as a fast ordered map for integer keys
10838       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10839       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10840         overload the comparison operators, whereas `TotalOrd` is used
10841         by certain container types
10842
10843    * Other
10844       * Replaced the 'cargo' package manager with 'rustpkg'
10845       * Added all-purpose 'rust' tool
10846       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10847       * rustc now *attempts* to offer spelling suggestions
10848       * Improved support for ARM and Android
10849       * Preliminary MIPS backend
10850       * Improved foreign function ABI implementation for x86, x86_64
10851       * Various memory usage improvements
10852       * Rust code may be embedded in foreign code under limited circumstances
10853       * Inline assembler supported by new asm!() syntax extension.
10854
10855
10856 Version 0.5 (2012-12-21)
10857 ===========================
10858
10859    * ~900 changes, numerous bugfixes
10860
10861    * Syntax changes
10862       * Removed `<-` move operator
10863       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10864       * Removed old fixed length vector syntax - `[T]/N`
10865       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10866       * Macros may now expand to items and statements
10867       * `a.b()` is always parsed as a method call, never as a field projection
10868       * `Eq` and `IterBytes` implementations can be automatically generated
10869         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10870       * Removed the special crate language for `.rc` files
10871       * Function arguments may consist of any irrefutable pattern
10872
10873    * Semantic changes
10874       * `&` and `~` pointers may point to objects
10875       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10876       * Enum variants may be structs
10877       * Destructors can be added to all nominal types with the Drop trait
10878       * Structs and nullary enum variants may be constants
10879       * Values that cannot be implicitly copied are now automatically moved
10880         without writing `move` explicitly
10881       * `&T` may now be coerced to `*T`
10882       * Coercions happen in `let` statements as well as function calls
10883       * `use` statements now take crate-relative paths
10884       * The module and type namespaces have been merged so that static
10885         method names can be resolved under the trait in which they are
10886         declared
10887
10888    * Improved support for language features
10889       * Trait inheritance works in many scenarios
10890       * More support for explicit self arguments in methods - `self`, `&self`
10891         `@self`, and `~self` all generally work as expected
10892       * Static methods work in more situations
10893       * Experimental: Traits may declare default methods for the implementations
10894         to use
10895
10896    * Libraries
10897       * New condition handling system in `core::condition`
10898       * Timsort added to `std::sort`
10899       * New priority queue, `std::priority_queue`
10900       * Pipes for serializable types, `std::flatpipes'
10901       * Serialization overhauled to be trait-based
10902       * Expanded `getopts` definitions
10903       * Moved futures to `std`
10904       * More functions are pure now
10905       * `core::comm` renamed to `oldcomm`. Still deprecated
10906       * `rustdoc` and `cargo` are libraries now
10907
10908    * Misc
10909       * Added a preliminary REPL, `rusti`
10910       * License changed from MIT to dual MIT/APL2
10911
10912
10913 Version 0.4 (2012-10-15)
10914 ==========================
10915
10916    * ~2000 changes, numerous bugfixes
10917
10918    * Syntax
10919       * All keywords are now strict and may not be used as identifiers anywhere
10920       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10921         'of', 'with', 'to', 'class'.
10922       * Classes are replaced with simpler structs
10923       * Explicit method self types
10924       * `ret` became `return` and `alt` became `match`
10925       * `import` is now `use`; `use is now `extern mod`
10926       * `extern mod { ... }` is now `extern { ... }`
10927       * `use mod` is the recommended way to import modules
10928       * `pub` and `priv` replace deprecated export lists
10929       * The syntax of `match` pattern arms now uses fat arrow (=>)
10930       * `main` no longer accepts an args vector; use `os::args` instead
10931
10932    * Semantics
10933       * Trait implementations are now coherent, ala Haskell typeclasses
10934       * Trait methods may be static
10935       * Argument modes are deprecated
10936       * Borrowed pointers are much more mature and recommended for use
10937       * Strings and vectors in the static region are stored in constant memory
10938       * Typestate was removed
10939       * Resolution rewritten to be more reliable
10940       * Support for 'dual-mode' data structures (freezing and thawing)
10941
10942    * Libraries
10943       * Most binary operators can now be overloaded via the traits in
10944         `core::ops'
10945       * `std::net::url` for representing URLs
10946       * Sendable hash maps in `core::send_map`
10947       * `core::task' gained a (currently unsafe) task-local storage API
10948
10949    * Concurrency
10950       * An efficient new intertask communication primitive called the pipe,
10951         along with a number of higher-level channel types, in `core::pipes`
10952       * `std::arc`, an atomically reference counted, immutable, shared memory
10953         type
10954       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10955       * Futures are now based on pipes and sendable
10956       * More robust linked task failure
10957       * Improved task builder API
10958
10959    * Other
10960       * Improved error reporting
10961       * Preliminary JIT support
10962       * Preliminary work on precise GC
10963       * Extensive architectural improvements to rustc
10964       * Begun a transition away from buggy C++-based reflection (shape) code to
10965         Rust-based (visitor) code
10966       * All hash functions and tables converted to secure, randomized SipHash
10967
10968
10969 Version 0.3  (2012-07-12)
10970 ========================
10971
10972    * ~1900 changes, numerous bugfixes
10973
10974    * New coding conveniences
10975       * Integer-literal suffix inference
10976       * Per-item control over warnings, errors
10977       * #[cfg(windows)] and #[cfg(unix)] attributes
10978       * Documentation comments
10979       * More compact closure syntax
10980       * 'do' expressions for treating higher-order functions as
10981         control structures
10982       * *-patterns (wildcard extended to all constructor fields)
10983
10984    * Semantic cleanup
10985       * Name resolution pass and exhaustiveness checker rewritten
10986       * Region pointers and borrow checking supersede alias
10987         analysis
10988       * Init-ness checking is now provided by a region-based liveness
10989         pass instead of the typestate pass; same for last-use analysis
10990       * Extensive work on region pointers
10991
10992    * Experimental new language features
10993       * Slices and fixed-size, interior-allocated vectors
10994       * #!-comments for lang versioning, shell execution
10995       * Destructors and iface implementation for classes;
10996         type-parameterized classes and class methods
10997       * 'const' type kind for types that can be used to implement
10998         shared-memory concurrency patterns
10999
11000    * Type reflection
11001
11002    * Removal of various obsolete features
11003       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
11004                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
11005
11006       * Constructs: do-while loops ('do' repurposed), fn binding,
11007                     resources (replaced by destructors)
11008
11009    * Compiler reorganization
11010       * Syntax-layer of compiler split into separate crate
11011       * Clang (from LLVM project) integrated into build
11012       * Typechecker split into sub-modules
11013
11014    * New library code
11015       * New time functions
11016       * Extension methods for many built-in types
11017       * Arc: atomic-refcount read-only / exclusive-use shared cells
11018       * Par: parallel map and search routines
11019       * Extensive work on libuv interface
11020       * Much vector code moved to libraries
11021       * Syntax extensions: #line, #col, #file, #mod, #stringify,
11022         #include, #include_str, #include_bin
11023
11024    * Tool improvements
11025       * Cargo automatically resolves dependencies
11026
11027
11028 Version 0.2  (2012-03-29)
11029 =========================
11030
11031    * >1500 changes, numerous bugfixes
11032
11033    * New docs and doc tooling
11034
11035    * New port: FreeBSD x86_64
11036
11037    * Compilation model enhancements
11038       * Generics now specialized, multiply instantiated
11039       * Functions now inlined across separate crates
11040
11041    * Scheduling, stack and threading fixes
11042       * Noticeably improved message-passing performance
11043       * Explicit schedulers
11044       * Callbacks from C
11045       * Helgrind clean
11046
11047    * Experimental new language features
11048       * Operator overloading
11049       * Region pointers
11050       * Classes
11051
11052    * Various language extensions
11053       * C-callback function types: 'crust fn ...'
11054       * Infinite-loop construct: 'loop { ... }'
11055       * Shorten 'mutable' to 'mut'
11056       * Required mutable-local qualifier: 'let mut ...'
11057       * Basic glob-exporting: 'export foo::*;'
11058       * Alt now exhaustive, 'alt check' for runtime-checked
11059       * Block-function form of 'for' loop, with 'break' and 'ret'.
11060
11061    * New library code
11062       * AST quasi-quote syntax extension
11063       * Revived libuv interface
11064       * New modules: core::{future, iter}, std::arena
11065       * Merged per-platform std::{os*, fs*} to core::{libc, os}
11066       * Extensive cleanup, regularization in libstd, libcore
11067
11068
11069 Version 0.1  (2012-01-20)
11070 ===============================
11071
11072    * Most language features work, including:
11073       * Unique pointers, unique closures, move semantics
11074       * Interface-constrained generics
11075       * Static interface dispatch
11076       * Stack growth
11077       * Multithread task scheduling
11078       * Typestate predicates
11079       * Failure unwinding, destructors
11080       * Pattern matching and destructuring assignment
11081       * Lightweight block-lambda syntax
11082       * Preliminary macro-by-example
11083
11084    * Compiler works with the following configurations:
11085       * Linux: x86 and x86_64 hosts and targets
11086       * macOS: x86 and x86_64 hosts and targets
11087       * Windows: x86 hosts and targets
11088
11089    * Cross compilation / multi-target configuration supported.
11090
11091    * Preliminary API-documentation and package-management tools included.
11092
11093 Known issues:
11094
11095    * Documentation is incomplete.
11096
11097    * Performance is below intended target.
11098
11099    * Standard library APIs are subject to extensive change, reorganization.
11100
11101    * Language-level versioning is not yet operational - future code will
11102      break unexpectedly.