]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #88495 - ibraheemdev:tcp-linger, r=joshtriplett
[rust.git] / RELEASES.md
1 Version 1.55.0 (2021-09-09)
2 ============================
3
4 Language
5 --------
6 - [You can now write open "from" range patterns (`X..`), which will start at `X` and
7   will end at the maximum value of the integer.][83918]
8 - [You can now explicitly import the prelude of different editions
9   through `std::prelude` (e.g. `use std::prelude::rust_2021::*;`).][86294]
10
11 Compiler
12 --------
13 - [Added tier 3\* support for `powerpc-unknown-freebsd`.][87370]
14 - [Added tier 3 support for `powerpc64le-unknown-freebsd`.][83572]
15
16 \* Refer to Rust's [platform support page][platform-support-doc] for more
17    information on Rust's tiered platform support.
18
19 Libraries
20 ---------
21
22 - [Updated std's float parsing to use the Eisel-Lemire algorithm.][86761]
23   These improvements should in general provide faster string parsing of floats,
24   no longer reject certain valid floating point values, and reduce
25   the produced code size for non-stripped artifacts.
26 - [`string::Drain` now implements `AsRef<str>` and `AsRef<[u8]>`.][86858]
27 - [`collections::{BinaryHeap, BTreeSet, HashSet, LinkedList, VecDeque}` now
28   implement `From<[T; N]>`.][84111]
29 - [`collections::{BTreeMap, HashMap}` now implement `From<[(K, V); N]>`.][84111]
30   This allows you to write the following;
31   ```rust
32   let highscores = std::collections::HashMap::from([
33       ("Alice", 9000u32),
34       ("Bob", 7250),
35       ("Charlie", 5500),
36   ]);
37   ```
38
39 Stabilised APIs
40 ---------------
41
42 - [`Bound::cloned`]
43 - [`Drain::as_str`]
44 - [`IntoInnerError::into_error`]
45 - [`IntoInnerError::into_parts`]
46 - [`MaybeUninit::assume_init_mut`]
47 - [`MaybeUninit::assume_init_ref`]
48 - [`MaybeUninit::write`]
49 - [`array::map`]
50 - [`ops::ControlFlow`]
51 - [`x86::_bittest`]
52 - [`x86::_bittestandcomplement`]
53 - [`x86::_bittestandreset`]
54 - [`x86::_bittestandset`]
55 - [`x86_64::_bittest64`]
56 - [`x86_64::_bittestandcomplement64`]
57 - [`x86_64::_bittestandreset64`]
58 - [`x86_64::_bittestandset64`]
59
60 The following previously stable functions are now `const`.
61
62 - [`str::from_utf8_unchecked`]
63 - [`mem::transmute`]
64
65
66 Cargo
67 -----
68 - [Cargo will now deduplicate compiler diagnostics to the terminal when invoking
69   rustc in parallel such as when using `cargo test`.][cargo/9675]
70 - [The package definition in `cargo metadata` now includes the `"default_run"`
71   field from the manifest.][cargo/9550]
72 - [Added `cargo d` as an alias for `cargo doc`.][cargo/9680]
73 - [Added `{lib}` as formatting option for `cargo tree` to print the `"lib_name"`
74   of packages.][cargo/9663]
75
76 Rustdoc
77 -------
78 - [Added "Go to item on exact match" search option.][85876]
79 - [The "Implementors" section on traits no longer shows redundant
80   method definitions.][85970]
81 - [Trait implementations are toggled open by default.][86260] This should make the
82   implementations more searchable by tools like `CTRL+F` in your browser.
83 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
84   through type aliases.][86334]
85 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
86   "Trait Implementations" section.][86513]
87
88
89 Compatibility Notes
90 -------------------
91 - [std functions that return an `io::Error` will no longer use the
92   `ErrorKind::Other` variant.][85746] This is to better reflect that these
93   kinds of errors could be categorised [into newer more specific `ErrorKind`
94   variants][79965], and that they do not represent a user error.
95 - [Using environment variable names with `process::Command` on Windows now
96   behaves as expected.][85270] Previously using envionment variables with
97   `Command` would cause them to be ASCII-uppercased.
98 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
99   with `rustdoc::`][86849]
100
101 [86849]: https://github.com/rust-lang/rust/pull/86849
102 [86513]: https://github.com/rust-lang/rust/pull/86513
103 [86334]: https://github.com/rust-lang/rust/pull/86334
104 [86260]: https://github.com/rust-lang/rust/pull/86260
105 [85970]: https://github.com/rust-lang/rust/pull/85970
106 [85876]: https://github.com/rust-lang/rust/pull/85876
107 [83572]: https://github.com/rust-lang/rust/pull/83572
108 [86294]: https://github.com/rust-lang/rust/pull/86294
109 [86858]: https://github.com/rust-lang/rust/pull/86858
110 [86761]: https://github.com/rust-lang/rust/pull/86761
111 [85769]: https://github.com/rust-lang/rust/pull/85769
112 [85746]: https://github.com/rust-lang/rust/pull/85746
113 [85305]: https://github.com/rust-lang/rust/pull/85305
114 [85270]: https://github.com/rust-lang/rust/pull/85270
115 [84111]: https://github.com/rust-lang/rust/pull/84111
116 [83918]: https://github.com/rust-lang/rust/pull/83918
117 [79965]: https://github.com/rust-lang/rust/pull/79965
118 [87370]: https://github.com/rust-lang/rust/pull/87370
119 [87298]: https://github.com/rust-lang/rust/pull/87298
120 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
121 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
122 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
123 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
124 [cargo/9663]: https://github.com/rust-lang/cargo/pull/9663
125 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
126 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
127 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
128 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
129 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
130 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
131 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
132 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
133 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
134 [`mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
135 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
136 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
137 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
138 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
139 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
140 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
141 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
142 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
143 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
144 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
145
146
147 Version 1.54.0 (2021-07-29)
148 ============================
149
150 Language
151 -----------------------
152
153 - [You can now use macros for values in some built-in attributes.][83366]
154   This primarily allows you to call macros within the `#[doc]` attribute. For
155   example, to include external documentation in your crate, you can now write
156   the following:
157   ```rust
158   #![doc = include_str!("README.md")]
159   ```
160
161 - [You can now cast between unsized slice types (and types which contain
162   unsized slices) in `const fn`.][85078]
163 - [You can now use multiple generic lifetimes with `impl Trait` where the
164    lifetimes don't explicitly outlive another.][84701] In code this means
165    that you can now have `impl Trait<'a, 'b>` where as before you could
166    only have `impl Trait<'a, 'b> where 'b: 'a`.
167
168 Compiler
169 -----------------------
170
171 - [Rustc will now search for custom JSON targets in
172   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
173   directory.][83800] You can find your sysroot directory by running
174   `rustc --print sysroot`.
175 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
176 - [You can now use `#[target_feature]` on safe functions when targeting
177   WebAssembly platforms.][84988]
178 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
179 - [Added tier 3\* support for `bpfel-unknown-none`
180    and `bpfeb-unknown-none`.][79608]
181 - [`-Zmutable-noalias=yes`][82834] is enabled by default when using LLVM 12 or above.
182
183 \* Refer to Rust's [platform support page][platform-support-doc] for more
184    information on Rust's tiered platform support.
185
186 Libraries
187 -----------------------
188
189 - [`panic::panic_any` will now `#[track_caller]`.][85745]
190 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
191 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
192 - [The implementations of vendor intrinsics in core::arch have been
193    significantly refactored.][83278] The main user-visible changes are
194    a 50% reduction in the size of libcore.rlib and stricter validation
195    of constant operands passed to intrinsics. The latter is technically
196    a breaking change, but allows Rust to more closely match the C vendor
197    intrinsics API.
198
199 Stabilized APIs
200 ---------------
201
202 - [`BTreeMap::into_keys`]
203 - [`BTreeMap::into_values`]
204 - [`HashMap::into_keys`]
205 - [`HashMap::into_values`]
206 - [`arch::wasm32`]
207 - [`VecDeque::binary_search`]
208 - [`VecDeque::binary_search_by`]
209 - [`VecDeque::binary_search_by_key`]
210 - [`VecDeque::partition_point`]
211
212 Cargo
213 -----
214
215 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
216   the dependency graph.][cargo/9520]
217 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
218   in the tree ][cargo/9499]
219 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
220   macro dependencies.][cargo/9488]
221 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
222   This variable points to a directory that integration tests and benches
223   can use as a "scratchpad" for testing filesystem operations.
224
225 Compatibility Notes
226 -------------------
227 - [Mixing Option and Result via `?` is no longer permitted in closures for inferred types.][86831]
228 - [Previously unsound code is no longer permitted where different constructors in branches
229   could require different lifetimes.][85574]
230 - As previously mentioned the [`std::arch` instrinsics now uses stricter const checking][83278]
231   than before and may reject some previously accepted code.
232 - [`i128` multiplication on Cortex M0+ platforms currently unconditionally causes overflow
233    when compiled with `codegen-units = 1`.][86063]
234
235 [85574]: https://github.com/rust-lang/rust/issues/85574
236 [86831]: https://github.com/rust-lang/rust/issues/86831
237 [86063]: https://github.com/rust-lang/rust/issues/86063
238 [86831]: https://github.com/rust-lang/rust/issues/86831
239 [79608]: https://github.com/rust-lang/rust/pull/79608
240 [84988]: https://github.com/rust-lang/rust/pull/84988
241 [84701]: https://github.com/rust-lang/rust/pull/84701
242 [84072]: https://github.com/rust-lang/rust/pull/84072
243 [85745]: https://github.com/rust-lang/rust/pull/85745
244 [84744]: https://github.com/rust-lang/rust/pull/84744
245 [85078]: https://github.com/rust-lang/rust/pull/85078
246 [84717]: https://github.com/rust-lang/rust/pull/84717
247 [83800]: https://github.com/rust-lang/rust/pull/83800
248 [83366]: https://github.com/rust-lang/rust/pull/83366
249 [83278]: https://github.com/rust-lang/rust/pull/83278
250 [85292]: https://github.com/rust-lang/rust/pull/85292
251 [82834]: https://github.com/rust-lang/rust/pull/82834
252 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
253 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
254 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
255 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
256 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
257 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
258 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
259 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
260 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
261 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
262 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
263
264 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
265
266 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
267
268 Version 1.53.0 (2021-06-17)
269 ============================
270
271 Language
272 -----------------------
273 - [You can now use unicode for identifiers.][83799] This allows multilingual
274   identifiers but still doesn't allow glyphs that are not considered characters
275   such as `◆` or `🦀`. More specifically you can now use any identifier that
276   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
277   is the same standard as languages like Python, however Rust uses NFC
278   normalization which may be different from other languages.
279 - [You can now specify "or patterns" inside pattern matches.][79278]
280   Previously you could only use `|` (OR) on complete patterns. E.g.
281   ```rust
282   let x = Some(2u8);
283   // Before
284   matches!(x, Some(1) | Some(2));
285   // Now
286   matches!(x, Some(1 | 2));
287   ```
288 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
289   has the same semantics as the `:pat` matcher. This is to allow `:pat`
290   to change semantics to being a pattern fragment in a future edition.
291
292 Compiler
293 -----------------------
294 - [Updated the minimum external LLVM version to LLVM 10.][83387]
295 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
296 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
297
298 \* Refer to Rust's [platform support page][platform-support-doc] for more
299 information on Rust's tiered platform support.
300
301 Libraries
302 -----------------------
303 - [Abort messages will now forward to `android_set_abort_message` on
304   Android platforms when available.][81469]
305 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
306 - [Arrays of any length now implement `IntoIterator`.][84147]
307   Currently calling `.into_iter()` as a method on an array will
308   return `impl Iterator<Item=&T>`, but this may change in a
309   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
310   directly on arrays will provide `impl Iterator<Item=T>` as expected.
311 - [`leading_zeros`, and `trailing_zeros` are now available on all
312   `NonZero` integer types.][84082]
313 - [`{f32, f64}::from_str` now parse and print special values
314   (`NaN`, `-0`) according to IEEE 754.][78618]
315 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
316 - [Add the `BITS` associated constant to all numeric types.][82565]
317
318 Stabilised APIs
319 ---------------
320 - [`AtomicBool::fetch_update`]
321 - [`AtomicPtr::fetch_update`]
322 - [`BTreeMap::retain`]
323 - [`BTreeSet::retain`]
324 - [`BufReader::seek_relative`]
325 - [`DebugStruct::non_exhaustive`]
326 - [`Duration::MAX`]
327 - [`Duration::ZERO`]
328 - [`Duration::is_zero`]
329 - [`Duration::saturating_add`]
330 - [`Duration::saturating_mul`]
331 - [`Duration::saturating_sub`]
332 - [`ErrorKind::Unsupported`]
333 - [`Option::insert`]
334 - [`Ordering::is_eq`]
335 - [`Ordering::is_ge`]
336 - [`Ordering::is_gt`]
337 - [`Ordering::is_le`]
338 - [`Ordering::is_lt`]
339 - [`Ordering::is_ne`]
340 - [`OsStr::is_ascii`]
341 - [`OsStr::make_ascii_lowercase`]
342 - [`OsStr::make_ascii_uppercase`]
343 - [`OsStr::to_ascii_lowercase`]
344 - [`OsStr::to_ascii_uppercase`]
345 - [`Peekable::peek_mut`]
346 - [`Rc::decrement_strong_count`]
347 - [`Rc::increment_strong_count`]
348 - [`Vec::extend_from_within`]
349 - [`array::from_mut`]
350 - [`array::from_ref`]
351 - [`cmp::max_by_key`]
352 - [`cmp::max_by`]
353 - [`cmp::min_by_key`]
354 - [`cmp::min_by`]
355 - [`f32::is_subnormal`]
356 - [`f64::is_subnormal`]
357
358 Cargo
359 -----------------------
360 - [Cargo now supports git repositories where the default `HEAD` branch is not
361   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
362   which can handle default branches correctly.
363 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
364 - [The `authors` field is no longer included in `Cargo.toml` for new
365   projects.][cargo/9282]
366
367 Rustdoc
368 -----------------------
369 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
370   without hyperlinks.][81764]
371
372 Compatibility Notes
373 -------------------
374 - [Implement token-based handling of attributes during expansion][82608]
375 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
376   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
377   to confusion and potential security vulnerabilities and [is no
378   longer recommended][ietf6943].
379 - [The added `BITS` constant may conflict with external definitions.][85667]
380   In particular, this was known to be a problem in the `lexical-core` crate,
381   but they have published fixes for semantic versions 0.4 through 0.7. To
382   update this dependency alone, use `cargo update -p lexical-core`.
383 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
384
385 Internal Only
386 -------------
387 These changes provide no direct user facing benefits, but represent significant
388 improvements to the internals and overall performance of rustc and
389 related tools.
390
391 - [Rework the `std::sys::windows::alloc` implementation.][83065]
392 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
393 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
394 - [Rework rustdoc const type][82873]
395
396 [85667]: https://github.com/rust-lang/rust/pull/85667
397 [83386]: https://github.com/rust-lang/rust/pull/83386
398 [82771]: https://github.com/rust-lang/rust/pull/82771
399 [84147]: https://github.com/rust-lang/rust/pull/84147
400 [84082]: https://github.com/rust-lang/rust/pull/84082
401 [83799]: https://github.com/rust-lang/rust/pull/83799
402 [83681]: https://github.com/rust-lang/rust/pull/83681
403 [83652]: https://github.com/rust-lang/rust/pull/83652
404 [83387]: https://github.com/rust-lang/rust/pull/83387
405 [82873]: https://github.com/rust-lang/rust/pull/82873
406 [82864]: https://github.com/rust-lang/rust/pull/82864
407 [82608]: https://github.com/rust-lang/rust/pull/82608
408 [82565]: https://github.com/rust-lang/rust/pull/82565
409 [80525]: https://github.com/rust-lang/rust/pull/80525
410 [79278]: https://github.com/rust-lang/rust/pull/79278
411 [78618]: https://github.com/rust-lang/rust/pull/78618
412 [77704]: https://github.com/rust-lang/rust/pull/77704
413 [83941]: https://github.com/rust-lang/rust/pull/83941
414 [83065]: https://github.com/rust-lang/rust/pull/83065
415 [81764]: https://github.com/rust-lang/rust/pull/81764
416 [81469]: https://github.com/rust-lang/rust/pull/81469
417 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
418 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
419 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
420 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
421 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
422 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
423 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
424 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
425 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
426 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
427 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
428 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
429 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
430 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
431 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
432 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
433 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
434 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
435 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
436 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
437 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
438 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
439 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
440 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
441 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
442 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
443 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
444 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
445 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
446 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
447 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
448 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
449 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
450 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
451 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
452 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
453 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
454 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
455 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
456 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
457 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
458 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
459
460
461 Version 1.52.1 (2021-05-10)
462 ============================
463
464 This release disables incremental compilation, unless the user has explicitly
465 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
466
467 This is due to the widespread, and frequently occuring, breakage encountered by
468 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
469 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
470 newly added incremental verification are still present in past stable versions,
471 and are not yet fixed on any channel. These bugs can lead to miscompilation of
472 Rust binaries.
473
474 These problems only affect incremental builds, so release builds with Cargo
475 should not be affected unless the user has explicitly opted into incremental.
476 Debug and check builds are affected.
477
478 See [84970] for more details.
479
480 [84970]: https://github.com/rust-lang/rust/issues/84970
481
482 Version 1.52.0 (2021-05-06)
483 ============================
484
485 Language
486 --------
487 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
488   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
489   is allowed by default, and may become a warning or hard error in a
490   future edition.
491 - [You can now cast mutable references to arrays to a pointer of the same type as
492   the element.][81479]
493
494 Compiler
495 --------
496 - [Upgraded the default LLVM to LLVM 12.][81451]
497
498 Added tier 3\* support for the following targets.
499
500 - [`s390x-unknown-linux-musl`][82166]
501 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
502 - [`powerpc-unknown-openbsd`][82733]
503
504 \* Refer to Rust's [platform support page][platform-support-doc] for more
505 information on Rust's tiered platform support.
506
507 Libraries
508 ---------
509 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
510 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
511 - [`Arc<impl Error>` now implements `error::Error`.][80553]
512 - [All integer division and remainder operations are now `const`.][80962]
513
514 Stabilised APIs
515 -------------
516 - [`Arguments::as_str`]
517 - [`char::MAX`]
518 - [`char::REPLACEMENT_CHARACTER`]
519 - [`char::UNICODE_VERSION`]
520 - [`char::decode_utf16`]
521 - [`char::from_digit`]
522 - [`char::from_u32_unchecked`]
523 - [`char::from_u32`]
524 - [`slice::partition_point`]
525 - [`str::rsplit_once`]
526 - [`str::split_once`]
527
528 The following previously stable APIs are now `const`.
529
530 - [`char::len_utf8`]
531 - [`char::len_utf16`]
532 - [`char::to_ascii_uppercase`]
533 - [`char::to_ascii_lowercase`]
534 - [`char::eq_ignore_ascii_case`]
535 - [`u8::to_ascii_uppercase`]
536 - [`u8::to_ascii_lowercase`]
537 - [`u8::eq_ignore_ascii_case`]
538
539 Rustdoc
540 -------
541 - [Rustdoc lints are now treated as a tool lint, meaning that
542   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
543   Using the old style is still allowed, and will become a warning in
544   a future release.
545 - [Rustdoc now supports argument files.][82261]
546 - [Rustdoc now generates smart punctuation for documentation.][79423]
547 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
548   ```markdown
549   - [x] Complete
550   - [ ] Todo
551   ```
552
553 Misc
554 ----
555 - [You can now pass multiple filters to tests.][81356] E.g.
556   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
557 - [Rustup now distributes PDB symbols for the `std` library on Windows,
558   allowing you to see `std` symbols when debugging.][82218]
559
560 Internal Only
561 -------------
562 These changes provide no direct user facing benefits, but represent significant
563 improvements to the internals and overall performance of rustc and
564 related tools.
565
566 - [Check the result cache before the DepGraph when ensuring queries][81855]
567 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
568 - [Only store a LocalDefId in some HIR nodes][81611]
569 - [Store HIR attributes in a side table][79519]
570
571 Compatibility Notes
572 -------------------
573 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
574 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
575 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
576 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
577   languages in code blocks.][78429]
578 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
579 - [Changes in how proc macros handle whitespace may lead to panics when used
580   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
581 - [Turn `#[derive]` into a regular macro attribute][79078]
582
583 [84136]: https://github.com/rust-lang/rust/issues/84136
584 [80763]: https://github.com/rust-lang/rust/pull/80763
585 [82166]: https://github.com/rust-lang/rust/pull/82166
586 [82121]: https://github.com/rust-lang/rust/pull/82121
587 [81879]: https://github.com/rust-lang/rust/pull/81879
588 [82261]: https://github.com/rust-lang/rust/pull/82261
589 [82218]: https://github.com/rust-lang/rust/pull/82218
590 [82216]: https://github.com/rust-lang/rust/pull/82216
591 [82202]: https://github.com/rust-lang/rust/pull/82202
592 [81855]: https://github.com/rust-lang/rust/pull/81855
593 [81766]: https://github.com/rust-lang/rust/pull/81766
594 [81744]: https://github.com/rust-lang/rust/pull/81744
595 [81611]: https://github.com/rust-lang/rust/pull/81611
596 [81479]: https://github.com/rust-lang/rust/pull/81479
597 [81451]: https://github.com/rust-lang/rust/pull/81451
598 [81356]: https://github.com/rust-lang/rust/pull/81356
599 [80962]: https://github.com/rust-lang/rust/pull/80962
600 [80553]: https://github.com/rust-lang/rust/pull/80553
601 [80527]: https://github.com/rust-lang/rust/pull/80527
602 [79519]: https://github.com/rust-lang/rust/pull/79519
603 [79423]: https://github.com/rust-lang/rust/pull/79423
604 [79208]: https://github.com/rust-lang/rust/pull/79208
605 [78429]: https://github.com/rust-lang/rust/pull/78429
606 [82733]: https://github.com/rust-lang/rust/pull/82733
607 [82594]: https://github.com/rust-lang/rust/pull/82594
608 [79078]: https://github.com/rust-lang/rust/pull/79078
609 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
610 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
611 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
612 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
613 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
614 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
615 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
616 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
617 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
618 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
619 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
620 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
621 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
622 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
623 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
624 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
625 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
626 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
627 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
628 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
629 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
630 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
631
632 Version 1.51.0 (2021-03-25)
633 ============================
634
635 Language
636 --------
637 - [You can now parameterize items such as functions, traits, and `struct`s by constant
638   values in addition to by types and lifetimes.][79135] Also known as "const generics"
639   E.g. you can now write the following. Note: Only values of primitive integers,
640   `bool`, or `char` types are currently permitted.
641   ```rust
642   struct GenericArray<T, const LENGTH: usize> {
643       inner: [T; LENGTH]
644   }
645
646   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
647       const fn last(&self) -> Option<&T> {
648           if LENGTH == 0 {
649               None
650           } else {
651               Some(&self.inner[LENGTH - 1])
652           }
653       }
654   }
655   ```
656
657
658 Compiler
659 --------
660
661 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
662   This option controls whether debug information is split across multiple files
663   or packed into a single file. **Note** This option is unstable on other platforms.
664 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
665   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
666 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
667 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
668
669 \* Refer to Rust's [platform support page][platform-support-doc] for more
670 information on Rust's tiered platform support.
671
672 Libraries
673 ---------
674
675 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
676 - [`str` now implements `AsMut<str>`.][80279]
677 - [`u64` and `u128` now implement `From<char>`.][79502]
678 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
679 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
680 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
681 - [`io::Empty` now implements `io::Seek`.][78044]
682 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
683   `T: ?Sized` types.][80764]
684 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
685
686
687 Stabilized APIs
688 ---------------
689
690 - [`Arc::decrement_strong_count`]
691 - [`Arc::increment_strong_count`]
692 - [`Once::call_once_force`]
693 - [`Peekable::next_if_eq`]
694 - [`Peekable::next_if`]
695 - [`Seek::stream_position`]
696 - [`array::IntoIter`]
697 - [`panic::panic_any`]
698 - [`ptr::addr_of!`]
699 - [`ptr::addr_of_mut!`]
700 - [`slice::fill_with`]
701 - [`slice::split_inclusive_mut`]
702 - [`slice::split_inclusive`]
703 - [`slice::strip_prefix`]
704 - [`slice::strip_suffix`]
705 - [`str::split_inclusive`]
706 - [`sync::OnceState`]
707 - [`task::Wake`]
708 - [`VecDeque::range`]
709 - [`VecDeque::range_mut`]
710
711 Cargo
712 -----
713 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
714   codegen option.][cargo/9112]
715 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
716   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
717   to avoid unifying features of dependencies where that unification could be unwanted.
718   Such as using the same dependency with a `std` feature in a build scripts and
719   proc-macros, while using the `no-std` feature in the final binary. See the
720   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
721
722 Rustdoc
723 -------
724
725 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
726 - [You can now provide a `--default-theme` flag which sets the default theme to use for
727   documentation.][79642]
728
729 Various improvements to intra-doc links:
730
731 - [You can link to non-path primitives such as `slice`.][80181]
732 - [You can link to associated items.][74489]
733 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
734
735 Misc
736 ----
737 - [You can now pass `--include-ignored` to tests (e.g. with
738   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
739
740 Compatibility Notes
741 -------------------
742
743 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
744 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
745   could fail.][80579]
746 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
747   for the distributed artifacts.][81521]
748     - `armv5te-unknown-linux-gnueabi`
749     - `sparc64-unknown-linux-gnu`
750     - `thumbv7neon-unknown-linux-gnueabihf`
751     - `armv7-unknown-linux-gnueabi`
752     - `x86_64-unknown-linux-gnux32`
753 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
754
755 Internal Only
756 -------------
757
758 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
759
760 [79135]: https://github.com/rust-lang/rust/pull/79135
761 [74489]: https://github.com/rust-lang/rust/pull/74489
762 [76934]: https://github.com/rust-lang/rust/pull/76934
763 [79570]: https://github.com/rust-lang/rust/pull/79570
764 [80181]: https://github.com/rust-lang/rust/pull/80181
765 [79642]: https://github.com/rust-lang/rust/pull/79642
766 [80945]: https://github.com/rust-lang/rust/pull/80945
767 [80279]: https://github.com/rust-lang/rust/pull/80279
768 [80053]: https://github.com/rust-lang/rust/pull/80053
769 [79502]: https://github.com/rust-lang/rust/pull/79502
770 [75180]: https://github.com/rust-lang/rust/pull/75180
771 [79135]: https://github.com/rust-lang/rust/pull/79135
772 [81521]: https://github.com/rust-lang/rust/pull/81521
773 [80968]: https://github.com/rust-lang/rust/pull/80968
774 [80959]: https://github.com/rust-lang/rust/pull/80959
775 [80718]: https://github.com/rust-lang/rust/pull/80718
776 [80653]: https://github.com/rust-lang/rust/pull/80653
777 [80579]: https://github.com/rust-lang/rust/pull/80579
778 [79998]: https://github.com/rust-lang/rust/pull/79998
779 [78044]: https://github.com/rust-lang/rust/pull/78044
780 [81455]: https://github.com/rust-lang/rust/pull/81455
781 [80764]: https://github.com/rust-lang/rust/pull/80764
782 [80749]: https://github.com/rust-lang/rust/pull/80749
783 [80662]: https://github.com/rust-lang/rust/pull/80662
784 [79134]: https://github.com/rust-lang/rust/pull/79134
785 [80966]: https://github.com/rust-lang/rust/pull/80966
786 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
787 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
788 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
789 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
790 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
791 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
792 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
793 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
794 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
795 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
796 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
797 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
798 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
799 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
800 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
801 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
802 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
803 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
804 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
805 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
806 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
807 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
808 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
809
810 Version 1.50.0 (2021-02-11)
811 ============================
812
813 Language
814 -----------------------
815 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
816   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
817 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
818
819 Compiler
820 -----------------------
821 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
822 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
823 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
824 - [Dropped support for all cloudabi targets.][78439]
825
826 \* Refer to Rust's [platform support page][platform-support-doc] for more
827 information on Rust's tiered platform support.
828
829 Libraries
830 -----------------------
831
832 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
833 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
834 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
835   This value cannot be a valid file descriptor, and now means `Option<File>` takes
836   up the same amount of space as `File`.
837
838 Stabilized APIs
839 ---------------
840
841 - [`bool::then`]
842 - [`btree_map::Entry::or_insert_with_key`]
843 - [`f32::clamp`]
844 - [`f64::clamp`]
845 - [`hash_map::Entry::or_insert_with_key`]
846 - [`Ord::clamp`]
847 - [`RefCell::take`]
848 - [`slice::fill`]
849 - [`UnsafeCell::get_mut`]
850
851 The following previously stable methods are now `const`.
852
853 - [`IpAddr::is_ipv4`]
854 - [`IpAddr::is_ipv6`]
855 - [`IpAddr::is_unspecified`]
856 - [`IpAddr::is_loopback`]
857 - [`IpAddr::is_multicast`]
858 - [`Ipv4Addr::octets`]
859 - [`Ipv4Addr::is_loopback`]
860 - [`Ipv4Addr::is_private`]
861 - [`Ipv4Addr::is_link_local`]
862 - [`Ipv4Addr::is_multicast`]
863 - [`Ipv4Addr::is_broadcast`]
864 - [`Ipv4Addr::is_documentation`]
865 - [`Ipv4Addr::to_ipv6_compatible`]
866 - [`Ipv4Addr::to_ipv6_mapped`]
867 - [`Ipv6Addr::segments`]
868 - [`Ipv6Addr::is_unspecified`]
869 - [`Ipv6Addr::is_loopback`]
870 - [`Ipv6Addr::is_multicast`]
871 - [`Ipv6Addr::to_ipv4`]
872 - [`Layout::size`]
873 - [`Layout::align`]
874 - [`Layout::from_size_align`]
875 - `pow` for all integer types.
876 - `checked_pow` for all integer types.
877 - `saturating_pow` for all integer types.
878 - `wrapping_pow` for all integer types.
879 - `next_power_of_two` for all unsigned integer types.
880 - `checked_next_power_of_two` for all unsigned integer types.
881
882 Cargo
883 -----------------------
884
885 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
886   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
887 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
888   contents of that directory for changes.][cargo/8973]
889 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
890
891 Misc
892 ----
893
894 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
895 - [Running tests will now print the total time taken to execute.][75752]
896
897 Compatibility Notes
898 -------------------
899
900 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
901   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
902 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
903   unhygenic `macro_rules!` macros.][79472]
904 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
905   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
906 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
907 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
908   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
909 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
910
911 [74989]: https://github.com/rust-lang/rust/pull/74989
912 [79261]: https://github.com/rust-lang/rust/pull/79261
913 [79896]: https://github.com/rust-lang/rust/pull/79896
914 [79484]: https://github.com/rust-lang/rust/pull/79484
915 [79472]: https://github.com/rust-lang/rust/pull/79472
916 [79270]: https://github.com/rust-lang/rust/pull/79270
917 [79003]: https://github.com/rust-lang/rust/pull/79003
918 [78864]: https://github.com/rust-lang/rust/pull/78864
919 [78636]: https://github.com/rust-lang/rust/pull/78636
920 [78439]: https://github.com/rust-lang/rust/pull/78439
921 [78343]: https://github.com/rust-lang/rust/pull/78343
922 [78296]: https://github.com/rust-lang/rust/pull/78296
923 [78068]: https://github.com/rust-lang/rust/pull/78068
924 [75752]: https://github.com/rust-lang/rust/pull/75752
925 [74699]: https://github.com/rust-lang/rust/pull/74699
926 [78142]: https://github.com/rust-lang/rust/pull/78142
927 [77484]: https://github.com/rust-lang/rust/pull/77484
928 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
929 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
930 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
931 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
932 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
933 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
934 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
935 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
936 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
937 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
938 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
939 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
940 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
941 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
942 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
943 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
944 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
945 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
946 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
947 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
948 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
949 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
950 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
951 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
952 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
953 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
954 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
955 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
956 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
957 [`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
958 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
959 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
960 [`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
961 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
962
963
964 Version 1.49.0 (2020-12-31)
965 ============================
966
967 Language
968 -----------------------
969
970 - [Unions can now implement `Drop`, and you can now have a field in a union
971   with `ManuallyDrop<T>`.][77547]
972 - [You can now cast uninhabited enums to integers.][76199]
973 - [You can now bind by reference and by move in patterns.][76119] This
974   allows you to selectively borrow individual components of a type. E.g.
975   ```rust
976   #[derive(Debug)]
977   struct Person {
978       name: String,
979       age: u8,
980   }
981
982   let person = Person {
983       name: String::from("Alice"),
984       age: 20,
985   };
986
987   // `name` is moved out of person, but `age` is referenced.
988   let Person { name, ref age } = person;
989   println!("{} {}", name, age);
990   ```
991
992 Compiler
993 -----------------------
994
995 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
996 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
997 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
998 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
999 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
1000 - [Output from threads spawned in tests is now captured.][78227]
1001 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1002
1003 \* Refer to Rust's [platform support page][platform-support-doc] for more
1004 information on Rust's tiered platform support.
1005
1006 Libraries
1007 -----------------------
1008
1009 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1010 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1011
1012 Stabilized APIs
1013 ---------------
1014
1015 - [`slice::select_nth_unstable`]
1016 - [`slice::select_nth_unstable_by`]
1017 - [`slice::select_nth_unstable_by_key`]
1018
1019 The following previously stable methods are now `const`.
1020
1021 - [`Poll::is_ready`]
1022 - [`Poll::is_pending`]
1023
1024 Cargo
1025 -----------------------
1026 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1027 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1028 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1029   variable will be set if the crate being built is one the user selected to build, either
1030   with `-p` or through defaults.
1031 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1032
1033
1034 Compatibility Notes
1035 -------------------
1036
1037 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1038 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1039 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1040   Previously such invalid or unused attributes could be ignored.
1041 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1042   read [this post about the changes][rustdoc-ws-post] for more details.
1043 - [Trait bounds are no longer inferred for associated types.][79904]
1044
1045 Internal Only
1046 -------------
1047 These changes provide no direct user facing benefits, but represent significant
1048 improvements to the internals and overall performance of rustc and
1049 related tools.
1050
1051 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1052   Local Storage model.][78201]
1053 - [Calculate visibilities once in resolve.][78077]
1054 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1055 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1056
1057
1058 [75991]: https://github.com/rust-lang/rust/pull/75991
1059 [78951]: https://github.com/rust-lang/rust/pull/78951
1060 [78848]: https://github.com/rust-lang/rust/pull/78848
1061 [78746]: https://github.com/rust-lang/rust/pull/78746
1062 [78376]: https://github.com/rust-lang/rust/pull/78376
1063 [78228]: https://github.com/rust-lang/rust/pull/78228
1064 [78227]: https://github.com/rust-lang/rust/pull/78227
1065 [78201]: https://github.com/rust-lang/rust/pull/78201
1066 [78109]: https://github.com/rust-lang/rust/pull/78109
1067 [78077]: https://github.com/rust-lang/rust/pull/78077
1068 [77997]: https://github.com/rust-lang/rust/pull/77997
1069 [77703]: https://github.com/rust-lang/rust/pull/77703
1070 [77547]: https://github.com/rust-lang/rust/pull/77547
1071 [77015]: https://github.com/rust-lang/rust/pull/77015
1072 [76199]: https://github.com/rust-lang/rust/pull/76199
1073 [76119]: https://github.com/rust-lang/rust/pull/76119
1074 [75914]: https://github.com/rust-lang/rust/pull/75914
1075 [79004]: https://github.com/rust-lang/rust/pull/79004
1076 [78676]: https://github.com/rust-lang/rust/pull/78676
1077 [79904]: https://github.com/rust-lang/rust/issues/79904
1078 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1079 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1080 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1081 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1082 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1083 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1084 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1085 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1086 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1087 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1088 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1089
1090 Version 1.48.0 (2020-11-19)
1091 ==========================
1092
1093 Language
1094 --------
1095
1096 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1097   is still rejected *semantically*, but can now be parsed by procedural macros.
1098
1099 Compiler
1100 --------
1101 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1102   `rustc` whether to link its own C runtime and libraries or to rely on a external
1103   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1104 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1105   Note: If you're using cargo you must explicitly pass the `--target` flag.
1106 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1107
1108 \* Refer to Rust's [platform support page][platform-support-doc] for more
1109 information on Rust's tiered platform support.
1110
1111 Libraries
1112 ---------
1113 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1114   and `&Stderr`.][76275]
1115 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1116 - [The `matches!` macro now supports having a trailing comma.][74880]
1117 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1118 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1119
1120 Stabilized APIs
1121 ---------------
1122 - [`slice::as_ptr_range`]
1123 - [`slice::as_mut_ptr_range`]
1124 - [`VecDeque::make_contiguous`]
1125 - [`future::pending`]
1126 - [`future::ready`]
1127
1128 The following previously stable methods are now `const fn`'s:
1129
1130 - [`Option::is_some`]
1131 - [`Option::is_none`]
1132 - [`Option::as_ref`]
1133 - [`Result::is_ok`]
1134 - [`Result::is_err`]
1135 - [`Result::as_ref`]
1136 - [`Ordering::reverse`]
1137 - [`Ordering::then`]
1138
1139 Cargo
1140 -----
1141
1142 Rustdoc
1143 -------
1144 - [You can now link to items in `rustdoc` using the intra-doc link
1145   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1146   a link to `std::future`'s documentation. See ["Linking to items by
1147   name"][intradoc-links] for more information.
1148 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1149   when searching through `rustdoc`'s UI.][75740]
1150
1151 Compatibility Notes
1152 -------------------
1153 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1154   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1155   promoted to `'static` lifetime any more inside `const fn`s.
1156 - [Associated type bindings on trait objects are now verified to meet the bounds
1157   declared on the trait when checking that they implement the trait.][27675]
1158 - [When trait bounds on associated types or opaque types are ambiguous, the
1159   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1160 - [Fixed recursive nonterminals not being expanded in macros during
1161   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1162   correctly handling recursive nonterminal tokens.
1163 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1164 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1165   in places where they have no effect.][73461]
1166 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1167   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1168 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1169   disallow zero-initialization.][71274]
1170 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1171 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1172   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1173   see the [`catch_unwind`] documentation for further information.
1174
1175
1176
1177 Internal Only
1178 -------------
1179 These changes provide no direct user facing benefits, but represent significant
1180 improvements to the internals and overall performance of rustc and
1181 related tools.
1182
1183 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1184   You can continue building with `make` by setting `ninja=false` in
1185   your `config.toml`.
1186 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1187 - [Made `ensure_sufficient_stack()` non-generic][76680]
1188
1189 [78143]: https://github.com/rust-lang/rust/issues/78143
1190 [76680]: https://github.com/rust-lang/rust/pull/76680/
1191 [76030]: https://github.com/rust-lang/rust/pull/76030/
1192 [70212]: https://github.com/rust-lang/rust/pull/70212/
1193 [27675]: https://github.com/rust-lang/rust/issues/27675/
1194 [54121]: https://github.com/rust-lang/rust/issues/54121/
1195 [71274]: https://github.com/rust-lang/rust/pull/71274/
1196 [77386]: https://github.com/rust-lang/rust/pull/77386/
1197 [77153]: https://github.com/rust-lang/rust/pull/77153/
1198 [77055]: https://github.com/rust-lang/rust/pull/77055/
1199 [76275]: https://github.com/rust-lang/rust/pull/76275/
1200 [76310]: https://github.com/rust-lang/rust/pull/76310/
1201 [76420]: https://github.com/rust-lang/rust/pull/76420/
1202 [76158]: https://github.com/rust-lang/rust/pull/76158/
1203 [75857]: https://github.com/rust-lang/rust/pull/75857/
1204 [75585]: https://github.com/rust-lang/rust/pull/75585/
1205 [75740]: https://github.com/rust-lang/rust/pull/75740/
1206 [75502]: https://github.com/rust-lang/rust/pull/75502/
1207 [74880]: https://github.com/rust-lang/rust/pull/74880/
1208 [74922]: https://github.com/rust-lang/rust/pull/74922/
1209 [74430]: https://github.com/rust-lang/rust/pull/74430/
1210 [74194]: https://github.com/rust-lang/rust/pull/74194/
1211 [73461]: https://github.com/rust-lang/rust/pull/73461/
1212 [73166]: https://github.com/rust-lang/rust/pull/73166/
1213 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1214 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1215 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1216 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1217 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1218 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1219 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1220 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1221 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1222 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1223 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1224 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1225 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1226 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1227 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1228
1229
1230 Version 1.47.0 (2020-10-08)
1231 ==========================
1232
1233 Language
1234 --------
1235 - [Closures will now warn when not used.][74869]
1236
1237 Compiler
1238 --------
1239 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1240   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1241   platforms.
1242 - [Upgraded to LLVM 11.][73526]
1243 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1244 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1245 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1246
1247 \* Refer to Rust's [platform support page][platform-support-doc] for more
1248 information on Rust's tiered platform support.
1249
1250 Libraries
1251 ---------
1252 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1253 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1254   those of length less than 33.][74060]
1255 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1256 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1257   `PartialEq`, and `PartialOrd`.][73583]
1258
1259 Stabilized APIs
1260 ---------------
1261 - [`Ident::new_raw`]
1262 - [`Range::is_empty`]
1263 - [`RangeInclusive::is_empty`]
1264 - [`Result::as_deref`]
1265 - [`Result::as_deref_mut`]
1266 - [`Vec::leak`]
1267 - [`pointer::offset_from`]
1268 - [`f32::TAU`]
1269 - [`f64::TAU`]
1270
1271 The following previously stable APIs have now been made const.
1272
1273 - [The `new` method for all `NonZero` integers.][73858]
1274 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1275   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1276   methods for all integers.][73858]
1277 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1278   signed integers.][73858]
1279 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1280   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1281   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1282   `is_ascii_control` methods for `char` and `u8`.][73858]
1283
1284 Cargo
1285 -----
1286 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1287   You can override this by setting the following in your `Cargo.toml`.
1288   ```toml
1289   [profile.release.build-override]
1290   opt-level = 3
1291   ```
1292 - [`cargo-help` will now display man pages for commands rather just the
1293   `--help` text.][cargo/8456]
1294 - [`cargo-metadata` now emits a `test` field indicating if a target has
1295   tests enabled.][cargo/8478]
1296 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1297 - [`cargo-publish` will now use an alternative registry by default if it's the
1298   only registry specified in `package.publish`.][cargo/8571]
1299
1300 Misc
1301 ----
1302 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1303   type based search.][75366]
1304 - [Added the Ayu theme to rustdoc.][71237]
1305
1306 Compatibility Notes
1307 -------------------
1308 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1309 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1310 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1311   help to preserve more span information.][73084] These changes may cause
1312   compiliation errors if your macro was unhygenic or didn't correctly handle
1313   `Delimiter::None`.
1314 - [Moved support for the CloudABI target to tier 3.][75568]
1315 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1316 - [Added the `rustc-docs` component.][75560] This allows you to install
1317   and read the documentation for the compiler internal APIs. (Currently only
1318   available for `x86_64-unknown-linux-gnu`.)
1319
1320 Internal Only
1321 --------
1322
1323 - [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.
1324
1325 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1326 [75048]: https://github.com/rust-lang/rust/pull/75048/
1327 [74163]: https://github.com/rust-lang/rust/pull/74163/
1328 [71237]: https://github.com/rust-lang/rust/pull/71237/
1329 [74869]: https://github.com/rust-lang/rust/pull/74869/
1330 [73858]: https://github.com/rust-lang/rust/pull/73858/
1331 [75716]: https://github.com/rust-lang/rust/pull/75716/
1332 [75908]: https://github.com/rust-lang/rust/pull/75908/
1333 [75516]: https://github.com/rust-lang/rust/pull/75516/
1334 [75560]: https://github.com/rust-lang/rust/pull/75560/
1335 [75568]: https://github.com/rust-lang/rust/pull/75568/
1336 [75366]: https://github.com/rust-lang/rust/pull/75366/
1337 [75204]: https://github.com/rust-lang/rust/pull/75204/
1338 [74650]: https://github.com/rust-lang/rust/pull/74650/
1339 [74419]: https://github.com/rust-lang/rust/pull/74419/
1340 [73964]: https://github.com/rust-lang/rust/pull/73964/
1341 [74021]: https://github.com/rust-lang/rust/pull/74021/
1342 [74060]: https://github.com/rust-lang/rust/pull/74060/
1343 [73893]: https://github.com/rust-lang/rust/pull/73893/
1344 [73526]: https://github.com/rust-lang/rust/pull/73526/
1345 [73583]: https://github.com/rust-lang/rust/pull/73583/
1346 [73084]: https://github.com/rust-lang/rust/pull/73084/
1347 [73197]: https://github.com/rust-lang/rust/pull/73197/
1348 [72488]: https://github.com/rust-lang/rust/pull/72488/
1349 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1350 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1351 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1352 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1353 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1354 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1355 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1356 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1357 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1358 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1359 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1360 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1361 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1362 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1363 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1364
1365
1366 Version 1.46.0 (2020-08-27)
1367 ==========================
1368
1369 Language
1370 --------
1371 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1372 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1373   const functions.][73862]
1374 - [The `#[track_caller]` attribute can now be added to functions to use the
1375   function's caller's location information for panic messages.][72445]
1376 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1377   `x.0.0` over `(x.0).0`.
1378 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1379   You currently can't use `mem::transmute` in constant functions.
1380
1381 Compiler
1382 --------
1383 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1384 - [Enabled static "Position Independent Executables" by default
1385   for `x86_64-unknown-linux-musl`.][70740]
1386
1387 Libraries
1388 ---------
1389 - [`mem::forget` is now a `const fn`.][73887]
1390 - [`String` now implements `From<char>`.][73466]
1391 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1392   integer types.][73032]
1393 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1394 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1395   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1396 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1397 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1398 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1399
1400 Stabilized APIs
1401 ---------------
1402 - [`Option::zip`]
1403 - [`vec::Drain::as_slice`]
1404
1405 Cargo
1406 -----
1407 Added a number of new environment variables that are now available when
1408 compiling your crate.
1409
1410 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1411   the specific binary being compiled and the name of the crate.
1412 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1413 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1414
1415 Compatibility Notes
1416 -------------------
1417 - [The target configuration option `abi_blacklist` has been renamed
1418   to `unsupported_abis`.][74150] The old name will still continue to work.
1419 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1420   This was previously accepted but will become a hard error in a future release.
1421 - [Rustc will fail to compile if you have a struct with
1422   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1423   allowed on `enum`s.
1424 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1425   ensure that spans have the correct information, and may cause breakage if you
1426   were relying on receiving spans with dummy information.
1427 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1428   a legacy installer that was replaced by a MSI installer a few years ago but
1429   was still being built.
1430 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1431 - [Rustc will no longer accept overlapping trait implementations that only
1432   differ in how the lifetime was bound.][72493]
1433 - [Rustc now correctly relates the lifetime of an existential associated
1434   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1435   you to pass a shorter lifetime than expected.
1436 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1437   The library will need to be installed for `rustc` to work, even though we
1438   expect it to be already available on most systems.
1439 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1440   under QEMU.][74820]
1441 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1442   exact output returned by rustc's pretty printing is an unstable
1443   implementation detail: we recommend any macro relying on it to switch to a
1444   more robust parsing system.
1445
1446 [75453]: https://github.com/rust-lang/rust/issues/75453/
1447 [74820]: https://github.com/rust-lang/rust/issues/74820/
1448 [74420]: https://github.com/rust-lang/rust/issues/74420/
1449 [74109]: https://github.com/rust-lang/rust/pull/74109/
1450 [74150]: https://github.com/rust-lang/rust/pull/74150/
1451 [73862]: https://github.com/rust-lang/rust/pull/73862/
1452 [73887]: https://github.com/rust-lang/rust/pull/73887/
1453 [73466]: https://github.com/rust-lang/rust/pull/73466/
1454 [73516]: https://github.com/rust-lang/rust/pull/73516/
1455 [73293]: https://github.com/rust-lang/rust/pull/73293/
1456 [73007]: https://github.com/rust-lang/rust/pull/73007/
1457 [73032]: https://github.com/rust-lang/rust/pull/73032/
1458 [72920]: https://github.com/rust-lang/rust/pull/72920/
1459 [72569]: https://github.com/rust-lang/rust/pull/72569/
1460 [72583]: https://github.com/rust-lang/rust/pull/72583/
1461 [72584]: https://github.com/rust-lang/rust/pull/72584/
1462 [72717]: https://github.com/rust-lang/rust/pull/72717/
1463 [72437]: https://github.com/rust-lang/rust/pull/72437/
1464 [72445]: https://github.com/rust-lang/rust/pull/72445/
1465 [72486]: https://github.com/rust-lang/rust/pull/72486/
1466 [72493]: https://github.com/rust-lang/rust/pull/72493/
1467 [72331]: https://github.com/rust-lang/rust/pull/72331/
1468 [71896]: https://github.com/rust-lang/rust/pull/71896/
1469 [71660]: https://github.com/rust-lang/rust/pull/71660/
1470 [71322]: https://github.com/rust-lang/rust/pull/71322/
1471 [70740]: https://github.com/rust-lang/rust/pull/70740/
1472 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1473 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1474 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1475 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1476 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1477
1478
1479 Version 1.45.2 (2020-08-03)
1480 ==========================
1481
1482 * [Fix bindings in tuple struct patterns][74954]
1483 * [Fix track_caller integration with trait objects][74784]
1484
1485 [74954]: https://github.com/rust-lang/rust/issues/74954
1486 [74784]: https://github.com/rust-lang/rust/issues/74784
1487
1488
1489 Version 1.45.1 (2020-07-30)
1490 ==========================
1491
1492 * [Fix const propagation with references.][73613]
1493 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1494 * [Avoid spurious implicit region bound.][74509]
1495 * [Install clippy on x.py install][74457]
1496
1497 [73613]: https://github.com/rust-lang/rust/pull/73613
1498 [73078]: https://github.com/rust-lang/rust/issues/73078
1499 [74509]: https://github.com/rust-lang/rust/pull/74509
1500 [74457]: https://github.com/rust-lang/rust/pull/74457
1501
1502
1503 Version 1.45.0 (2020-07-16)
1504 ==========================
1505
1506 Language
1507 --------
1508 - [Out of range float to int conversions using `as` has been defined as a saturating
1509   conversion.][71269] This was previously undefined behaviour, but you can use the
1510    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1511    may be desirable in rare performance sensitive situations.
1512 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1513   using `u64`.][70705]
1514 - [Function like procedural macros can now be used in expression, pattern, and  statement
1515   positions.][68717] This means you can now use a function-like procedural macro
1516   anywhere you can use a declarative (`macro_rules!`) macro.
1517
1518 Compiler
1519 --------
1520 - [You can now override individual target features through the `target-feature`
1521   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1522   equivalent to `-C target-feature=+avx2,+fma`.
1523 - [Added the `force-unwind-tables` flag.][69984] This option allows
1524   rustc to always generate unwind tables regardless of panic strategy.
1525 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1526   to include LLVM bitcode into generated `rlib`s (this is on by default).
1527 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1528 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1529 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1530 - [Upgraded to LLVM 10.][67759]
1531
1532 \* Refer to Rust's [platform support page][platform-support-doc] for more
1533 information on Rust's tiered platform support.
1534
1535
1536 Libraries
1537 ---------
1538 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1539   and `Ord`.][72239]
1540 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1541 - [You can now use `char` with
1542   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1543   a range of codepoints.][72413] E.g.
1544   you can now write the following;
1545   ```rust
1546   for ch in 'a'..='z' {
1547       print!("{}", ch);
1548   }
1549   println!();
1550   // Prints "abcdefghijklmnopqrstuvwxyz"
1551   ```
1552 - [`OsString` now implements `FromStr`.][71662]
1553 - [The `saturating_neg` method has been added to all signed integer primitive
1554   types, and the `saturating_abs` method has been added for all integer
1555   primitive types.][71886]
1556 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1557   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1558   or `Path`.][71447]
1559 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1560 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1561   integer types.][69813]
1562 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1563   integer types.][72324]
1564 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1565
1566 Stabilized APIs
1567 ---------------
1568 - [`Arc::as_ptr`]
1569 - [`BTreeMap::remove_entry`]
1570 - [`Rc::as_ptr`]
1571 - [`rc::Weak::as_ptr`]
1572 - [`rc::Weak::from_raw`]
1573 - [`rc::Weak::into_raw`]
1574 - [`str::strip_prefix`]
1575 - [`str::strip_suffix`]
1576 - [`sync::Weak::as_ptr`]
1577 - [`sync::Weak::from_raw`]
1578 - [`sync::Weak::into_raw`]
1579 - [`char::UNICODE_VERSION`]
1580 - [`Span::resolved_at`]
1581 - [`Span::located_at`]
1582 - [`Span::mixed_site`]
1583 - [`unix::process::CommandExt::arg0`]
1584
1585 Cargo
1586 -----
1587
1588 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1589   time.][cargo/8066]
1590
1591 Misc
1592 ----
1593 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1594   `~~outdated information~~` becomes "~~outdated information~~".
1595 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1596
1597 Compatibility Notes
1598 -------------------
1599 - [Trying to self initialize a static value (that is creating a value using
1600   itself) is unsound and now causes a compile error.][71140]
1601 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1602   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1603 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1604   previously undocumented and not intended for public use. Rustdoc still provides
1605   a non-zero exit code on errors.
1606 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1607   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1608   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1609   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1610   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1611
1612 Internals Only
1613 --------------
1614 - [Make clippy a git subtree instead of a git submodule][70655]
1615 - [Unify the undo log of all snapshot types][69464]
1616
1617 [71848]: https://github.com/rust-lang/rust/issues/71848/
1618 [73420]: https://github.com/rust-lang/rust/issues/73420/
1619 [72324]: https://github.com/rust-lang/rust/pull/72324/
1620 [71843]: https://github.com/rust-lang/rust/pull/71843/
1621 [71886]: https://github.com/rust-lang/rust/pull/71886/
1622 [72234]: https://github.com/rust-lang/rust/pull/72234/
1623 [72239]: https://github.com/rust-lang/rust/pull/72239/
1624 [72397]: https://github.com/rust-lang/rust/pull/72397/
1625 [72413]: https://github.com/rust-lang/rust/pull/72413/
1626 [72014]: https://github.com/rust-lang/rust/pull/72014/
1627 [72062]: https://github.com/rust-lang/rust/pull/72062/
1628 [72094]: https://github.com/rust-lang/rust/pull/72094/
1629 [72133]: https://github.com/rust-lang/rust/pull/72133/
1630 [67759]: https://github.com/rust-lang/rust/pull/67759/
1631 [71900]: https://github.com/rust-lang/rust/pull/71900/
1632 [71928]: https://github.com/rust-lang/rust/pull/71928/
1633 [71662]: https://github.com/rust-lang/rust/pull/71662/
1634 [71716]: https://github.com/rust-lang/rust/pull/71716/
1635 [71447]: https://github.com/rust-lang/rust/pull/71447/
1636 [71269]: https://github.com/rust-lang/rust/pull/71269/
1637 [71095]: https://github.com/rust-lang/rust/pull/71095/
1638 [71140]: https://github.com/rust-lang/rust/pull/71140/
1639 [70655]: https://github.com/rust-lang/rust/pull/70655/
1640 [70705]: https://github.com/rust-lang/rust/pull/70705/
1641 [69984]: https://github.com/rust-lang/rust/pull/69984/
1642 [69813]: https://github.com/rust-lang/rust/pull/69813/
1643 [69464]: https://github.com/rust-lang/rust/pull/69464/
1644 [68717]: https://github.com/rust-lang/rust/pull/68717/
1645 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1646 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1647 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1648 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1649 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1650 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1651 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1652 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1653 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1654 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1655 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1656 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1657 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1658 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1659 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1660 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1661 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1662
1663
1664 Version 1.44.1 (2020-06-18)
1665 ===========================
1666
1667 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1668 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1669 * [Fix crashes when finding backtrace on macOS.][71397]
1670 * [Clippy applies lint levels into different files.][clippy/5356]
1671
1672 [71397]: https://github.com/rust-lang/rust/issues/71397
1673 [73078]: https://github.com/rust-lang/rust/issues/73078
1674 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1675 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1676
1677
1678 Version 1.44.0 (2020-06-04)
1679 ==========================
1680
1681 Language
1682 --------
1683 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1684 - [Added the `unused_braces` lint.][70081]
1685
1686 **Syntax-only changes**
1687
1688 - [Expansion-driven outline module parsing][69838]
1689 ```rust
1690 #[cfg(FALSE)]
1691 mod foo {
1692     mod bar {
1693         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1694     }
1695 }
1696 ```
1697
1698 These are still rejected semantically, so you will likely receive an error but
1699 these changes can be seen and parsed by macros and conditional compilation.
1700
1701 Compiler
1702 --------
1703 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1704   Additionally when in incremental mode rustc defaults to 256 codegen units.
1705 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1706   a panic is thrown.][67502]
1707 - [Added tier 3\* support for the `aarch64-unknown-none` and
1708   `aarch64-unknown-none-softfloat` targets.][68334]
1709 - [Added tier 3 support for `arm64-apple-tvos` and
1710   `x86_64-apple-tvos` targets.][68191]
1711
1712
1713 Libraries
1714 ---------
1715 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1716   `vec![]` to be able to be used in `const` contexts.
1717 - [`convert::Infallible` now implements `Hash`.][70281]
1718 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1719   a `&mut OsStr`.][70048]
1720 - [Unicode 13 is now supported.][69929]
1721 - [`String` now implements `From<&mut str>`.][69661]
1722 - [`IoSlice` now implements `Copy`.][69403]
1723 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1724 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1725 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1726   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1727   integer types.][69373]
1728
1729 Stabilized APIs
1730 ---------------
1731 - [`PathBuf::with_capacity`]
1732 - [`PathBuf::capacity`]
1733 - [`PathBuf::clear`]
1734 - [`PathBuf::reserve`]
1735 - [`PathBuf::reserve_exact`]
1736 - [`PathBuf::shrink_to_fit`]
1737 - [`f32::to_int_unchecked`]
1738 - [`f64::to_int_unchecked`]
1739 - [`Layout::align_to`]
1740 - [`Layout::pad_to_align`]
1741 - [`Layout::array`]
1742 - [`Layout::extend`]
1743
1744 Cargo
1745 -----
1746 - [Added the `cargo tree` command which will print a tree graph of
1747   your dependencies.][cargo/8062] E.g.
1748   ```
1749     mdbook v0.3.2 (/Users/src/rust/mdbook)
1750   ├── ammonia v3.0.0
1751   │   ├── html5ever v0.24.0
1752   │   │   ├── log v0.4.8
1753   │   │   │   └── cfg-if v0.1.9
1754   │   │   ├── mac v0.1.1
1755   │   │   └── markup5ever v0.9.0
1756   │   │       ├── log v0.4.8 (*)
1757   │   │       ├── phf v0.7.24
1758   │   │       │   └── phf_shared v0.7.24
1759   │   │       │       ├── siphasher v0.2.3
1760   │   │       │       └── unicase v1.4.2
1761   │   │       │           [build-dependencies]
1762   │   │       │           └── version_check v0.1.5
1763   ...
1764   ```
1765   You can also display dependencies on multiple versions of the same crate with
1766   `cargo tree -d` (short for `cargo tree --duplicates`).
1767
1768 Misc
1769 ----
1770 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1771   the version in the sidebar.][69494]
1772
1773 Compatibility Notes
1774 -------------------
1775 - [Rustc now correctly generates static libraries on Windows GNU targets with
1776   the `.a` extension, rather than the previous `.lib`.][70937]
1777 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1778 - [The `file_name` property in JSON output of macro errors now points the actual
1779   source file rather than the previous format of `<NAME macros>`.][70969]
1780   **Note:** this may not point to a file that actually exists on the user's system.
1781 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1782 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1783   not allow zero initialization such as `NonZeroU8`.][66059] This was
1784   previously a warning.
1785 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1786   operator has been defined as a saturating operation.][71269] This was previously
1787   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1788   continue using the current behaviour, which may be desirable in rare performance
1789   sensitive situations.
1790
1791 Internal Only
1792 -------------
1793 These changes provide no direct user facing benefits, but represent significant
1794 improvements to the internals and overall performance of rustc and
1795 related tools.
1796
1797 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1798 - [Replace big JS dict with JSON parsing.][71250]
1799
1800 [69373]: https://github.com/rust-lang/rust/pull/69373/
1801 [66059]: https://github.com/rust-lang/rust/pull/66059/
1802 [68191]: https://github.com/rust-lang/rust/pull/68191/
1803 [68899]: https://github.com/rust-lang/rust/pull/68899/
1804 [71147]: https://github.com/rust-lang/rust/pull/71147/
1805 [71250]: https://github.com/rust-lang/rust/pull/71250/
1806 [70937]: https://github.com/rust-lang/rust/pull/70937/
1807 [70969]: https://github.com/rust-lang/rust/pull/70969/
1808 [70632]: https://github.com/rust-lang/rust/pull/70632/
1809 [70281]: https://github.com/rust-lang/rust/pull/70281/
1810 [70345]: https://github.com/rust-lang/rust/pull/70345/
1811 [70048]: https://github.com/rust-lang/rust/pull/70048/
1812 [70081]: https://github.com/rust-lang/rust/pull/70081/
1813 [70156]: https://github.com/rust-lang/rust/pull/70156/
1814 [71269]: https://github.com/rust-lang/rust/pull/71269/
1815 [69838]: https://github.com/rust-lang/rust/pull/69838/
1816 [69929]: https://github.com/rust-lang/rust/pull/69929/
1817 [69661]: https://github.com/rust-lang/rust/pull/69661/
1818 [69778]: https://github.com/rust-lang/rust/pull/69778/
1819 [69494]: https://github.com/rust-lang/rust/pull/69494/
1820 [69403]: https://github.com/rust-lang/rust/pull/69403/
1821 [69033]: https://github.com/rust-lang/rust/pull/69033/
1822 [68692]: https://github.com/rust-lang/rust/pull/68692/
1823 [68334]: https://github.com/rust-lang/rust/pull/68334/
1824 [67502]: https://github.com/rust-lang/rust/pull/67502/
1825 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1826 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1827 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1828 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1829 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1830 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1831 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1832 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1833 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1834 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1835 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1836 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1837 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1838
1839
1840 Version 1.43.1 (2020-05-07)
1841 ===========================
1842
1843 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1844 * [Fixed the stabilization of AVX-512 features.][71473]
1845 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1846
1847 [71430]: https://github.com/rust-lang/rust/pull/71430
1848 [71473]: https://github.com/rust-lang/rust/issues/71473
1849 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1850
1851
1852 Version 1.43.0 (2020-04-23)
1853 ==========================
1854
1855 Language
1856 --------
1857 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1858   the type inferred correctly.][68129]
1859 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1860
1861 **Syntax only changes**
1862 - [Allow `type Foo: Ord` syntactically.][69361]
1863 - [Fuse associated and extern items up to defaultness.][69194]
1864 - [Syntactically allow `self` in all `fn` contexts.][68764]
1865 - [Merge `fn` syntax + cleanup item parsing.][68728]
1866 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1867   For example, you may now write:
1868   ```rust
1869   macro_rules! mac_trait {
1870       ($i:item) => {
1871           trait T { $i }
1872       }
1873   }
1874   mac_trait! {
1875       fn foo() {}
1876   }
1877   ```
1878
1879 These are still rejected *semantically*, so you will likely receive an error but
1880 these changes can be seen and parsed by macros and
1881 conditional compilation.
1882
1883
1884 Compiler
1885 --------
1886 - [You can now pass multiple lint flags to rustc to override the previous
1887   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1888   everything in the `unused` lint group except `unused-variables` which
1889   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1890   everything in the `unused` lint group **including** `unused-variables` since
1891   the allow flag is specified before the deny flag (and therefore overridden).
1892 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1893   if they are available on `windows-gnu`.][67429]
1894 - [rustc now buffers errors/warnings printed in JSON.][69227]
1895
1896 Libraries
1897 ---------
1898 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1899   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1900   respectively.][69538] **Note** These conversions are only available when `N`
1901   is `0..=32`.
1902 - [You can now use associated constants on floats and integers directly, rather
1903   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1904   `f32::NAN` with no imports.
1905 - [`u8::is_ascii` is now `const`.][68984]
1906 - [`String` now implements `AsMut<str>`.][68742]
1907 - [Added the `primitive` module to `std` and `core`.][67637] This module
1908   reexports Rust's primitive types. This is mainly useful in macros
1909   where you want avoid these types being shadowed.
1910 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1911 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1912
1913 Stabilized APIs
1914 ---------------
1915 - [`Once::is_completed`]
1916 - [`f32::LOG10_2`]
1917 - [`f32::LOG2_10`]
1918 - [`f64::LOG10_2`]
1919 - [`f64::LOG2_10`]
1920 - [`iter::once_with`]
1921
1922 Cargo
1923 -----
1924 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1925   your environment.][cargo/7823]
1926 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1927   executable path when running integration tests or benchmarks.][cargo/7697]
1928   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1929   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1930
1931 Misc
1932 ----
1933 - [Certain checks in the `const_err` lint were deemed unrelated to const
1934   evaluation][69185], and have been moved to the `unconditional_panic` and
1935   `arithmetic_overflow` lints.
1936
1937 Compatibility Notes
1938 -------------------
1939
1940 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1941   has been a warning since 1.36.0.
1942 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1943   led to some instances being accepted, and now correctly emits a hard error.
1944
1945 [69340]: https://github.com/rust-lang/rust/pull/69340
1946
1947 Internal Only
1948 -------------
1949 These changes provide no direct user facing benefits, but represent significant
1950 improvements to the internals and overall performance of `rustc` and
1951 related tools.
1952
1953 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1954 - [Improved how rustc generates drop code.][67332]
1955 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1956 - [traits: preallocate 2 Vecs of known initial size][69022]
1957 - [Avoid exponential behaviour when relating types][68772]
1958 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1959 - [Improve performance of coherence checks][68966]
1960 - [Deduplicate types in the generator witness][68672]
1961 - [Invert control in struct_lint_level.][68725]
1962
1963 [67332]: https://github.com/rust-lang/rust/pull/67332/
1964 [67429]: https://github.com/rust-lang/rust/pull/67429/
1965 [67637]: https://github.com/rust-lang/rust/pull/67637/
1966 [67642]: https://github.com/rust-lang/rust/pull/67642/
1967 [67878]: https://github.com/rust-lang/rust/pull/67878/
1968 [67885]: https://github.com/rust-lang/rust/pull/67885/
1969 [68129]: https://github.com/rust-lang/rust/pull/68129/
1970 [68672]: https://github.com/rust-lang/rust/pull/68672/
1971 [68725]: https://github.com/rust-lang/rust/pull/68725/
1972 [68728]: https://github.com/rust-lang/rust/pull/68728/
1973 [68738]: https://github.com/rust-lang/rust/pull/68738/
1974 [68742]: https://github.com/rust-lang/rust/pull/68742/
1975 [68764]: https://github.com/rust-lang/rust/pull/68764/
1976 [68772]: https://github.com/rust-lang/rust/pull/68772/
1977 [68943]: https://github.com/rust-lang/rust/pull/68943/
1978 [68952]: https://github.com/rust-lang/rust/pull/68952/
1979 [68966]: https://github.com/rust-lang/rust/pull/68966/
1980 [68984]: https://github.com/rust-lang/rust/pull/68984/
1981 [69022]: https://github.com/rust-lang/rust/pull/69022/
1982 [69185]: https://github.com/rust-lang/rust/pull/69185/
1983 [69194]: https://github.com/rust-lang/rust/pull/69194/
1984 [69201]: https://github.com/rust-lang/rust/pull/69201/
1985 [69227]: https://github.com/rust-lang/rust/pull/69227/
1986 [69548]: https://github.com/rust-lang/rust/pull/69548/
1987 [69256]: https://github.com/rust-lang/rust/pull/69256/
1988 [69361]: https://github.com/rust-lang/rust/pull/69361/
1989 [69366]: https://github.com/rust-lang/rust/pull/69366/
1990 [69538]: https://github.com/rust-lang/rust/pull/69538/
1991 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1992 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1993 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1994 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1995 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1996 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1997 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1998 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1999
2000
2001 Version 1.42.0 (2020-03-12)
2002 ==========================
2003
2004 Language
2005 --------
2006 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2007   ```rust
2008   fn foo(words: &[&str]) {
2009       match words {
2010           ["Hello", "World", "!", ..] => println!("Hello World!"),
2011           ["Foo", "Bar", ..] => println!("Baz"),
2012           rest => println!("{:?}", rest),
2013       }
2014   }
2015   ```
2016 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2017   that you can create an enum that has the exact layout and ABI of the type
2018   it contains.
2019 - [You can now use outer attribute procedural macros on inline modules.][64273]
2020 - [There are some *syntax-only* changes:][67131]
2021    - `default` is syntactically allowed before items in `trait` definitions.
2022    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2023      leave out their bodies in favor of `;`.
2024    - Bounds on associated types in `impl`s are now syntactically allowed
2025      (e.g. `type Foo: Ord;`).
2026    - `...` (the C-variadic type) may occur syntactically directly as the type of
2027       any function parameter.
2028
2029   These are still rejected *semantically*, so you will likely receive an error
2030   but these changes can be seen and parsed by procedural macros and
2031   conditional compilation.
2032
2033 Compiler
2034 --------
2035 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2036 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2037 - [`Option::{expect,unwrap}` and
2038    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2039    pointing to the location where they were called, rather than
2040    `core`'s internals. ][67887]
2041
2042 \* Refer to Rust's [platform support page][platform-support-doc] for more
2043 information on Rust's tiered platform support.
2044
2045 Libraries
2046 ---------
2047 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2048 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2049    to implement `Sized`.][67935]
2050 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2051 - [`Layout::new` is now `const`.][66254]
2052 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2053
2054
2055 Stabilized APIs
2056 ---------------
2057 - [`CondVar::wait_while`]
2058 - [`CondVar::wait_timeout_while`]
2059 - [`DebugMap::key`]
2060 - [`DebugMap::value`]
2061 - [`ManuallyDrop::take`]
2062 - [`matches!`]
2063 - [`ptr::slice_from_raw_parts_mut`]
2064 - [`ptr::slice_from_raw_parts`]
2065
2066 Cargo
2067 -----
2068 - [You no longer need to include `extern crate proc_macro;` to be able to
2069   `use proc_macro;` in the `2018` edition.][cargo/7700]
2070
2071 Compatibility Notes
2072 -------------------
2073 - [`Error::description` has been deprecated, and its use will now produce a
2074   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2075
2076 [68253]: https://github.com/rust-lang/rust/pull/68253/
2077 [68348]: https://github.com/rust-lang/rust/pull/68348/
2078 [67935]: https://github.com/rust-lang/rust/pull/67935/
2079 [68339]: https://github.com/rust-lang/rust/pull/68339/
2080 [68122]: https://github.com/rust-lang/rust/pull/68122/
2081 [64273]: https://github.com/rust-lang/rust/pull/64273/
2082 [67712]: https://github.com/rust-lang/rust/pull/67712/
2083 [67887]: https://github.com/rust-lang/rust/pull/67887/
2084 [67131]: https://github.com/rust-lang/rust/pull/67131/
2085 [67233]: https://github.com/rust-lang/rust/pull/67233/
2086 [66899]: https://github.com/rust-lang/rust/pull/66899/
2087 [66919]: https://github.com/rust-lang/rust/pull/66919/
2088 [66254]: https://github.com/rust-lang/rust/pull/66254/
2089 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2090 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2091 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2092 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2093 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2094 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2095 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2096 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2097 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2098
2099
2100 Version 1.41.1 (2020-02-27)
2101 ===========================
2102
2103 * [Always check types of static items][69145]
2104 * [Always check lifetime bounds of `Copy` impls][69145]
2105 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2106
2107 [69225]: https://github.com/rust-lang/rust/issues/69225
2108 [69145]: https://github.com/rust-lang/rust/pull/69145
2109
2110
2111 Version 1.41.0 (2020-01-30)
2112 ===========================
2113
2114 Language
2115 --------
2116
2117 - [You can now pass type parameters to foreign items when implementing
2118   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2119 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2120   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2121   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2122 - [You can now use any valid identifier in a `format_args` macro.][66847]
2123   Previously identifiers starting with an underscore were not allowed.
2124 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2125   enum variants.][66183] These are still rejected semantically, but
2126   can be seen and parsed by procedural macros and conditional compilation.
2127
2128 Compiler
2129 --------
2130
2131 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2132 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2133 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2134 - [You can now pass an arguments file passing the `@path` syntax
2135   to rustc.][66172] Note that the format differs somewhat from what is
2136   found in other tooling; please see [the documentation][argfile-docs] for
2137   more information.
2138 - [You can now provide `--extern` flag without a path, indicating that it is
2139   available from the search path or specified with an `-L` flag.][64882]
2140
2141 \* Refer to Rust's [platform support page][platform-support-doc] for more
2142 information on Rust's tiered platform support.
2143
2144 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2145
2146 Libraries
2147 ---------
2148
2149 - [The `core::panic` module is now stable.][66771] It was already stable
2150   through `std`.
2151 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2152   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2153 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2154
2155 Stabilized APIs
2156 ---------------
2157
2158 - [`Result::map_or`]
2159 - [`Result::map_or_else`]
2160 - [`std::rc::Weak::weak_count`]
2161 - [`std::rc::Weak::strong_count`]
2162 - [`std::sync::Weak::weak_count`]
2163 - [`std::sync::Weak::strong_count`]
2164
2165 Cargo
2166 -----
2167
2168 - [Cargo will now document all the private items for binary crates
2169   by default.][cargo/7593]
2170 - [`cargo-install` will now reinstall the package if it detects that it is out
2171   of date.][cargo/7560]
2172 - [Cargo.lock now uses a more git friendly format that should help to reduce
2173   merge conflicts.][cargo/7579]
2174 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2175   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2176   optimisation level to `2` for debug builds. You can also use
2177   `[profile.<profile>.build-override]` to override build scripts and
2178   their dependencies.
2179
2180 Misc
2181 ----
2182
2183 - [You can now specify `edition` in documentation code blocks to compile the block
2184   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2185   should be compiled the 2018 edition of Rust.
2186 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2187   current theme with `--check-theme`.][54733]
2188 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2189
2190 Compatibility Notes
2191 -------------------
2192
2193 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2194   Apple targets.][apple-32bit-drop] This means that the source code is still
2195   available to build, but the targets are no longer being tested and release
2196   binaries for those platforms will no longer be distributed by the Rust project.
2197   Please refer to the linked blog post for more information.
2198
2199 [54733]: https://github.com/rust-lang/rust/pull/54733/
2200 [61351]: https://github.com/rust-lang/rust/pull/61351/
2201 [67255]: https://github.com/rust-lang/rust/pull/67255/
2202 [66661]: https://github.com/rust-lang/rust/pull/66661/
2203 [66771]: https://github.com/rust-lang/rust/pull/66771/
2204 [66847]: https://github.com/rust-lang/rust/pull/66847/
2205 [66238]: https://github.com/rust-lang/rust/pull/66238/
2206 [66277]: https://github.com/rust-lang/rust/pull/66277/
2207 [66325]: https://github.com/rust-lang/rust/pull/66325/
2208 [66172]: https://github.com/rust-lang/rust/pull/66172/
2209 [66183]: https://github.com/rust-lang/rust/pull/66183/
2210 [65879]: https://github.com/rust-lang/rust/pull/65879/
2211 [65013]: https://github.com/rust-lang/rust/pull/65013/
2212 [64882]: https://github.com/rust-lang/rust/pull/64882/
2213 [64325]: https://github.com/rust-lang/rust/pull/64325/
2214 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2215 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2216 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2217 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2218 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2219 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2220 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2221 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2222 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2223 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2224 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2225
2226 Version 1.40.0 (2019-12-19)
2227 ===========================
2228
2229 Language
2230 --------
2231 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2232   `const` contexts.][65188] e.g.
2233
2234   ```rust
2235   pub struct Point(i32, i32);
2236
2237   const ORIGIN: Point = {
2238       let constructor = Point;
2239
2240       constructor(0, 0)
2241   };
2242   ```
2243
2244 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2245   indicate that there may be variants or fields added in the future.][64639]
2246   For example this requires adding a wild-card branch (`_ => {}`) to any match
2247   statements on a non-exhaustive `enum`. [(RFC 2008)]
2248 - [You can now use function-like procedural macros in `extern` blocks and in
2249   type positions.][63931] e.g. `type Generated = macro!();`
2250 - [Function-like and attribute procedural macros can now emit
2251   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2252 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2253   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2254   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2255
2256 Compiler
2257 --------
2258 - [Added tier 3 support\* for the
2259   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2260 - [Added tier 3 support for the
2261   `aarch64-unknown-none-softfloat` target.][64589]
2262 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2263   `mips64el-unknown-linux-muslabi64` targets.][65843]
2264
2265 \* Refer to Rust's [platform support page][platform-support-doc] for more
2266   information on Rust's tiered platform support.
2267
2268 Libraries
2269 ---------
2270 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2271
2272 Stabilized APIs
2273 ---------------
2274 - [`BTreeMap::get_key_value`]
2275 - [`HashMap::get_key_value`]
2276 - [`Option::as_deref_mut`]
2277 - [`Option::as_deref`]
2278 - [`Option::flatten`]
2279 - [`UdpSocket::peer_addr`]
2280 - [`f32::to_be_bytes`]
2281 - [`f32::to_le_bytes`]
2282 - [`f32::to_ne_bytes`]
2283 - [`f64::to_be_bytes`]
2284 - [`f64::to_le_bytes`]
2285 - [`f64::to_ne_bytes`]
2286 - [`f32::from_be_bytes`]
2287 - [`f32::from_le_bytes`]
2288 - [`f32::from_ne_bytes`]
2289 - [`f64::from_be_bytes`]
2290 - [`f64::from_le_bytes`]
2291 - [`f64::from_ne_bytes`]
2292 - [`mem::take`]
2293 - [`slice::repeat`]
2294 - [`todo!`]
2295
2296 Cargo
2297 -----
2298 - [Cargo will now always display warnings, rather than only on
2299   fresh builds.][cargo/7450]
2300 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2301   now produce an error.][cargo/7507] Previously these flags were ignored.
2302 - [You can now publish `dev-dependencies` without including
2303   a `version`.][cargo/7333]
2304
2305 Misc
2306 ----
2307 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2308   when running documentation tests with `rustdoc`.][63803]
2309
2310 Compatibility Notes
2311 -------------------
2312 - [As previously announced, any previous NLL warnings in the 2015 edition are
2313   now hard errors.][64221]
2314 - [The `include!` macro will now warn if it failed to include the
2315   entire file.][64284] The `include!` macro unintentionally only includes the
2316   first _expression_ in a file, and this can be unintuitive. This will become
2317   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2318 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2319   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2320   or `extern` blocks now correctly emits a hard error.
2321
2322 [65294]: https://github.com/rust-lang/rust/pull/65294/
2323 [66103]: https://github.com/rust-lang/rust/pull/66103/
2324 [65843]: https://github.com/rust-lang/rust/pull/65843/
2325 [65188]: https://github.com/rust-lang/rust/pull/65188/
2326 [65092]: https://github.com/rust-lang/rust/pull/65092/
2327 [64589]: https://github.com/rust-lang/rust/pull/64589/
2328 [64639]: https://github.com/rust-lang/rust/pull/64639/
2329 [64221]: https://github.com/rust-lang/rust/pull/64221/
2330 [64284]: https://github.com/rust-lang/rust/pull/64284/
2331 [63931]: https://github.com/rust-lang/rust/pull/63931/
2332 [64035]: https://github.com/rust-lang/rust/pull/64035/
2333 [63674]: https://github.com/rust-lang/rust/pull/63674/
2334 [63803]: https://github.com/rust-lang/rust/pull/63803/
2335 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2336 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2337 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2338 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2339 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2340 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2341 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2342 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2343 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2344 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2345 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2346 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2347 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2348 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2349 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2350 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2351 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2352 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2353 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2354 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2355 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2356 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2357 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2358 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2359 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2360 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2361
2362
2363 Version 1.39.0 (2019-11-07)
2364 ===========================
2365
2366 Language
2367 --------
2368 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2369   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2370 - [You can now use certain attributes on function, closure, and function pointer
2371   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2372   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2373   attributes applied to items. e.g.
2374   ```rust
2375   fn len(
2376       #[cfg(windows)] slice: &[u16],
2377       #[cfg(not(windows))] slice: &[u8],
2378   ) -> usize {
2379       slice.len()
2380   }
2381   ```
2382 - [You can now take shared references to bind-by-move patterns in the `if` guards
2383   of `match` arms.][63118] e.g.
2384   ```rust
2385   fn main() {
2386       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2387
2388       match array {
2389           nums
2390   //      ---- `nums` is bound by move.
2391               if nums.iter().sum::<u8>() == 10
2392   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2393           => {
2394               drop(nums);
2395   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2396           }
2397           _ => unreachable!(),
2398       }
2399   }
2400   ```
2401
2402
2403
2404 Compiler
2405 --------
2406 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2407 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2408 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2409   **Note** Cargo currently doesn't use this feature. Refer to
2410   [cargo#7315][cargo/7315] to track this feature's progress.
2411 - [You can now pass `--show-output` argument to test binaries to print the
2412   output of successful tests.][62600]
2413
2414
2415 \* Refer to Rust's [platform support page][platform-support-doc] for more
2416 information on Rust's tiered platform support.
2417
2418 Libraries
2419 ---------
2420 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2421 - [`LinkedList::new` is now a `const` function.][63684]
2422 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2423 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2424   now `const`.][63786]
2425
2426 Stabilized APIs
2427 ---------------
2428 - [`Pin::into_inner`]
2429 - [`Instant::checked_duration_since`]
2430 - [`Instant::saturating_duration_since`]
2431
2432 Cargo
2433 -----
2434 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2435 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2436   `--all` is now deprecated.
2437
2438 Misc
2439 ----
2440 - [You can now pass `-Clinker` to rustdoc to control the linker used
2441   for compiling doctests.][63834]
2442
2443 Compatibility Notes
2444 -------------------
2445 - [Code that was previously accepted by the old borrow checker, but rejected by
2446   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2447   previously a warning, and will also become a hard error in the Rust 2015
2448   edition in the 1.40.0 release.
2449 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2450   run tests.][63827] This should improve performance when running a large
2451   amount of doctests.
2452 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2453   recommended to use the `?` operator instead.
2454 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2455   returned `0.0`.
2456
2457 [62600]: https://github.com/rust-lang/rust/pull/62600/
2458 [62672]: https://github.com/rust-lang/rust/pull/62672/
2459 [63118]: https://github.com/rust-lang/rust/pull/63118/
2460 [63209]: https://github.com/rust-lang/rust/pull/63209/
2461 [63402]: https://github.com/rust-lang/rust/pull/63402/
2462 [63565]: https://github.com/rust-lang/rust/pull/63565/
2463 [63595]: https://github.com/rust-lang/rust/pull/63595/
2464 [63684]: https://github.com/rust-lang/rust/pull/63684/
2465 [63698]: https://github.com/rust-lang/rust/pull/63698/
2466 [63770]: https://github.com/rust-lang/rust/pull/63770/
2467 [63786]: https://github.com/rust-lang/rust/pull/63786/
2468 [63827]: https://github.com/rust-lang/rust/pull/63827/
2469 [63834]: https://github.com/rust-lang/rust/pull/63834/
2470 [63927]: https://github.com/rust-lang/rust/pull/63927/
2471 [63933]: https://github.com/rust-lang/rust/pull/63933/
2472 [63934]: https://github.com/rust-lang/rust/pull/63934/
2473 [63938]: https://github.com/rust-lang/rust/pull/63938/
2474 [63940]: https://github.com/rust-lang/rust/pull/63940/
2475 [63941]: https://github.com/rust-lang/rust/pull/63941/
2476 [63945]: https://github.com/rust-lang/rust/pull/63945/
2477 [64010]: https://github.com/rust-lang/rust/pull/64010/
2478 [64028]: https://github.com/rust-lang/rust/pull/64028/
2479 [64334]: https://github.com/rust-lang/rust/pull/64334/
2480 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2481 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2482 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2483 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2484 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2485 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2486
2487 Version 1.38.0 (2019-09-26)
2488 ==========================
2489
2490 Language
2491 --------
2492 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2493 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2494
2495 Compiler
2496 --------
2497 - [Added pipelined compilation support to `rustc`.][62766] This will
2498   improve compilation times in some cases. For further information please refer
2499   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2500 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2501   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2502   `x86_64-uwp-windows-msvc` targets.][60260]
2503 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2504   `armv7-unknown-linux-musleabi` targets.][63107]
2505 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2506 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2507 - [Upgraded to LLVM 9.][62592]
2508
2509 \* Refer to Rust's [platform support page][platform-support-doc] for more
2510 information on Rust's tiered platform support.
2511
2512 Libraries
2513 ---------
2514 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2515 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2516   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2517   is available at `std::clone::Clone`). This also makes all built-in macros
2518   available in `std`/`core` root. e.g. `std::include_bytes!`.
2519 - [`str::Chars` now implements `Debug`.][63000]
2520 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2521 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2522 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2523 - [Added euclidean remainder and division operations (`div_euclid`,
2524   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2525   `overflowing`, and `wrapping` versions are available for all
2526   integer primitives.
2527 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2528   `PartialEq`.][61491]
2529 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2530
2531 Stabilized APIs
2532 ---------------
2533 - [`<*const T>::cast`]
2534 - [`<*mut T>::cast`]
2535 - [`Duration::as_secs_f32`]
2536 - [`Duration::as_secs_f64`]
2537 - [`Duration::div_f32`]
2538 - [`Duration::div_f64`]
2539 - [`Duration::from_secs_f32`]
2540 - [`Duration::from_secs_f64`]
2541 - [`Duration::mul_f32`]
2542 - [`Duration::mul_f64`]
2543 - [`any::type_name`]
2544
2545 Cargo
2546 -----
2547 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2548 - [You can now pass the `--features` option multiple times to enable
2549   multiple features.][cargo/7084]
2550
2551 Rustdoc
2552 -------
2553
2554 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2555
2556 Misc
2557 ----
2558 - [`rustc` will now warn about some incorrect uses of
2559   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2560
2561 Compatibility Notes
2562 -------------------
2563 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2564   1.38.0.
2565 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2566   issues][62896] with certain crates such as libc.
2567
2568 [60260]: https://github.com/rust-lang/rust/pull/60260/
2569 [61457]: https://github.com/rust-lang/rust/pull/61457/
2570 [61491]: https://github.com/rust-lang/rust/pull/61491/
2571 [61884]: https://github.com/rust-lang/rust/pull/61884/
2572 [61953]: https://github.com/rust-lang/rust/pull/61953/
2573 [62042]: https://github.com/rust-lang/rust/pull/62042/
2574 [62528]: https://github.com/rust-lang/rust/pull/62528/
2575 [62583]: https://github.com/rust-lang/rust/pull/62583/
2576 [62735]: https://github.com/rust-lang/rust/pull/62735/
2577 [62766]: https://github.com/rust-lang/rust/pull/62766/
2578 [62784]: https://github.com/rust-lang/rust/pull/62784/
2579 [62592]: https://github.com/rust-lang/rust/pull/62592/
2580 [62785]: https://github.com/rust-lang/rust/issues/62785/
2581 [62814]: https://github.com/rust-lang/rust/pull/62814/
2582 [62896]: https://github.com/rust-lang/rust/issues/62896/
2583 [63000]: https://github.com/rust-lang/rust/pull/63000/
2584 [63056]: https://github.com/rust-lang/rust/pull/63056/
2585 [63107]: https://github.com/rust-lang/rust/pull/63107/
2586 [63346]: https://github.com/rust-lang/rust/pull/63346/
2587 [63421]: https://github.com/rust-lang/rust/pull/63421/
2588 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2589 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2590 [63048]: https://github.com/rust-lang/rust/pull/63048
2591 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2592 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2593 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2594 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2595 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2596 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2597 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2598 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2599 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2600 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2601 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2602 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2603 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2604
2605 Version 1.37.0 (2019-08-15)
2606 ==========================
2607
2608 Language
2609 --------
2610 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2611   [`Box`][62228], or an [array][62235] and unused.
2612 - [You can now use the `cfg` and `cfg_attr` attributes on
2613   generic parameters.][61547]
2614 - [You can now use enum variants through type alias.][61682] e.g. You can
2615   write the following:
2616   ```rust
2617   type MyOption = Option<u8>;
2618
2619   fn increment_or_zero(x: MyOption) -> u8 {
2620       match x {
2621           MyOption::Some(y) => y + 1,
2622           MyOption::None => 0,
2623       }
2624   }
2625   ```
2626 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2627   `const _: u32 = 5;`.
2628 - [You can now use `#[repr(align(X)]` on enums.][61229]
2629 - [The  `?` Kleene macro operator is now available in the
2630   2015 edition.][60932]
2631
2632 Compiler
2633 --------
2634 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2635   and `-C profile-use` flags.][61268] For more information on how to use profile
2636   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2637 - [The `rust-lldb` wrapper script should now work again.][61827]
2638
2639 Libraries
2640 ---------
2641 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2642
2643 Stabilized APIs
2644 ---------------
2645 - [`BufReader::buffer`]
2646 - [`BufWriter::buffer`]
2647 - [`Cell::from_mut`]
2648 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2649 - [`DoubleEndedIterator::nth_back`]
2650 - [`Option::xor`]
2651 - [`Wrapping::reverse_bits`]
2652 - [`i128::reverse_bits`]
2653 - [`i16::reverse_bits`]
2654 - [`i32::reverse_bits`]
2655 - [`i64::reverse_bits`]
2656 - [`i8::reverse_bits`]
2657 - [`isize::reverse_bits`]
2658 - [`slice::copy_within`]
2659 - [`u128::reverse_bits`]
2660 - [`u16::reverse_bits`]
2661 - [`u32::reverse_bits`]
2662 - [`u64::reverse_bits`]
2663 - [`u8::reverse_bits`]
2664 - [`usize::reverse_bits`]
2665
2666 Cargo
2667 -----
2668 - [`Cargo.lock` files are now included by default when publishing executable crates
2669   with executables.][cargo/7026]
2670 - [You can now specify `default-run="foo"` in `[package]` to specify the
2671   default executable to use for `cargo run`.][cargo/7056]
2672
2673 Misc
2674 ----
2675
2676 Compatibility Notes
2677 -------------------
2678 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2679   Please transition your code to using the `..=` syntax for inclusive
2680   ranges instead.
2681 - [Using a trait object without the `dyn` will now warn by default.][61203]
2682   Please transition your code to use `dyn Trait` for trait objects instead.
2683
2684 [62228]: https://github.com/rust-lang/rust/pull/62228/
2685 [62235]: https://github.com/rust-lang/rust/pull/62235/
2686 [61802]: https://github.com/rust-lang/rust/pull/61802/
2687 [61827]: https://github.com/rust-lang/rust/pull/61827/
2688 [61547]: https://github.com/rust-lang/rust/pull/61547/
2689 [61682]: https://github.com/rust-lang/rust/pull/61682/
2690 [61268]: https://github.com/rust-lang/rust/pull/61268/
2691 [61342]: https://github.com/rust-lang/rust/pull/61342/
2692 [61347]: https://github.com/rust-lang/rust/pull/61347/
2693 [61100]: https://github.com/rust-lang/rust/pull/61100/
2694 [61203]: https://github.com/rust-lang/rust/pull/61203/
2695 [61229]: https://github.com/rust-lang/rust/pull/61229/
2696 [60932]: https://github.com/rust-lang/rust/pull/60932/
2697 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2698 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2699 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2700 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2701 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2702 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2703 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2704 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2705 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2706 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2707 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2708 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2709 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2710 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2711 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2712 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2713 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2714 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2715 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2716 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2717 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2718 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2719 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2720 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2721
2722
2723 Version 1.36.0 (2019-07-04)
2724 ==========================
2725
2726 Language
2727 --------
2728 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2729 - [The order of traits in trait objects no longer affects the semantics of that
2730   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2731   `dyn fmt::Debug + Send`, where this was previously not the case.
2732
2733 Libraries
2734 ---------
2735 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2736 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2737 - [`mem::needs_drop` is now available as a const fn.][60364]
2738 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2739 - [`String` now implements `BorrowMut<str>`.][60404]
2740 - [`io::Cursor` now implements `Default`.][60234]
2741 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2742 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2743   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2744   environment has access to heap memory allocation.
2745 - [`String` now implements `From<&String>`.][59825]
2746 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2747   return a tuple of each argument when there is multiple arguments.
2748 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2749   not used.][59648]
2750
2751 Stabilized APIs
2752 ---------------
2753 - [`VecDeque::rotate_left`]
2754 - [`VecDeque::rotate_right`]
2755 - [`Iterator::copied`]
2756 - [`io::IoSlice`]
2757 - [`io::IoSliceMut`]
2758 - [`Read::read_vectored`]
2759 - [`Write::write_vectored`]
2760 - [`str::as_mut_ptr`]
2761 - [`mem::MaybeUninit`]
2762 - [`pointer::align_offset`]
2763 - [`future::Future`]
2764 - [`task::Context`]
2765 - [`task::RawWaker`]
2766 - [`task::RawWakerVTable`]
2767 - [`task::Waker`]
2768 - [`task::Poll`]
2769
2770 Cargo
2771 -----
2772 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2773 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2774
2775 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2776
2777 Clippy
2778 ------
2779 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2780
2781 Misc
2782 ----
2783
2784 Compatibility Notes
2785 -------------------
2786 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2787   longer recommended, and will be deprecated in 1.39.0.
2788
2789 [60318]: https://github.com/rust-lang/rust/pull/60318/
2790 [60364]: https://github.com/rust-lang/rust/pull/60364/
2791 [60370]: https://github.com/rust-lang/rust/pull/60370/
2792 [60404]: https://github.com/rust-lang/rust/pull/60404/
2793 [60234]: https://github.com/rust-lang/rust/pull/60234/
2794 [60244]: https://github.com/rust-lang/rust/pull/60244/
2795 [58623]: https://github.com/rust-lang/rust/pull/58623/
2796 [59648]: https://github.com/rust-lang/rust/pull/59648/
2797 [59675]: https://github.com/rust-lang/rust/pull/59675/
2798 [59825]: https://github.com/rust-lang/rust/pull/59825/
2799 [59826]: https://github.com/rust-lang/rust/pull/59826/
2800 [59445]: https://github.com/rust-lang/rust/pull/59445/
2801 [59114]: https://github.com/rust-lang/rust/pull/59114/
2802 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2803 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2804 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2805 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2806 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2807 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2808 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2809 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2810 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2811 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2812 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2813 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2814 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2815 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2816 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2817 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2818 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2819 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2820 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2821 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2822
2823
2824 Version 1.35.0 (2019-05-23)
2825 ==========================
2826
2827 Language
2828 --------
2829 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2830   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2831 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2832   ```rust
2833   unsafe fn call_unsafe(func: unsafe fn()) {
2834       func()
2835   }
2836
2837   pub fn main() {
2838       unsafe { call_unsafe(|| {}); }
2839   }
2840   ```
2841
2842
2843 Compiler
2844 --------
2845 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2846   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2847 - [Added the `wasm32-unknown-wasi` target.][59464]
2848
2849
2850 Libraries
2851 ---------
2852 - [`Thread` will now show its ID in `Debug` output.][59460]
2853 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2854 - [`alloc::System` now implements `Default`.][59451]
2855 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2856   last field.][59076]
2857 - [`char::{ToLowercase, ToUppercase}` now
2858   implement `ExactSizeIterator`.][58778]
2859 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2860 - [Removed the `Read` trait bounds
2861   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2862 - [You can now call the `dbg!` macro without any parameters to print the file
2863   and line where it is called.][57847]
2864 - [In place ASCII case conversions are now up to 4× faster.][59283]
2865   e.g. `str::make_ascii_lowercase`
2866 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2867   and `Send`.][58369]
2868
2869 Stabilized APIs
2870 ---------------
2871 - [`f32::copysign`]
2872 - [`f64::copysign`]
2873 - [`RefCell::replace_with`]
2874 - [`RefCell::map_split`]
2875 - [`ptr::hash`]
2876 - [`Range::contains`]
2877 - [`RangeFrom::contains`]
2878 - [`RangeTo::contains`]
2879 - [`RangeInclusive::contains`]
2880 - [`RangeToInclusive::contains`]
2881 - [`Option::copied`]
2882
2883 Cargo
2884 -----
2885 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2886   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2887   platform specific.
2888
2889 Misc
2890 ----
2891 - [The Rust toolchain is now available natively for musl based distros.][58575]
2892
2893 [59460]: https://github.com/rust-lang/rust/pull/59460/
2894 [59464]: https://github.com/rust-lang/rust/pull/59464/
2895 [59500]: https://github.com/rust-lang/rust/pull/59500/
2896 [59512]: https://github.com/rust-lang/rust/pull/59512/
2897 [59580]: https://github.com/rust-lang/rust/pull/59580/
2898 [59283]: https://github.com/rust-lang/rust/pull/59283/
2899 [59451]: https://github.com/rust-lang/rust/pull/59451/
2900 [59076]: https://github.com/rust-lang/rust/pull/59076/
2901 [58778]: https://github.com/rust-lang/rust/pull/58778/
2902 [58717]: https://github.com/rust-lang/rust/pull/58717/
2903 [58369]: https://github.com/rust-lang/rust/pull/58369/
2904 [58423]: https://github.com/rust-lang/rust/pull/58423/
2905 [58080]: https://github.com/rust-lang/rust/pull/58080/
2906 [57847]: https://github.com/rust-lang/rust/pull/57847/
2907 [58575]: https://github.com/rust-lang/rust/pull/58575
2908 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2909 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2910 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2911 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2912 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2913 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2914 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2915 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2916 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2917 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2918 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2919 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2920
2921 Version 1.34.2 (2019-05-14)
2922 ===========================
2923
2924 * [Destabilize the `Error::type_id` function due to a security
2925    vulnerability][60785] ([CVE-2019-12083])
2926
2927 [60785]: https://github.com/rust-lang/rust/pull/60785
2928 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2929
2930 Version 1.34.1 (2019-04-25)
2931 ===========================
2932
2933 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2934 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2935 * [Fix Clippy panic when checking some macros][clippy/3805]
2936
2937 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2938 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2939 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2940
2941 Version 1.34.0 (2019-04-11)
2942 ==========================
2943
2944 Language
2945 --------
2946 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2947   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2948   but had no effect.
2949 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2950   `#[attr{}]` procedural macros.][57367]
2951 - [You can now write `extern crate self as foo;`][57407] to import your
2952   crate's root into the extern prelude.
2953
2954
2955 Compiler
2956 --------
2957 - [You can now target `riscv64imac-unknown-none-elf` and
2958   `riscv64gc-unknown-none-elf`.][58406]
2959 - [You can now enable linker plugin LTO optimisations with
2960   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2961   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2962   boundaries.
2963 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2964
2965
2966 Libraries
2967 ---------
2968 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2969   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2970   the `Hash` trait to create an iterator.
2971 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2972   methods.][58421] Most notably you no longer require the `Ord` trait to create
2973   an iterator.
2974 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2975   for all numeric types.][58044]
2976 - [Indexing a `str` is now generic over all types that
2977   implement `SliceIndex<str>`.][57604]
2978 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2979   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2980   produce a warning if their returning type is unused.
2981 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2982   `overflowing_pow` are now available for all numeric types.][57873] These are
2983   equivalent to methods such as `wrapping_add` for the `pow` operation.
2984
2985
2986 Stabilized APIs
2987 ---------------
2988
2989 #### std & core
2990 * [`Any::type_id`]
2991 * [`Error::type_id`]
2992 * [`atomic::AtomicI16`]
2993 * [`atomic::AtomicI32`]
2994 * [`atomic::AtomicI64`]
2995 * [`atomic::AtomicI8`]
2996 * [`atomic::AtomicU16`]
2997 * [`atomic::AtomicU32`]
2998 * [`atomic::AtomicU64`]
2999 * [`atomic::AtomicU8`]
3000 * [`convert::Infallible`]
3001 * [`convert::TryFrom`]
3002 * [`convert::TryInto`]
3003 * [`iter::from_fn`]
3004 * [`iter::successors`]
3005 * [`num::NonZeroI128`]
3006 * [`num::NonZeroI16`]
3007 * [`num::NonZeroI32`]
3008 * [`num::NonZeroI64`]
3009 * [`num::NonZeroI8`]
3010 * [`num::NonZeroIsize`]
3011 * [`slice::sort_by_cached_key`]
3012 * [`str::escape_debug`]
3013 * [`str::escape_default`]
3014 * [`str::escape_unicode`]
3015 * [`str::split_ascii_whitespace`]
3016
3017 #### std
3018 * [`Instant::checked_add`]
3019 * [`Instant::checked_sub`]
3020 * [`SystemTime::checked_add`]
3021 * [`SystemTime::checked_sub`]
3022
3023 Cargo
3024 -----
3025 - [You can now use alternative registries to crates.io.][cargo/6654]
3026
3027 Misc
3028 ----
3029 - [You can now use the `?` operator in your documentation tests without manually
3030   adding `fn main() -> Result<(), _> {}`.][56470]
3031
3032 Compatibility Notes
3033 -------------------
3034 - [`Command::before_exec` is being replaced by the unsafe method
3035   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3036 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3037   can now use `const` functions in `static` variables.
3038
3039 [58370]: https://github.com/rust-lang/rust/pull/58370/
3040 [58406]: https://github.com/rust-lang/rust/pull/58406/
3041 [58421]: https://github.com/rust-lang/rust/pull/58421/
3042 [58166]: https://github.com/rust-lang/rust/pull/58166/
3043 [58044]: https://github.com/rust-lang/rust/pull/58044/
3044 [58057]: https://github.com/rust-lang/rust/pull/58057/
3045 [58059]: https://github.com/rust-lang/rust/pull/58059/
3046 [57809]: https://github.com/rust-lang/rust/pull/57809/
3047 [57873]: https://github.com/rust-lang/rust/pull/57873/
3048 [57604]: https://github.com/rust-lang/rust/pull/57604/
3049 [57367]: https://github.com/rust-lang/rust/pull/57367/
3050 [57407]: https://github.com/rust-lang/rust/pull/57407/
3051 [57425]: https://github.com/rust-lang/rust/pull/57425/
3052 [57106]: https://github.com/rust-lang/rust/pull/57106/
3053 [56470]: https://github.com/rust-lang/rust/pull/56470/
3054 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3055 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3056 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3057 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3058 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3059 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3060 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3061 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3062 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3063 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3064 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3065 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3066 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3067 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3068 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3069 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3070 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3071 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3072 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3073 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3074 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3075 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3076 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3077 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3078 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3079 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3080 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3081 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3082 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3083 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3084 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3085
3086
3087 Version 1.33.0 (2019-02-28)
3088 ==========================
3089
3090 Language
3091 --------
3092 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3093   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3094 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3095   E.g. You can have match statement on a `u8` that covers `0..=255` and
3096   you would no longer be required to have a `_ => unreachable!()` case.
3097 - [You can now have multiple patterns in `if let` and `while let`
3098   expressions.][57532] You can do this with the same syntax as a `match`
3099   expression. E.g.
3100   ```rust
3101   enum Creature {
3102       Crab(String),
3103       Lobster(String),
3104       Person(String),
3105   }
3106
3107   fn main() {
3108       let state = Creature::Crab("Ferris");
3109
3110       if let Creature::Crab(name) | Creature::Person(name) = state {
3111           println!("This creature's name is: {}", name);
3112       }
3113   }
3114   ```
3115 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3116   this feature will by default produce a warning as this behaviour can be
3117   unintuitive. E.g. `if let _ = 5 {}`
3118 - [You can now use `let` bindings, assignments, expression statements,
3119   and irrefutable pattern destructuring in const functions.][57175]
3120 - [You can now call unsafe const functions.][57067] E.g.
3121   ```rust
3122   const unsafe fn foo() -> i32 { 5 }
3123   const fn bar() -> i32 {
3124       unsafe { foo() }
3125   }
3126   ```
3127 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3128   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3129 - [You can now specify a specific alignment with the `#[repr(packed)]`
3130   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3131   with an alignment of 2 bytes and a size of 6 bytes.
3132 - [You can now import an item from a module as an `_`.][56303] This allows you to
3133   import a trait's impls, and not have the name in the namespace. E.g.
3134   ```rust
3135   use std::io::Read as _;
3136
3137   // Allowed as there is only one `Read` in the module.
3138   pub trait Read {}
3139   ```
3140 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3141
3142 Compiler
3143 --------
3144 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3145   command line argument.][56351]
3146 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3147 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3148 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3149   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3150   information on Rust's platform support.
3151 - [Added support for the `thumbv7neon-linux-androideabi` and
3152   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3153 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3154
3155 Libraries
3156 ---------
3157 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3158   functions for all numeric types.][57566]
3159 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3160   are now `const` functions for all numeric types.][57105]
3161 - [The methods `is_positive` and `is_negative` are now `const` functions for
3162   all signed numeric types.][57105]
3163 - [The `get` method for all `NonZero` types is now `const`.][57167]
3164 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3165   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3166   numeric types.][57234]
3167 - [`Ipv4Addr::new` is now a `const` function][57234]
3168
3169 Stabilized APIs
3170 ---------------
3171 - [`unix::FileExt::read_exact_at`]
3172 - [`unix::FileExt::write_all_at`]
3173 - [`Option::transpose`]
3174 - [`Result::transpose`]
3175 - [`convert::identity`]
3176 - [`pin::Pin`]
3177 - [`marker::Unpin`]
3178 - [`marker::PhantomPinned`]
3179 - [`Vec::resize_with`]
3180 - [`VecDeque::resize_with`]
3181 - [`Duration::as_millis`]
3182 - [`Duration::as_micros`]
3183 - [`Duration::as_nanos`]
3184
3185
3186 Cargo
3187 -----
3188 - [You can now publish crates that require a feature flag to compile with
3189   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3190 - [Cargo should now rebuild a crate if a file was modified during the initial
3191   build.][cargo/6484]
3192
3193 Compatibility Notes
3194 -------------------
3195 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3196   are now deprecated in the standard library, and their usage will now produce a warning.
3197   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3198   methods instead.
3199 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3200   downcasting.
3201 - [Libtest no longer creates a new thread for each test when
3202   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3203
3204 [55982]: https://github.com/rust-lang/rust/pull/55982/
3205 [56243]: https://github.com/rust-lang/rust/pull/56243
3206 [56303]: https://github.com/rust-lang/rust/pull/56303/
3207 [56351]: https://github.com/rust-lang/rust/pull/56351/
3208 [56362]: https://github.com/rust-lang/rust/pull/56362
3209 [56642]: https://github.com/rust-lang/rust/pull/56642/
3210 [56769]: https://github.com/rust-lang/rust/pull/56769/
3211 [56805]: https://github.com/rust-lang/rust/pull/56805
3212 [56947]: https://github.com/rust-lang/rust/pull/56947/
3213 [57049]: https://github.com/rust-lang/rust/pull/57049/
3214 [57067]: https://github.com/rust-lang/rust/pull/57067/
3215 [57105]: https://github.com/rust-lang/rust/pull/57105
3216 [57130]: https://github.com/rust-lang/rust/pull/57130/
3217 [57167]: https://github.com/rust-lang/rust/pull/57167/
3218 [57175]: https://github.com/rust-lang/rust/pull/57175/
3219 [57234]: https://github.com/rust-lang/rust/pull/57234/
3220 [57332]: https://github.com/rust-lang/rust/pull/57332/
3221 [57465]: https://github.com/rust-lang/rust/pull/57465/
3222 [57532]: https://github.com/rust-lang/rust/pull/57532/
3223 [57535]: https://github.com/rust-lang/rust/pull/57535/
3224 [57566]: https://github.com/rust-lang/rust/pull/57566/
3225 [57615]: https://github.com/rust-lang/rust/pull/57615/
3226 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3227 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3228 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3229 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3230 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3231 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3232 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3233 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3234 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3235 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3236 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3237 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3238 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3239 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3240 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3241 [platform-support]: https://forge.rust-lang.org/platform-support.html
3242
3243 Version 1.32.0 (2019-01-17)
3244 ==========================
3245
3246 Language
3247 --------
3248 #### 2018 edition
3249 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3250   operator allows you to specify zero or one repetitions similar to the `*` and
3251   `+` operators.
3252 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3253   now always resolve to the item (`enum`, `struct`, etc.) available in the
3254   module if present, before resolving to a external crate or an item the prelude.][56759]
3255   E.g.
3256   ```rust
3257   enum Color { Red, Green, Blue }
3258
3259   use Color::*;
3260   ```
3261
3262 #### All editions
3263 - [You can now match against `PhantomData<T>` types.][55837]
3264 - [You can now match against literals in macros with the `literal`
3265   specifier.][56072] This will match against a literal of any type.
3266   E.g. `1`, `'A'`, `"Hello World"`
3267 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3268   ```rust
3269   struct Point(i32, i32);
3270
3271   impl Point {
3272       pub fn new(x: i32, y: i32) -> Self {
3273           Self(x, y)
3274       }
3275
3276       pub fn is_origin(&self) -> bool {
3277           match self {
3278               Self(0, 0) => true,
3279               _ => false,
3280           }
3281       }
3282   }
3283   ```
3284 - [Self can also now be used in type definitions.][56366] E.g.
3285   ```rust
3286   enum List<T>
3287   where
3288       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3289   {
3290       Nil,
3291       Cons(T, Box<Self>) // likewise here
3292   }
3293   ```
3294 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3295   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3296
3297 Compiler
3298 --------
3299 - [The default allocator has changed from jemalloc to the default allocator on
3300   your system.][55238] The compiler itself on Linux & macOS will still use
3301   jemalloc, but programs compiled with it will use the system allocator.
3302 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3303
3304 Libraries
3305 ---------
3306 - [`PathBuf` now implements `FromStr`.][55148]
3307 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3308 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3309   easily debug expressions in your rust program. E.g.
3310   ```rust
3311   let a = 2;
3312   let b = dbg!(a * 2) + 1;
3313   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3314   assert_eq!(b, 5);
3315   ```
3316
3317 The following APIs are now `const` functions and can be used in a
3318 `const` context.
3319
3320 - [`Cell::as_ptr`]
3321 - [`UnsafeCell::get`]
3322 - [`char::is_ascii`]
3323 - [`iter::empty`]
3324 - [`ManuallyDrop::new`]
3325 - [`ManuallyDrop::into_inner`]
3326 - [`RangeInclusive::start`]
3327 - [`RangeInclusive::end`]
3328 - [`NonNull::as_ptr`]
3329 - [`slice::as_ptr`]
3330 - [`str::as_ptr`]
3331 - [`Duration::as_secs`]
3332 - [`Duration::subsec_millis`]
3333 - [`Duration::subsec_micros`]
3334 - [`Duration::subsec_nanos`]
3335 - [`CStr::as_ptr`]
3336 - [`Ipv4Addr::is_unspecified`]
3337 - [`Ipv6Addr::new`]
3338 - [`Ipv6Addr::octets`]
3339
3340 Stabilized APIs
3341 ---------------
3342 - [`i8::to_be_bytes`]
3343 - [`i8::to_le_bytes`]
3344 - [`i8::to_ne_bytes`]
3345 - [`i8::from_be_bytes`]
3346 - [`i8::from_le_bytes`]
3347 - [`i8::from_ne_bytes`]
3348 - [`i16::to_be_bytes`]
3349 - [`i16::to_le_bytes`]
3350 - [`i16::to_ne_bytes`]
3351 - [`i16::from_be_bytes`]
3352 - [`i16::from_le_bytes`]
3353 - [`i16::from_ne_bytes`]
3354 - [`i32::to_be_bytes`]
3355 - [`i32::to_le_bytes`]
3356 - [`i32::to_ne_bytes`]
3357 - [`i32::from_be_bytes`]
3358 - [`i32::from_le_bytes`]
3359 - [`i32::from_ne_bytes`]
3360 - [`i64::to_be_bytes`]
3361 - [`i64::to_le_bytes`]
3362 - [`i64::to_ne_bytes`]
3363 - [`i64::from_be_bytes`]
3364 - [`i64::from_le_bytes`]
3365 - [`i64::from_ne_bytes`]
3366 - [`i128::to_be_bytes`]
3367 - [`i128::to_le_bytes`]
3368 - [`i128::to_ne_bytes`]
3369 - [`i128::from_be_bytes`]
3370 - [`i128::from_le_bytes`]
3371 - [`i128::from_ne_bytes`]
3372 - [`isize::to_be_bytes`]
3373 - [`isize::to_le_bytes`]
3374 - [`isize::to_ne_bytes`]
3375 - [`isize::from_be_bytes`]
3376 - [`isize::from_le_bytes`]
3377 - [`isize::from_ne_bytes`]
3378 - [`u8::to_be_bytes`]
3379 - [`u8::to_le_bytes`]
3380 - [`u8::to_ne_bytes`]
3381 - [`u8::from_be_bytes`]
3382 - [`u8::from_le_bytes`]
3383 - [`u8::from_ne_bytes`]
3384 - [`u16::to_be_bytes`]
3385 - [`u16::to_le_bytes`]
3386 - [`u16::to_ne_bytes`]
3387 - [`u16::from_be_bytes`]
3388 - [`u16::from_le_bytes`]
3389 - [`u16::from_ne_bytes`]
3390 - [`u32::to_be_bytes`]
3391 - [`u32::to_le_bytes`]
3392 - [`u32::to_ne_bytes`]
3393 - [`u32::from_be_bytes`]
3394 - [`u32::from_le_bytes`]
3395 - [`u32::from_ne_bytes`]
3396 - [`u64::to_be_bytes`]
3397 - [`u64::to_le_bytes`]
3398 - [`u64::to_ne_bytes`]
3399 - [`u64::from_be_bytes`]
3400 - [`u64::from_le_bytes`]
3401 - [`u64::from_ne_bytes`]
3402 - [`u128::to_be_bytes`]
3403 - [`u128::to_le_bytes`]
3404 - [`u128::to_ne_bytes`]
3405 - [`u128::from_be_bytes`]
3406 - [`u128::from_le_bytes`]
3407 - [`u128::from_ne_bytes`]
3408 - [`usize::to_be_bytes`]
3409 - [`usize::to_le_bytes`]
3410 - [`usize::to_ne_bytes`]
3411 - [`usize::from_be_bytes`]
3412 - [`usize::from_le_bytes`]
3413 - [`usize::from_ne_bytes`]
3414
3415 Cargo
3416 -----
3417 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3418 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3419
3420 Misc
3421 ----
3422 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3423
3424 Compatibility Notes
3425 -------------------
3426 - [The argument types for AVX's
3427   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3428   been changed from `*const` to `*mut` as the previous implementation
3429   was unsound.
3430
3431
3432 [55148]: https://github.com/rust-lang/rust/pull/55148/
3433 [55238]: https://github.com/rust-lang/rust/pull/55238/
3434 [55280]: https://github.com/rust-lang/rust/pull/55280/
3435 [55610]: https://github.com/rust-lang/rust/pull/55610/
3436 [55663]: https://github.com/rust-lang/rust/pull/55663/
3437 [55702]: https://github.com/rust-lang/rust/pull/55702/
3438 [55837]: https://github.com/rust-lang/rust/pull/55837/
3439 [55843]: https://github.com/rust-lang/rust/pull/55843/
3440 [56072]: https://github.com/rust-lang/rust/pull/56072/
3441 [56245]: https://github.com/rust-lang/rust/pull/56245/
3442 [56365]: https://github.com/rust-lang/rust/pull/56365/
3443 [56366]: https://github.com/rust-lang/rust/pull/56366/
3444 [56395]: https://github.com/rust-lang/rust/pull/56395/
3445 [56759]: https://github.com/rust-lang/rust/pull/56759/
3446 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3447 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3448 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3449 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3450 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3451 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3452 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3453 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3454 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3455 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3456 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3457 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3458 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3459 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3460 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3461 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3462 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3463 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3464 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3465 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3466 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3467 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3468 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3469 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3470 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3471 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3472 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3473 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3474 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3475 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3476 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3477 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3478 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3479 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3480 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3481 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3482 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3483 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3484 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3485 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3486 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3487 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3488 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3489 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3490 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3491 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3492 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3493 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3494 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3495 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3496 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3497 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3498 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3499 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3500 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3501 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3502 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3503 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3504 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3505 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3506 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3507 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3508 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3509 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3510 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3511 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3512 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3513 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3514 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3515 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3516 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3517 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3518 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3519 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3520 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3521 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3522 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3523 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3524 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3525 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3526 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3527 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3528 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3529 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3530 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3531 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3532 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3533 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3534 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3535 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3536 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3537 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3538 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3539
3540
3541 Version 1.31.1 (2018-12-20)
3542 ===========================
3543
3544 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3545 - [Fix broken go-to-definition in RLS][rls/1171]
3546 - [Fix infinite loop on hover in RLS][rls/1170]
3547
3548 [56562]: https://github.com/rust-lang/rust/pull/56562
3549 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3550 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3551
3552 Version 1.31.0 (2018-12-06)
3553 ==========================
3554
3555 Language
3556 --------
3557 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3558 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3559   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3560   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3561   in structs.
3562 - [You can now define and use `const` functions.][54835] These are currently
3563   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3564   [language reference][const-reference] for what exactly is available.
3565 - [You can now use tool lints, which allow you to scope lints from external
3566   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3567 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3568   a crate, not just in exported functions.][54451]
3569 - [You can now use parentheses in pattern matches.][54497]
3570
3571 Compiler
3572 --------
3573 - [Updated musl to 1.1.20][54430]
3574
3575 Libraries
3576 ---------
3577 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3578   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3579 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3580   into `Option<&mut T>` using the `From` trait.][53218]
3581 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3582
3583
3584 Stabilized APIs
3585 ---------------
3586 - [`slice::align_to`]
3587 - [`slice::align_to_mut`]
3588 - [`slice::chunks_exact`]
3589 - [`slice::chunks_exact_mut`]
3590 - [`slice::rchunks`]
3591 - [`slice::rchunks_mut`]
3592 - [`slice::rchunks_exact`]
3593 - [`slice::rchunks_exact_mut`]
3594 - [`Option::replace`]
3595
3596 Cargo
3597 -----
3598 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3599 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3600   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3601
3602 [52813]: https://github.com/rust-lang/rust/pull/52813/
3603 [53218]: https://github.com/rust-lang/rust/pull/53218/
3604 [53555]: https://github.com/rust-lang/rust/issues/53555/
3605 [54057]: https://github.com/rust-lang/rust/pull/54057/
3606 [54240]: https://github.com/rust-lang/rust/pull/54240/
3607 [54430]: https://github.com/rust-lang/rust/pull/54430/
3608 [54451]: https://github.com/rust-lang/rust/pull/54451/
3609 [54497]: https://github.com/rust-lang/rust/pull/54497/
3610 [54778]: https://github.com/rust-lang/rust/pull/54778/
3611 [54835]: https://github.com/rust-lang/rust/pull/54835/
3612 [54870]: https://github.com/rust-lang/rust/pull/54870/
3613 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3614 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3615 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3616 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3617 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3618 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3619 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3620 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3621 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3622 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3623 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3624 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3625 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3626 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3627
3628 Version 1.30.1 (2018-11-08)
3629 ===========================
3630
3631 - [Fixed overflow ICE in rustdoc][54199]
3632 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3633
3634 [54199]: https://github.com/rust-lang/rust/pull/54199
3635 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3636
3637 Version 1.30.0 (2018-10-25)
3638 ==========================
3639
3640 Language
3641 --------
3642 - [Procedural macros are now available.][52081] These kinds of macros allow for
3643   more powerful code generation. There is a [new chapter available][proc-macros]
3644   in the Rust Programming Language book that goes further in depth.
3645 - [You can now use keywords as identifiers using the raw identifiers
3646   syntax (`r#`),][53236] e.g. `let r#for = true;`
3647 - [Using anonymous parameters in traits is now deprecated with a warning and
3648   will be a hard error in the 2018 edition.][53272]
3649 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3650   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3651 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3652   Previously, using a external crate in a module without a use statement
3653   required `let json = ::serde_json::from_str(foo);` but can now be written
3654   as `let json = serde_json::from_str(foo);`.
3655 - [You can now apply the `#[used]` attribute to static items to prevent the
3656   compiler from optimising them away, even if they appear to be unused,][51363]
3657   e.g. `#[used] static FOO: u32 = 1;`
3658 - [You can now import and reexport macros from other crates with the `use`
3659   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3660   the root module of the crate. If your macro relies on calling other local
3661   macros, it is recommended to export with the
3662   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3663   those macros.
3664 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3665   using the `vis` specifier.][53370]
3666 - [Non-macro attributes now allow all forms of literals, not just
3667   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3668   write `#[attr(true)]`.
3669 - [You can now specify a function to handle a panic in the Rust runtime with the
3670   `#[panic_handler]` attribute.][51366]
3671
3672 Compiler
3673 --------
3674 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3675 - [Added the `aarch64-unknown-netbsd` target][53165]
3676 - [Upgraded to LLVM 8.][53611]
3677
3678 Libraries
3679 ---------
3680 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3681
3682 Stabilized APIs
3683 ---------------
3684 - [`Ipv4Addr::BROADCAST`]
3685 - [`Ipv4Addr::LOCALHOST`]
3686 - [`Ipv4Addr::UNSPECIFIED`]
3687 - [`Ipv6Addr::LOCALHOST`]
3688 - [`Ipv6Addr::UNSPECIFIED`]
3689 - [`Iterator::find_map`]
3690
3691   The following methods are replacement methods for `trim_left`, `trim_right`,
3692   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3693   in 1.33.0:
3694 - [`str::trim_end_matches`]
3695 - [`str::trim_end`]
3696 - [`str::trim_start_matches`]
3697 - [`str::trim_start`]
3698
3699 Cargo
3700 ----
3701 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3702 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3703   equivalent to calling `rustdoc --error-format=json`.
3704 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3705
3706 Misc
3707 ----
3708 - [`rustdoc` allows you to specify what edition to treat your code as with the
3709   `--edition` option.][54057]
3710 - [`rustdoc` now has the `--color` (specify whether to output color) and
3711   `--error-format` (specify error format, e.g. `json`) options.][53003]
3712 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3713   debug symbols.][53774]
3714 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3715   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3716
3717 [50911]: https://github.com/rust-lang/rust/pull/50911/
3718 [51363]: https://github.com/rust-lang/rust/pull/51363/
3719 [51366]: https://github.com/rust-lang/rust/pull/51366/
3720 [52081]: https://github.com/rust-lang/rust/pull/52081/
3721 [53003]: https://github.com/rust-lang/rust/pull/53003/
3722 [53033]: https://github.com/rust-lang/rust/pull/53033/
3723 [53044]: https://github.com/rust-lang/rust/pull/53044/
3724 [53165]: https://github.com/rust-lang/rust/pull/53165/
3725 [53611]: https://github.com/rust-lang/rust/pull/53611/
3726 [53213]: https://github.com/rust-lang/rust/pull/53213/
3727 [53236]: https://github.com/rust-lang/rust/pull/53236/
3728 [53272]: https://github.com/rust-lang/rust/pull/53272/
3729 [53370]: https://github.com/rust-lang/rust/pull/53370/
3730 [53459]: https://github.com/rust-lang/rust/pull/53459/
3731 [53774]: https://github.com/rust-lang/rust/pull/53774/
3732 [53822]: https://github.com/rust-lang/rust/pull/53822/
3733 [54057]: https://github.com/rust-lang/rust/pull/54057/
3734 [54146]: https://github.com/rust-lang/rust/pull/54146/
3735 [54404]: https://github.com/rust-lang/rust/pull/54404/
3736 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3737 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3738 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3739 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3740
3741 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3742 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3743 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3744 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3745 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3746 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3747 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3748 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3749 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3750 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3751
3752
3753 Version 1.29.2 (2018-10-11)
3754 ===========================
3755
3756 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3757 - The `rls-preview` component on the windows-gnu targets has been restored.
3758
3759 [54639]: https://github.com/rust-lang/rust/pull/54639
3760
3761
3762 Version 1.29.1 (2018-09-25)
3763 ===========================
3764
3765 Security Notes
3766 --------------
3767
3768 - The standard library's `str::repeat` function contained an out of bounds write
3769   caused by an integer overflow. This has been fixed by deterministically
3770   panicking when an overflow happens.
3771
3772   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3773   us.
3774
3775
3776 Version 1.29.0 (2018-09-13)
3777 ==========================
3778
3779 Compiler
3780 --------
3781 - [Bumped minimum LLVM version to 5.0.][51899]
3782 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3783 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3784 - [Upgraded to LLVM 7.][51966]
3785
3786 Libraries
3787 ---------
3788 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3789 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3790 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3791 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3792   for `&str`.][51178]
3793 - [`Cell<T>` now allows `T` to be unsized.][50494]
3794 - [`SocketAddr` is now stable on Redox.][52656]
3795
3796 Stabilized APIs
3797 ---------------
3798 - [`Arc::downcast`]
3799 - [`Iterator::flatten`]
3800 - [`Rc::downcast`]
3801
3802 Cargo
3803 -----
3804 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3805   `--locked` to disable this behavior.
3806 - [`cargo-install` will now allow you to cross compile an install
3807   using `--target`.][cargo/5614]
3808 - [Added the `cargo-fix` subcommand to automatically move project code from
3809   2015 edition to 2018.][cargo/5723]
3810 - [`cargo doc` can now optionally document private types using the
3811   `--document-private-items` flag.][cargo/5543]
3812
3813 Misc
3814 ----
3815 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3816   the specified level to that level.][52354] For example `--cap-lints warn`
3817   will demote `deny` and `forbid` lints to `warn`.
3818 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3819   fails and `101` if there is a panic.][52197]
3820 - [A preview of clippy has been made available through rustup.][51122]
3821   You can install the preview with `rustup component add clippy-preview`.
3822
3823 Compatibility Notes
3824 -------------------
3825 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3826   Use `str::get_unchecked(begin..end)` instead.
3827 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3828   Consider using the `home_dir` function from
3829   https://crates.io/crates/dirs instead.
3830 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3831 - [`cfg` attributes and `--cfg` command line flags are now more
3832   strictly validated.][53893]
3833
3834 [53893]: https://github.com/rust-lang/rust/pull/53893/
3835 [52861]: https://github.com/rust-lang/rust/pull/52861/
3836 [51966]: https://github.com/rust-lang/rust/pull/51966/
3837 [52656]: https://github.com/rust-lang/rust/pull/52656/
3838 [52239]: https://github.com/rust-lang/rust/pull/52239/
3839 [52330]: https://github.com/rust-lang/rust/pull/52330/
3840 [52354]: https://github.com/rust-lang/rust/pull/52354/
3841 [52402]: https://github.com/rust-lang/rust/pull/52402/
3842 [52103]: https://github.com/rust-lang/rust/pull/52103/
3843 [52197]: https://github.com/rust-lang/rust/pull/52197/
3844 [51807]: https://github.com/rust-lang/rust/pull/51807/
3845 [51899]: https://github.com/rust-lang/rust/pull/51899/
3846 [51912]: https://github.com/rust-lang/rust/pull/51912/
3847 [51511]: https://github.com/rust-lang/rust/pull/51511/
3848 [51619]: https://github.com/rust-lang/rust/pull/51619/
3849 [51656]: https://github.com/rust-lang/rust/pull/51656/
3850 [51178]: https://github.com/rust-lang/rust/pull/51178/
3851 [51122]: https://github.com/rust-lang/rust/pull/51122
3852 [50494]: https://github.com/rust-lang/rust/pull/50494/
3853 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3854 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3855 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3856 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3857 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3858 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3859 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3860
3861
3862 Version 1.28.0 (2018-08-02)
3863 ===========================
3864
3865 Language
3866 --------
3867 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3868   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3869   the inner type across Foreign Function Interface (FFI) boundaries.
3870 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3871   and can now be used as identifiers.][51196]
3872 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3873   stable.][51241] This will allow users to specify a global allocator for
3874   their program.
3875 - [Unit test functions marked with the `#[test]` attribute can now return
3876   `Result<(), E: Debug>` in addition to `()`.][51298]
3877 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3878   allows macros to easily target lifetimes.
3879
3880 Compiler
3881 --------
3882 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3883   prioritise making smaller binary sizes. `z` is the same as `s` with the
3884   exception that it does not vectorise loops, which typically results in an even
3885   smaller binary.
3886 - [The short error format is now stable.][49546] Specified with
3887   `--error-format=short` this option will provide a more compressed output of
3888   rust error messages.
3889 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3890 - [Reduced the number of allocations in the macro parser.][50855] This can
3891   improve compile times of macro heavy crates on average by 5%.
3892
3893 Libraries
3894 ---------
3895 - [Implemented `Default` for `&mut str`.][51306]
3896 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3897 - [Implemented `Extend` for `()`.][50234]
3898 - [The `Debug` implementation of `time::Duration` should now be more easily
3899   human readable.][50364] Previously a `Duration` of one second would printed as
3900   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3901 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3902   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3903   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3904   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3905   for `PathBuf`.][50170]
3906 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3907   and `Wrapping<i128>`.][50465]
3908 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3909   possible.][51050] This can provide up to a 40% speed increase.
3910 - [Improved error messages when using `format!`.][50610]
3911
3912 Stabilized APIs
3913 ---------------
3914 - [`Iterator::step_by`]
3915 - [`Path::ancestors`]
3916 - [`SystemTime::UNIX_EPOCH`]
3917 - [`alloc::GlobalAlloc`]
3918 - [`alloc::Layout`]
3919 - [`alloc::LayoutErr`]
3920 - [`alloc::System`]
3921 - [`alloc::alloc`]
3922 - [`alloc::alloc_zeroed`]
3923 - [`alloc::dealloc`]
3924 - [`alloc::realloc`]
3925 - [`alloc::handle_alloc_error`]
3926 - [`btree_map::Entry::or_default`]
3927 - [`fmt::Alignment`]
3928 - [`hash_map::Entry::or_default`]
3929 - [`iter::repeat_with`]
3930 - [`num::NonZeroUsize`]
3931 - [`num::NonZeroU128`]
3932 - [`num::NonZeroU16`]
3933 - [`num::NonZeroU32`]
3934 - [`num::NonZeroU64`]
3935 - [`num::NonZeroU8`]
3936 - [`ops::RangeBounds`]
3937 - [`slice::SliceIndex`]
3938 - [`slice::from_mut`]
3939 - [`slice::from_ref`]
3940 - [`{Any + Send + Sync}::downcast_mut`]
3941 - [`{Any + Send + Sync}::downcast_ref`]
3942 - [`{Any + Send + Sync}::is`]
3943
3944 Cargo
3945 -----
3946 - [Cargo will now no longer allow you to publish crates with build scripts that
3947   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3948   considered to be immutable.
3949
3950 Misc
3951 ----
3952 - [The `suggestion_applicability` field in `rustc`'s json output is now
3953   stable.][50486] This will allow dev tools to check whether a code suggestion
3954   would apply to them.
3955
3956 Compatibility Notes
3957 -------------------
3958 - [Rust will consider trait objects with duplicated constraints to be the same
3959   type as without the duplicated constraint.][51276] For example the below code will
3960   now fail to compile.
3961   ```rust
3962   trait Trait {}
3963
3964   impl Trait + Send {
3965       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3966   }
3967
3968   impl Trait + Send + Send {
3969       fn test(&self) { println!("two"); }
3970   }
3971   ```
3972
3973 [49546]: https://github.com/rust-lang/rust/pull/49546/
3974 [50143]: https://github.com/rust-lang/rust/pull/50143/
3975 [50170]: https://github.com/rust-lang/rust/pull/50170/
3976 [50234]: https://github.com/rust-lang/rust/pull/50234/
3977 [50265]: https://github.com/rust-lang/rust/pull/50265/
3978 [50364]: https://github.com/rust-lang/rust/pull/50364/
3979 [50385]: https://github.com/rust-lang/rust/pull/50385/
3980 [50465]: https://github.com/rust-lang/rust/pull/50465/
3981 [50486]: https://github.com/rust-lang/rust/pull/50486/
3982 [50554]: https://github.com/rust-lang/rust/pull/50554/
3983 [50610]: https://github.com/rust-lang/rust/pull/50610/
3984 [50855]: https://github.com/rust-lang/rust/pull/50855/
3985 [51050]: https://github.com/rust-lang/rust/pull/51050/
3986 [51196]: https://github.com/rust-lang/rust/pull/51196/
3987 [51200]: https://github.com/rust-lang/rust/pull/51200/
3988 [51241]: https://github.com/rust-lang/rust/pull/51241/
3989 [51276]: https://github.com/rust-lang/rust/pull/51276/
3990 [51298]: https://github.com/rust-lang/rust/pull/51298/
3991 [51306]: https://github.com/rust-lang/rust/pull/51306/
3992 [51562]: https://github.com/rust-lang/rust/pull/51562/
3993 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3994 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3995 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3996 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3997 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3998 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3999 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
4000 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4001 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4002 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4003 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4004 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4005 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4006 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4007 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4008 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4009 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4010 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4011 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4012 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4013 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4014 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4015 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4016 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4017 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4018 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4019 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4020 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4021 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4022 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4023
4024 Version 1.27.2 (2018-07-20)
4025 ===========================
4026
4027 Compatibility Notes
4028 -------------------
4029
4030 - The borrow checker was fixed to avoid potential unsoundness when using
4031   match ergonomics: [#52213][52213].
4032
4033 [52213]: https://github.com/rust-lang/rust/issues/52213
4034
4035 Version 1.27.1 (2018-07-10)
4036 ===========================
4037
4038 Security Notes
4039 --------------
4040
4041 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4042   when running, which enabled executing code as some other user on a
4043   given machine. This release fixes that vulnerability; you can read
4044   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4045
4046   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4047
4048 Compatibility Notes
4049 -------------------
4050
4051 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4052   match ergonomics: [#51415][51415], [#49534][49534].
4053
4054 [51415]: https://github.com/rust-lang/rust/issues/51415
4055 [49534]: https://github.com/rust-lang/rust/issues/49534
4056 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4057 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4058
4059 Version 1.27.0 (2018-06-21)
4060 ==========================
4061
4062 Language
4063 --------
4064 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4065   be used as an identifier.
4066 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4067   bare `Trait` syntax, and should make it clearer when being used in tandem with
4068   `impl Trait` because it is equivalent to the following syntax:
4069   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4070   `Box<Trait> == Box<dyn Trait>`.
4071 - [Attributes on generic parameters such as types and lifetimes are
4072   now stable.][48851] e.g.
4073   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4074 - [The `#[must_use]` attribute can now also be used on functions as well as
4075   types.][48925] It provides a lint that by default warns users when the
4076   value returned by a function has not been used.
4077
4078 Compiler
4079 --------
4080 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4081
4082 Libraries
4083 ---------
4084 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4085   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4086   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4087   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4088   the `cfg` attribute.
4089 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4090   std are now available in core.][49896]
4091 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4092   to `Self`.][49630]
4093 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4094   that the operation isn't done in place.
4095 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4096   the `#[must_use]` attribute][49533] to warn about unused potentially
4097   expensive allocations.
4098
4099 Stabilized APIs
4100 ---------------
4101 - [`DoubleEndedIterator::rfind`]
4102 - [`DoubleEndedIterator::rfold`]
4103 - [`DoubleEndedIterator::try_rfold`]
4104 - [`Duration::from_micros`]
4105 - [`Duration::from_nanos`]
4106 - [`Duration::subsec_micros`]
4107 - [`Duration::subsec_millis`]
4108 - [`HashMap::remove_entry`]
4109 - [`Iterator::try_fold`]
4110 - [`Iterator::try_for_each`]
4111 - [`NonNull::cast`]
4112 - [`Option::filter`]
4113 - [`String::replace_range`]
4114 - [`Take::set_limit`]
4115 - [`hint::unreachable_unchecked`]
4116 - [`os::unix::process::parent_id`]
4117 - [`ptr::swap_nonoverlapping`]
4118 - [`slice::rsplit_mut`]
4119 - [`slice::rsplit`]
4120 - [`slice::swap_with_slice`]
4121
4122 Cargo
4123 -----
4124 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4125   `readme`, and `repository` fields.][cargo/5386]
4126 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4127 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4128   a different directory than `target` for placing compilation artifacts.
4129 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4130   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4131   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4132   where cargo would infer a binary, Cargo will produce a warning. You can
4133   disable this feature ahead of time by setting any of the following to false:
4134   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4135 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4136   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4137
4138 Misc
4139 ----
4140 - [Added “The Rustc book” into the official documentation.][49707]
4141   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4142 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4143
4144 Compatibility Notes
4145 -------------------
4146 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4147   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4148   compile, `"".is_empty()` will still compile.
4149 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4150   will only print the inner type.][48553] E.g.
4151   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4152   not `AtomicBool(true)`.
4153 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4154   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4155   alignment should cover all use cases.
4156 - The `.description()` method on the `std::error::Error` trait
4157   [has been soft-deprecated][50163]. It is no longer required to implement it.
4158
4159 [48553]: https://github.com/rust-lang/rust/pull/48553/
4160 [48851]: https://github.com/rust-lang/rust/pull/48851/
4161 [48925]: https://github.com/rust-lang/rust/pull/48925/
4162 [49533]: https://github.com/rust-lang/rust/pull/49533/
4163 [49623]: https://github.com/rust-lang/rust/pull/49623/
4164 [49630]: https://github.com/rust-lang/rust/pull/49630/
4165 [49664]: https://github.com/rust-lang/rust/pull/49664/
4166 [49699]: https://github.com/rust-lang/rust/pull/49699/
4167 [49707]: https://github.com/rust-lang/rust/pull/49707/
4168 [49719]: https://github.com/rust-lang/rust/pull/49719/
4169 [49896]: https://github.com/rust-lang/rust/pull/49896/
4170 [49968]: https://github.com/rust-lang/rust/pull/49968/
4171 [50163]: https://github.com/rust-lang/rust/pull/50163
4172 [50177]: https://github.com/rust-lang/rust/pull/50177/
4173 [50378]: https://github.com/rust-lang/rust/pull/50378/
4174 [50398]: https://github.com/rust-lang/rust/pull/50398/
4175 [50423]: https://github.com/rust-lang/rust/pull/50423/
4176 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4177 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4178 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4179 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4180 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4181 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4182 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4183 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4184 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4185 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4186 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4187 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4188 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4189 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4190 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4191 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4192 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4193 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4194 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4195 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4196 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4197 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4198 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4199 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4200 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4201 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4202 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4203 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4204 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4205 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4206
4207
4208 Version 1.26.2 (2018-06-05)
4209 ==========================
4210
4211 Compatibility Notes
4212 -------------------
4213
4214 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4215
4216 [51117]: https://github.com/rust-lang/rust/issues/51117
4217
4218
4219 Version 1.26.1 (2018-05-29)
4220 ==========================
4221
4222 Tools
4223 -----
4224
4225 - [RLS now works on Windows.][50646]
4226 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4227
4228
4229 Compatibility Notes
4230 --------
4231
4232 - [`fn main() -> impl Trait` no longer works for non-Termination
4233   trait.][50656]
4234   This reverts an accidental stabilization.
4235 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4236 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4237
4238 [50646]: https://github.com/rust-lang/rust/issues/50646
4239 [50656]: https://github.com/rust-lang/rust/pull/50656
4240 [50812]: https://github.com/rust-lang/rust/pull/50812
4241 [50950]: https://github.com/rust-lang/rust/issues/50950
4242 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4243
4244 Version 1.26.0 (2018-05-10)
4245 ==========================
4246
4247 Language
4248 --------
4249 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4250   implement either or both traits.][49299]
4251 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4252 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4253   lifetime can be elided.][49458]
4254 - [`impl Trait` is now stable allowing you to have abstract types in returns
4255    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4256   `fn open(path: impl AsRef<Path>)`.
4257 - [Pattern matching will now automatically apply dereferences.][49394]
4258 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4259 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4260 - [A lot of operations are now available in a const context.][46882] E.g. You
4261   can now index into constant arrays, reference and dereference into constants,
4262   and use tuple struct constructors.
4263 - [Fixed entry slice patterns are now stable.][48516] E.g.
4264   ```rust
4265   let points = [1, 2, 3, 4];
4266   match points {
4267       [1, 2, 3, 4] => println!("All points were sequential."),
4268       _ => println!("Not all points were sequential."),
4269   }
4270   ```
4271
4272
4273 Compiler
4274 --------
4275 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4276 - [Fixed exponential projection complexity on nested types.][48296]
4277   This can provide up to a ~12% reduction in compile times for certain crates.
4278 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4279   to remap path prefixes outputted by the compiler.
4280 - [Added `powerpc-unknown-netbsd` target.][48281]
4281
4282 Libraries
4283 ---------
4284 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4285 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4286   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4287 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4288 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4289 - [`ascii::escape_default` is now available in libcore.][48735]
4290 - [Trailing commas are now supported in std and core macros.][48056]
4291 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4292 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4293
4294 Stabilized APIs
4295 ---------------
4296 - [`*const T::add`]
4297 - [`*const T::copy_to_nonoverlapping`]
4298 - [`*const T::copy_to`]
4299 - [`*const T::read_unaligned`]
4300 - [`*const T::read_volatile`]
4301 - [`*const T::read`]
4302 - [`*const T::sub`]
4303 - [`*const T::wrapping_add`]
4304 - [`*const T::wrapping_sub`]
4305 - [`*mut T::add`]
4306 - [`*mut T::copy_to_nonoverlapping`]
4307 - [`*mut T::copy_to`]
4308 - [`*mut T::read_unaligned`]
4309 - [`*mut T::read_volatile`]
4310 - [`*mut T::read`]
4311 - [`*mut T::replace`]
4312 - [`*mut T::sub`]
4313 - [`*mut T::swap`]
4314 - [`*mut T::wrapping_add`]
4315 - [`*mut T::wrapping_sub`]
4316 - [`*mut T::write_bytes`]
4317 - [`*mut T::write_unaligned`]
4318 - [`*mut T::write_volatile`]
4319 - [`*mut T::write`]
4320 - [`Box::leak`]
4321 - [`FromUtf8Error::as_bytes`]
4322 - [`LocalKey::try_with`]
4323 - [`Option::cloned`]
4324 - [`btree_map::Entry::and_modify`]
4325 - [`fs::read_to_string`]
4326 - [`fs::read`]
4327 - [`fs::write`]
4328 - [`hash_map::Entry::and_modify`]
4329 - [`iter::FusedIterator`]
4330 - [`ops::RangeInclusive`]
4331 - [`ops::RangeToInclusive`]
4332 - [`process::id`]
4333 - [`slice::rotate_left`]
4334 - [`slice::rotate_right`]
4335 - [`String::retain`]
4336
4337
4338 Cargo
4339 -----
4340 - [Cargo will now output path to custom commands when `-v` is
4341   passed with `--list`][cargo/5041]
4342 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4343
4344 Misc
4345 ----
4346 - [The second edition of "The Rust Programming Language" book is now recommended
4347   over the first.][48404]
4348
4349 Compatibility Notes
4350 -------------------
4351
4352 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4353   syntax is now invalid.
4354   ```
4355   use std::ops::Fn as dyn;
4356   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4357   ```
4358 - [The result of dereferences are no longer promoted to `'static`.][47408]
4359   e.g.
4360   ```rust
4361   fn main() {
4362       const PAIR: &(i32, i32) = &(0, 1);
4363       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4364   }
4365   ```
4366 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4367 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4368   an error.][48235]
4369 - [Removed hoedown from rustdoc.][48274]
4370 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4371
4372 [46882]: https://github.com/rust-lang/rust/pull/46882
4373 [47379]: https://github.com/rust-lang/rust/pull/47379
4374 [47408]: https://github.com/rust-lang/rust/pull/47408
4375 [47813]: https://github.com/rust-lang/rust/pull/47813
4376 [48056]: https://github.com/rust-lang/rust/pull/48056
4377 [48125]: https://github.com/rust-lang/rust/pull/48125
4378 [48166]: https://github.com/rust-lang/rust/pull/48166
4379 [48235]: https://github.com/rust-lang/rust/pull/48235
4380 [48274]: https://github.com/rust-lang/rust/pull/48274
4381 [48281]: https://github.com/rust-lang/rust/pull/48281
4382 [48296]: https://github.com/rust-lang/rust/pull/48296
4383 [48326]: https://github.com/rust-lang/rust/pull/48326
4384 [48359]: https://github.com/rust-lang/rust/pull/48359
4385 [48404]: https://github.com/rust-lang/rust/pull/48404
4386 [48481]: https://github.com/rust-lang/rust/pull/48481
4387 [48516]: https://github.com/rust-lang/rust/pull/48516
4388 [48628]: https://github.com/rust-lang/rust/pull/48628
4389 [48629]: https://github.com/rust-lang/rust/pull/48629
4390 [48657]: https://github.com/rust-lang/rust/pull/48657
4391 [48735]: https://github.com/rust-lang/rust/pull/48735
4392 [48978]: https://github.com/rust-lang/rust/pull/48978
4393 [49101]: https://github.com/rust-lang/rust/pull/49101
4394 [49109]: https://github.com/rust-lang/rust/pull/49109
4395 [49121]: https://github.com/rust-lang/rust/pull/49121
4396 [49162]: https://github.com/rust-lang/rust/pull/49162
4397 [49184]: https://github.com/rust-lang/rust/pull/49184
4398 [49234]: https://github.com/rust-lang/rust/pull/49234
4399 [49255]: https://github.com/rust-lang/rust/pull/49255
4400 [49299]: https://github.com/rust-lang/rust/pull/49299
4401 [49305]: https://github.com/rust-lang/rust/pull/49305
4402 [49394]: https://github.com/rust-lang/rust/pull/49394
4403 [49458]: https://github.com/rust-lang/rust/pull/49458
4404 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4405 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4406 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4407 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4408 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4409 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4410 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4411 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4412 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4413 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4414 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4415 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4416 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4417 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4418 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4419 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4420 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4421 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4422 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4423 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4424 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4425 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4426 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4427 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4428 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4429 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4430 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4431 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4432 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4433 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4434 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4435 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4436 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4437 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4438 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4439 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4440 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4441 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4442 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4443 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4444 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4445 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4446
4447
4448 Version 1.25.0 (2018-03-29)
4449 ==========================
4450
4451 Language
4452 --------
4453 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4454 - [You can now use nested groups of imports.][47948]
4455   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4456 - [You can now have `|` at the start of a match arm.][47947] e.g.
4457 ```rust
4458 enum Foo { A, B, C }
4459
4460 fn main() {
4461     let x = Foo::A;
4462     match x {
4463         | Foo::A
4464         | Foo::B => println!("AB"),
4465         | Foo::C => println!("C"),
4466     }
4467 }
4468 ```
4469
4470 Compiler
4471 --------
4472 - [Upgraded to LLVM 6.][47828]
4473 - [Added `-C lto=val` option.][47521]
4474 - [Added `i586-unknown-linux-musl` target][47282]
4475
4476 Libraries
4477 ---------
4478 - [Impl Send for `process::Command` on Unix.][47760]
4479 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4480 - [`UnsafeCell::into_inner` is now safe.][47204]
4481 - [Implement libstd for CloudABI.][47268]
4482 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4483 - [Implement `AsRef<Path>` for Component][46985]
4484 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4485 - [Moved `Duration` to libcore.][46666]
4486
4487 Stabilized APIs
4488 ---------------
4489 - [`Location::column`]
4490 - [`ptr::NonNull`]
4491
4492 The following functions can now be used in a constant expression.
4493 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4494 - [`Duration::new`][47300]
4495 - [`Duration::from_secs`][47300]
4496 - [`Duration::from_millis`][47300]
4497
4498 Cargo
4499 -----
4500 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4501 - [`cargo new` now defaults to creating a binary crate, instead of a
4502   library crate.][cargo/5029]
4503
4504 Misc
4505 ----
4506 - [Rust by example is now shipped with new releases][46196]
4507
4508 Compatibility Notes
4509 -------------------
4510 - [Deprecated `net::lookup_host`.][47510]
4511 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4512 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4513   around indexing operations (see [#47349][47349]). This has been fixed (which also
4514   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4515 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4516
4517 [33903]: https://github.com/rust-lang/rust/pull/33903
4518 [47947]: https://github.com/rust-lang/rust/pull/47947
4519 [47948]: https://github.com/rust-lang/rust/pull/47948
4520 [47760]: https://github.com/rust-lang/rust/pull/47760
4521 [47790]: https://github.com/rust-lang/rust/pull/47790
4522 [47828]: https://github.com/rust-lang/rust/pull/47828
4523 [47398]: https://github.com/rust-lang/rust/pull/47398
4524 [47510]: https://github.com/rust-lang/rust/pull/47510
4525 [47521]: https://github.com/rust-lang/rust/pull/47521
4526 [47204]: https://github.com/rust-lang/rust/pull/47204
4527 [47251]: https://github.com/rust-lang/rust/pull/47251
4528 [47268]: https://github.com/rust-lang/rust/pull/47268
4529 [47282]: https://github.com/rust-lang/rust/pull/47282
4530 [47300]: https://github.com/rust-lang/rust/pull/47300
4531 [47349]: https://github.com/rust-lang/rust/pull/47349
4532 [46931]: https://github.com/rust-lang/rust/pull/46931
4533 [46985]: https://github.com/rust-lang/rust/pull/46985
4534 [47006]: https://github.com/rust-lang/rust/pull/47006
4535 [46830]: https://github.com/rust-lang/rust/pull/46830
4536 [46095]: https://github.com/rust-lang/rust/pull/46095
4537 [46666]: https://github.com/rust-lang/rust/pull/46666
4538 [46196]: https://github.com/rust-lang/rust/pull/46196
4539 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4540 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4541 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4542 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4543 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4544
4545
4546 Version 1.24.1 (2018-03-01)
4547 ==========================
4548
4549  - [Do not abort when unwinding through FFI][48251]
4550  - [Emit UTF-16 files for linker arguments on Windows][48318]
4551  - [Make the error index generator work again][48308]
4552  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4553
4554 [48251]: https://github.com/rust-lang/rust/issues/48251
4555 [48308]: https://github.com/rust-lang/rust/issues/48308
4556 [48318]: https://github.com/rust-lang/rust/issues/48318
4557 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4558
4559
4560 Version 1.24.0 (2018-02-15)
4561 ==========================
4562
4563 Language
4564 --------
4565 - [External `sysv64` ffi is now available.][46528]
4566   eg. `extern "sysv64" fn foo () {}`
4567
4568 Compiler
4569 --------
4570 - [rustc now uses 16 codegen units by default for release builds.][46910]
4571   For the fastest builds, utilize `codegen-units=1`.
4572 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4573 - [Add `aarch64-unknown-openbsd` support][46760]
4574
4575 Libraries
4576 ---------
4577 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4578   improvement in performance in the majority of cases.
4579 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4580   with Windows.][46798]
4581 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4582 - [impl `From<bool>` for `AtomicBool`][46293]
4583 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4584 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4585 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4586 - [float::from_bits now just uses transmute.][46012] This provides
4587   some optimisations from LLVM.
4588 - [Copied `AsciiExt` methods onto `char`][46077]
4589 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4590 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4591 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4592 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4593
4594 Stabilized APIs
4595 ---------------
4596 - [`RefCell::replace`]
4597 - [`RefCell::swap`]
4598 - [`atomic::spin_loop_hint`]
4599
4600 The following functions can now be used in a constant expression.
4601 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4602
4603 - [`AtomicBool::new`][46287]
4604 - [`AtomicUsize::new`][46287]
4605 - [`AtomicIsize::new`][46287]
4606 - [`AtomicPtr::new`][46287]
4607 - [`Cell::new`][46287]
4608 - [`{integer}::min_value`][46287]
4609 - [`{integer}::max_value`][46287]
4610 - [`mem::size_of`][46287]
4611 - [`mem::align_of`][46287]
4612 - [`ptr::null`][46287]
4613 - [`ptr::null_mut`][46287]
4614 - [`RefCell::new`][46287]
4615 - [`UnsafeCell::new`][46287]
4616
4617 Cargo
4618 -----
4619 - [Added a `workspace.default-members` config that
4620   overrides implied `--all` in virtual workspaces.][cargo/4743]
4621 - [Enable incremental by default on development builds.][cargo/4817] Also added
4622   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4623   per-project or global basis respectively.
4624
4625 Misc
4626 ----
4627
4628 Compatibility Notes
4629 -------------------
4630 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4631 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4632   in accordance with IETF RFC 4291 §2.2.
4633 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4634 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4635   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4636 - [Leading zeros in tuple struct members is now an error][47084]
4637 - [`column!()` macro is one-based instead of zero-based][46977]
4638 - [`fmt::Arguments` can no longer be shared across threads][45198]
4639 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4640 - [Cargo sets a different working directory for the compiler][cargo/4788]
4641
4642 [44884]: https://github.com/rust-lang/rust/pull/44884
4643 [45198]: https://github.com/rust-lang/rust/pull/45198
4644 [45506]: https://github.com/rust-lang/rust/pull/45506
4645 [45904]: https://github.com/rust-lang/rust/pull/45904
4646 [45990]: https://github.com/rust-lang/rust/pull/45990
4647 [46012]: https://github.com/rust-lang/rust/pull/46012
4648 [46077]: https://github.com/rust-lang/rust/pull/46077
4649 [46094]: https://github.com/rust-lang/rust/pull/46094
4650 [46284]: https://github.com/rust-lang/rust/pull/46284
4651 [46287]: https://github.com/rust-lang/rust/pull/46287
4652 [46293]: https://github.com/rust-lang/rust/pull/46293
4653 [46528]: https://github.com/rust-lang/rust/pull/46528
4654 [46671]: https://github.com/rust-lang/rust/pull/46671
4655 [46713]: https://github.com/rust-lang/rust/pull/46713
4656 [46735]: https://github.com/rust-lang/rust/pull/46735
4657 [46749]: https://github.com/rust-lang/rust/pull/46749
4658 [46760]: https://github.com/rust-lang/rust/pull/46760
4659 [46798]: https://github.com/rust-lang/rust/pull/46798
4660 [46828]: https://github.com/rust-lang/rust/pull/46828
4661 [46831]: https://github.com/rust-lang/rust/pull/46831
4662 [46833]: https://github.com/rust-lang/rust/pull/46833
4663 [46910]: https://github.com/rust-lang/rust/pull/46910
4664 [46977]: https://github.com/rust-lang/rust/pull/46977
4665 [47018]: https://github.com/rust-lang/rust/pull/47018
4666 [47080]: https://github.com/rust-lang/rust/pull/47080
4667 [47084]: https://github.com/rust-lang/rust/pull/47084
4668 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4669 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4670 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4671 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4672 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4673 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4674
4675
4676 Version 1.23.0 (2018-01-04)
4677 ==========================
4678
4679 Language
4680 --------
4681 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4682 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4683   Which should fix some confusing errors in some operations.
4684
4685 Compiler
4686 --------
4687 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4688   undefined behavior.][45920]
4689 - [rustc now suggests renaming import if names clash.][45660]
4690 - [Display errors/warnings correctly when there are zero-width or
4691   wide characters.][45711]
4692 - [rustc now avoids unnecessary copies of arguments that are
4693   simple bindings][45380] This should improve memory usage on average by 5-10%.
4694 - [Updated musl used to build musl rustc to 1.1.17][45393]
4695
4696 Libraries
4697 ---------
4698 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4699 - [Implement Hash for raw pointers to unsized types][45483]
4700 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4701 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4702 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4703 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4704   and `<*mut T>::as_mut`][44932]
4705 - [Optimized `Thread::{park, unpark}` implementation][45524]
4706 - [Improved `SliceExt::binary_search` performance.][45333]
4707 - [impl `FromIterator<()>` for `()`][45379]
4708 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4709   is now deprecated.
4710
4711 Stabilized APIs
4712 ---------------
4713
4714 Cargo
4715 -----
4716 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4717   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4718 - [Added unit test checking to `cargo check`][cargo/4592]
4719 - [Cargo now lets you install a specific version
4720   using `cargo install --version`][cargo/4637]
4721
4722 Misc
4723 ----
4724 - [Releases now ship with the Cargo book documentation.][45692]
4725 - [rustdoc now prints rendering warnings on every run.][45324]
4726
4727 Compatibility Notes
4728 -------------------
4729 - [Changes have been made to type equality to make it more correct,
4730   in rare cases this could break some code.][45853] [Tracking issue for
4731   further information][45852]
4732 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4733 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4734   Android 9, the minimum supported version is Android 14.
4735 - [Bumped the minimum LLVM to 3.9][45326]
4736
4737 [44042]: https://github.com/rust-lang/rust/pull/44042
4738 [44932]: https://github.com/rust-lang/rust/pull/44932
4739 [45267]: https://github.com/rust-lang/rust/pull/45267
4740 [45324]: https://github.com/rust-lang/rust/pull/45324
4741 [45326]: https://github.com/rust-lang/rust/pull/45326
4742 [45333]: https://github.com/rust-lang/rust/pull/45333
4743 [45379]: https://github.com/rust-lang/rust/pull/45379
4744 [45380]: https://github.com/rust-lang/rust/pull/45380
4745 [45393]: https://github.com/rust-lang/rust/pull/45393
4746 [45435]: https://github.com/rust-lang/rust/pull/45435
4747 [45483]: https://github.com/rust-lang/rust/pull/45483
4748 [45524]: https://github.com/rust-lang/rust/pull/45524
4749 [45571]: https://github.com/rust-lang/rust/pull/45571
4750 [45580]: https://github.com/rust-lang/rust/pull/45580
4751 [45610]: https://github.com/rust-lang/rust/pull/45610
4752 [45660]: https://github.com/rust-lang/rust/pull/45660
4753 [45692]: https://github.com/rust-lang/rust/pull/45692
4754 [45711]: https://github.com/rust-lang/rust/pull/45711
4755 [45772]: https://github.com/rust-lang/rust/pull/45772
4756 [45852]: https://github.com/rust-lang/rust/issues/45852
4757 [45853]: https://github.com/rust-lang/rust/pull/45853
4758 [45887]: https://github.com/rust-lang/rust/pull/45887
4759 [45920]: https://github.com/rust-lang/rust/pull/45920
4760 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4761 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4762 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4763
4764
4765 Version 1.22.1 (2017-11-22)
4766 ==========================
4767
4768 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4769
4770 [46183]: https://github.com/rust-lang/rust/pull/46183
4771
4772 Version 1.22.0 (2017-11-22)
4773 ==========================
4774
4775 Language
4776 --------
4777 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4778 - [Now accepts underscores in unicode escapes][43716]
4779 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4780 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4781
4782 Compiler
4783 --------
4784 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4785 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4786   This should decrease compile times for debug builds.
4787 - [strict memory alignment now enabled on ARMv6][45094]
4788 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4789
4790 Libraries
4791 ---------
4792 - [Allow atomic operations up to 32 bits
4793   on `armv5te_unknown_linux_gnueabi`][44978]
4794 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4795 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4796 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4797 - [Properly detect overflow in `Instant += Duration`.][44220]
4798 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4799 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4800 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4801
4802 Stabilized APIs
4803 ---------------
4804
4805 Cargo
4806 -----
4807 - [Cargo will now build multi file examples in subdirectories of the `examples`
4808   folder that have a `main.rs` file.][cargo/4496]
4809 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4810   the old format will continue to work and can be updated with `cargo update`.
4811 - [Now supports vendoring git repositories][cargo/3992]
4812
4813 Misc
4814 ----
4815 - [`libbacktrace` is now available on Apple platforms.][44251]
4816 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4817   This now lets you specify that a given code example will fail to compile.
4818
4819 Compatibility Notes
4820 -------------------
4821 - [The minimum Android version that rustc can build for has been bumped
4822   to `4.0` from `2.3`][45656]
4823 - [Allowing `T op= &T` for numeric types has broken some type
4824   inference cases][45480]
4825
4826
4827 [42526]: https://github.com/rust-lang/rust/pull/42526
4828 [43017]: https://github.com/rust-lang/rust/pull/43017
4829 [43716]: https://github.com/rust-lang/rust/pull/43716
4830 [43949]: https://github.com/rust-lang/rust/pull/43949
4831 [44015]: https://github.com/rust-lang/rust/pull/44015
4832 [44220]: https://github.com/rust-lang/rust/pull/44220
4833 [44251]: https://github.com/rust-lang/rust/pull/44251
4834 [44287]: https://github.com/rust-lang/rust/pull/44287
4835 [44303]: https://github.com/rust-lang/rust/pull/44303
4836 [44456]: https://github.com/rust-lang/rust/pull/44456
4837 [44466]: https://github.com/rust-lang/rust/pull/44466
4838 [44895]: https://github.com/rust-lang/rust/pull/44895
4839 [44966]: https://github.com/rust-lang/rust/pull/44966
4840 [44978]: https://github.com/rust-lang/rust/pull/44978
4841 [45041]: https://github.com/rust-lang/rust/pull/45041
4842 [45064]: https://github.com/rust-lang/rust/pull/45064
4843 [45075]: https://github.com/rust-lang/rust/pull/45075
4844 [45094]: https://github.com/rust-lang/rust/pull/45094
4845 [45095]: https://github.com/rust-lang/rust/pull/45095
4846 [45480]: https://github.com/rust-lang/rust/issues/45480
4847 [45656]: https://github.com/rust-lang/rust/pull/45656
4848 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4849 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4850 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4851
4852
4853
4854
4855
4856
4857 Version 1.21.0 (2017-10-12)
4858 ==========================
4859
4860 Language
4861 --------
4862 - [You can now use static references for literals.][43838]
4863   Example:
4864   ```rust
4865   fn main() {
4866       let x: &'static u32 = &0;
4867   }
4868   ```
4869 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4870   Example:
4871   ```rust
4872   my_macro!(Vec<i32>::new); // Always worked
4873   my_macro!(Vec::<i32>::new); // Now works
4874   ```
4875
4876 Compiler
4877 --------
4878 - [Upgraded jemalloc to 4.5.0][43911]
4879 - [Enabled unwinding panics on Redox][43917]
4880 - [Now runs LLVM in parallel during translation phase.][43506]
4881   This should reduce peak memory usage.
4882
4883 Libraries
4884 ---------
4885 - [Generate builtin impls for `Clone` for all arrays and tuples that
4886   are `T: Clone`][43690]
4887 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4888 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4889   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4890
4891 Stabilized APIs
4892 ---------------
4893
4894 [`std::mem::discriminant`]
4895
4896 Cargo
4897 -----
4898 - [You can now call `cargo install` with multiple package names][cargo/4216]
4899 - [Cargo commands inside a virtual workspace will now implicitly
4900   pass `--all`][cargo/4335]
4901 - [Added a `[patch]` section to `Cargo.toml` to handle
4902   prepublication dependencies][cargo/4123] [RFC 1969]
4903 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4904   like patterns][cargo/4270]
4905 - [Added the `--all-targets` option][cargo/4400]
4906 - [Using required dependencies as a feature is now deprecated and emits
4907   a warning][cargo/4364]
4908
4909
4910 Misc
4911 ----
4912 - [Cargo docs are moving][43916]
4913   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4914 - [The rustdoc book is now available][43863]
4915   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4916 - [Added a preview of RLS has been made available through rustup][44204]
4917   Install with `rustup component add rls-preview`
4918 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4919   Previously only showed `std::os::unix`.
4920
4921 Compatibility Notes
4922 -------------------
4923 - [Changes in method matching against higher-ranked types][43880] This may cause
4924   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4925 - [rustc's JSON error output's byte position start at top of file.][42973]
4926   Was previously relative to the rustc's internal `CodeMap` struct which
4927   required the unstable library `libsyntax` to correctly use.
4928 - [`unused_results` lint no longer ignores booleans][43728]
4929
4930 [42565]: https://github.com/rust-lang/rust/pull/42565
4931 [42973]: https://github.com/rust-lang/rust/pull/42973
4932 [43348]: https://github.com/rust-lang/rust/pull/43348
4933 [43459]: https://github.com/rust-lang/rust/pull/43459
4934 [43506]: https://github.com/rust-lang/rust/pull/43506
4935 [43540]: https://github.com/rust-lang/rust/pull/43540
4936 [43690]: https://github.com/rust-lang/rust/pull/43690
4937 [43728]: https://github.com/rust-lang/rust/pull/43728
4938 [43838]: https://github.com/rust-lang/rust/pull/43838
4939 [43863]: https://github.com/rust-lang/rust/pull/43863
4940 [43880]: https://github.com/rust-lang/rust/pull/43880
4941 [43911]: https://github.com/rust-lang/rust/pull/43911
4942 [43916]: https://github.com/rust-lang/rust/pull/43916
4943 [43917]: https://github.com/rust-lang/rust/pull/43917
4944 [44204]: https://github.com/rust-lang/rust/pull/44204
4945 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4946 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4947 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4948 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4949 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4950 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4951 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4952 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4953 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4954
4955 Version 1.20.0 (2017-08-31)
4956 ===========================
4957
4958 Language
4959 --------
4960 - [Associated constants are now stabilised.][42809]
4961 - [A lot of macro bugs are now fixed.][42913]
4962
4963 Compiler
4964 --------
4965
4966 - [Struct fields are now properly coerced to the expected field type.][42807]
4967 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4968   `wasm32-experimental-emscripten` target.
4969 - [Changed some of the error messages to be more helpful.][42033]
4970 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4971   it.][43170]
4972 - [rustc now reports the total number of errors on compilation failure][43015]
4973   previously this was only the number of errors in the pass that failed.
4974 - [Expansion in rustc has been sped up 29x.][42533]
4975 - [added `msp430-none-elf` target.][43099]
4976 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4977   applicable][43178]
4978 - [Fixes backtraces on Redox][43228]
4979 - [rustc now identifies different versions of same crate when absolute paths of
4980   different types match in an error message.][42826]
4981
4982 Libraries
4983 ---------
4984
4985
4986 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4987 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4988   tuples.][43011]
4989 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4990   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4991 - [Impl `Clone` for `DefaultHasher`.][42799]
4992 - [Impl `Sync` for `SyncSender`.][42397]
4993 - [Impl `FromStr` for `char`][42271]
4994 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4995   NaN.][42431]
4996 - [allow messages in the `unimplemented!()` macro.][42155]
4997   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4998 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4999 - [Upgrade to Unicode 10.0.0][42999]
5000 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5001 - [Skip the main thread's manual stack guard on Linux][43072]
5002 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
5003 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5004   previously 2^15.
5005 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5006
5007 Stabilized APIs
5008 ---------------
5009
5010 - [`CStr::into_c_string`]
5011 - [`CString::as_c_str`]
5012 - [`CString::into_boxed_c_str`]
5013 - [`Chain::get_mut`]
5014 - [`Chain::get_ref`]
5015 - [`Chain::into_inner`]
5016 - [`Option::get_or_insert_with`]
5017 - [`Option::get_or_insert`]
5018 - [`OsStr::into_os_string`]
5019 - [`OsString::into_boxed_os_str`]
5020 - [`Take::get_mut`]
5021 - [`Take::get_ref`]
5022 - [`Utf8Error::error_len`]
5023 - [`char::EscapeDebug`]
5024 - [`char::escape_debug`]
5025 - [`compile_error!`]
5026 - [`f32::from_bits`]
5027 - [`f32::to_bits`]
5028 - [`f64::from_bits`]
5029 - [`f64::to_bits`]
5030 - [`mem::ManuallyDrop`]
5031 - [`slice::sort_unstable_by_key`]
5032 - [`slice::sort_unstable_by`]
5033 - [`slice::sort_unstable`]
5034 - [`str::from_boxed_utf8_unchecked`]
5035 - [`str::as_bytes_mut`]
5036 - [`str::as_bytes_mut`]
5037 - [`str::from_utf8_mut`]
5038 - [`str::from_utf8_unchecked_mut`]
5039 - [`str::get_mut`]
5040 - [`str::get_unchecked_mut`]
5041 - [`str::get_unchecked`]
5042 - [`str::get`]
5043 - [`str::into_boxed_bytes`]
5044
5045
5046 Cargo
5047 -----
5048 - [Cargo API token location moved from `~/.cargo/config` to
5049   `~/.cargo/credentials`.][cargo/3978]
5050 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5051   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5052   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5053 - [You can now specify version of a binary when installed through
5054   `cargo install` using `--vers`.][cargo/4229]
5055 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5056   failure.][cargo/4248]
5057 - [Changed the convention around which file is the crate root.][cargo/4259]
5058 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5059   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5060
5061 Compatibility Notes
5062 -------------------
5063
5064 - [Functions with `'static` in their return types will now not be as usable as
5065   if they were using lifetime parameters instead.][42417]
5066 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5067   takes the sign of NaN into account where previously didn't.][42430]
5068
5069 [42033]: https://github.com/rust-lang/rust/pull/42033
5070 [42155]: https://github.com/rust-lang/rust/pull/42155
5071 [42271]: https://github.com/rust-lang/rust/pull/42271
5072 [42397]: https://github.com/rust-lang/rust/pull/42397
5073 [42417]: https://github.com/rust-lang/rust/pull/42417
5074 [42430]: https://github.com/rust-lang/rust/pull/42430
5075 [42431]: https://github.com/rust-lang/rust/pull/42431
5076 [42533]: https://github.com/rust-lang/rust/pull/42533
5077 [42571]: https://github.com/rust-lang/rust/pull/42571
5078 [42613]: https://github.com/rust-lang/rust/pull/42613
5079 [42799]: https://github.com/rust-lang/rust/pull/42799
5080 [42807]: https://github.com/rust-lang/rust/pull/42807
5081 [42809]: https://github.com/rust-lang/rust/pull/42809
5082 [42822]: https://github.com/rust-lang/rust/pull/42822
5083 [42826]: https://github.com/rust-lang/rust/pull/42826
5084 [42854]: https://github.com/rust-lang/rust/pull/42854
5085 [42913]: https://github.com/rust-lang/rust/pull/42913
5086 [42999]: https://github.com/rust-lang/rust/pull/42999
5087 [43011]: https://github.com/rust-lang/rust/pull/43011
5088 [43015]: https://github.com/rust-lang/rust/pull/43015
5089 [43072]: https://github.com/rust-lang/rust/pull/43072
5090 [43077]: https://github.com/rust-lang/rust/pull/43077
5091 [43097]: https://github.com/rust-lang/rust/pull/43097
5092 [43099]: https://github.com/rust-lang/rust/pull/43099
5093 [43170]: https://github.com/rust-lang/rust/pull/43170
5094 [43178]: https://github.com/rust-lang/rust/pull/43178
5095 [43185]: https://github.com/rust-lang/rust/pull/43185
5096 [43228]: https://github.com/rust-lang/rust/pull/43228
5097 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5098 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5099 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5100 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5101 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5102 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5103 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5104 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5105 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5106 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5107 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5108 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5109 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5110 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5111 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5112 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5113 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5114 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5115 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5116 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5117 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5118 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5119 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5120 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5121 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5122 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5123 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5124 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5125 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5126 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5127 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5128 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5129 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5130 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5131 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5132 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5133 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5134 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5135 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5136
5137
5138 Version 1.19.0 (2017-07-20)
5139 ===========================
5140
5141 Language
5142 --------
5143
5144 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5145   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5146 - [Macro recursion limit increased to 1024 from 64.][41676]
5147 - [Added lint for detecting unused macros.][41907]
5148 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5149   For example: `let x = loop { break 7; };`
5150 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5151   contain `Copy` types and cannot have a `Drop` implementation.
5152   Example: `union Foo { bar: u8, baz: usize }`
5153 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5154   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5155
5156 Compiler
5157 --------
5158
5159 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5160 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5161   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5162   you should use `--target armv7-linux-androideabi`.
5163 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5164 - [Minor optimisation of string operations.][42037]
5165 - [Compiler error message is now `aborting due to previous error(s)` instead of
5166   `aborting due to N previous errors`][42150] This was previously inaccurate and
5167   would only count certain kinds of errors.
5168 - [The compiler now supports Visual Studio 2017][42225]
5169 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5170 - [Added a lot][42264] of [new error codes][42302]
5171 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5172   libraries with C Run-time Libraries(CRT) to be statically linked.
5173 - [Fixed various ARM codegen bugs][42740]
5174
5175 Libraries
5176 ---------
5177
5178 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5179   `Extend<Cow<'a, str>>`][41449]
5180 - [`Vec` now implements `From<&mut [T]>`][41530]
5181 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5182 - [`SplitWhitespace` now implements `Clone`][41659]
5183 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5184   1.5x faster][41764]
5185 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5186   macros, but for printing to stderr.
5187
5188 Stabilized APIs
5189 ---------------
5190
5191 - [`OsString::shrink_to_fit`]
5192 - [`cmp::Reverse`]
5193 - [`Command::envs`]
5194 - [`thread::ThreadId`]
5195
5196 Cargo
5197 -----
5198
5199 - [Build scripts can now add environment variables to the environment
5200   the crate is being compiled in.
5201   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5202 - [Subcommands now replace the current process rather than spawning a new
5203   child process][cargo/3970]
5204 - [Workspace members can now accept glob file patterns][cargo/3979]
5205 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5206   the members in a given workspace.][cargo/3988]
5207 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5208 - [Target directory path is now in the cargo metadata][cargo/4022]
5209 - [Cargo no longer checks out a local working directory for the
5210   crates.io index][cargo/4026] This should provide smaller file size for the
5211   registry, and improve cloning times, especially on Windows machines.
5212 - [Added an `--exclude` option for excluding certain packages when using the
5213   `--all` option][cargo/4031]
5214 - [Cargo will now automatically retry when receiving a 5xx error
5215   from crates.io][cargo/4032]
5216 - [The `--features` option now accepts multiple comma or space
5217   delimited values.][cargo/4084]
5218 - [Added support for custom target specific runners][cargo/3954]
5219
5220 Misc
5221 ----
5222
5223 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5224   Windows Debugger.
5225 - [Rust will now release XZ compressed packages][rust-installer/57]
5226 - [rustup will now prefer to download rust packages with
5227   XZ compression][rustup/1100] over GZip packages.
5228 - [Added the ability to escape `#` in rust documentation][41785] By adding
5229   additional `#`'s ie. `##` is now `#`
5230
5231 Compatibility Notes
5232 -------------------
5233
5234 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5235 - [`-Z` flags are now no longer allowed to be used on the stable
5236   compiler.][41751] This has been a warning for a year previous to this.
5237 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5238   longer works][42844]. Users should migrate to the built-in `check`
5239   command, which has been available since 1.16.
5240 - [Ending a float literal with `._` is now a hard error.
5241   Example: `42._` .][41946]
5242 - [Any use of a private `extern crate` outside of its module is now a
5243   hard error.][36886] This was previously a warning.
5244 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5245   relative while the `::` prefix makes a path absolute, but was ignored and the
5246   path was relative regardless.
5247 - [Floating point constants in match patterns is now a hard error][36890]
5248   This was previously a warning.
5249 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5250   match patterns is now a hard error][36891] This was previously a warning.
5251 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5252   a warning.
5253 - [From the pound escape, lines consisting of multiple `#`s are
5254   now visible][41785]
5255 - [It is an error to re-export private enum variants][42460]. This is
5256   known to break a number of crates that depend on an older version of
5257   mustache.
5258 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5259   to use it to find the linker, and the build will fail where it did
5260   not previously][42607]
5261
5262 [36886]: https://github.com/rust-lang/rust/issues/36886
5263 [36888]: https://github.com/rust-lang/rust/issues/36888
5264 [36890]: https://github.com/rust-lang/rust/issues/36890
5265 [36891]: https://github.com/rust-lang/rust/issues/36891
5266 [36892]: https://github.com/rust-lang/rust/issues/36892
5267 [37406]: https://github.com/rust-lang/rust/issues/37406
5268 [39983]: https://github.com/rust-lang/rust/pull/39983
5269 [41145]: https://github.com/rust-lang/rust/pull/41145
5270 [41192]: https://github.com/rust-lang/rust/pull/41192
5271 [41258]: https://github.com/rust-lang/rust/pull/41258
5272 [41370]: https://github.com/rust-lang/rust/pull/41370
5273 [41449]: https://github.com/rust-lang/rust/pull/41449
5274 [41530]: https://github.com/rust-lang/rust/pull/41530
5275 [41624]: https://github.com/rust-lang/rust/pull/41624
5276 [41656]: https://github.com/rust-lang/rust/pull/41656
5277 [41659]: https://github.com/rust-lang/rust/pull/41659
5278 [41676]: https://github.com/rust-lang/rust/pull/41676
5279 [41751]: https://github.com/rust-lang/rust/pull/41751
5280 [41764]: https://github.com/rust-lang/rust/pull/41764
5281 [41785]: https://github.com/rust-lang/rust/pull/41785
5282 [41873]: https://github.com/rust-lang/rust/pull/41873
5283 [41907]: https://github.com/rust-lang/rust/pull/41907
5284 [41946]: https://github.com/rust-lang/rust/pull/41946
5285 [42016]: https://github.com/rust-lang/rust/pull/42016
5286 [42037]: https://github.com/rust-lang/rust/pull/42037
5287 [42068]: https://github.com/rust-lang/rust/pull/42068
5288 [42150]: https://github.com/rust-lang/rust/pull/42150
5289 [42162]: https://github.com/rust-lang/rust/pull/42162
5290 [42225]: https://github.com/rust-lang/rust/pull/42225
5291 [42264]: https://github.com/rust-lang/rust/pull/42264
5292 [42302]: https://github.com/rust-lang/rust/pull/42302
5293 [42460]: https://github.com/rust-lang/rust/issues/42460
5294 [42607]: https://github.com/rust-lang/rust/issues/42607
5295 [42740]: https://github.com/rust-lang/rust/pull/42740
5296 [42844]: https://github.com/rust-lang/rust/issues/42844
5297 [42948]: https://github.com/rust-lang/rust/pull/42948
5298 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5299 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5300 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5301 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5302 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5303 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5304 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5305 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5306 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5307 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5308 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5309 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5310 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5311 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5312 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5313 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5314 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5315 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5316 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5317 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5318 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5319 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5320
5321
5322 Version 1.18.0 (2017-06-08)
5323 ===========================
5324
5325 Language
5326 --------
5327
5328 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5329   make the item visible to just that module tree. Also accepts the keyword
5330   `crate` to make something public to the whole crate but not users of the
5331   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5332 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5333   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5334 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5335   types like `Write + Send`, trailing `+` are now supported in trait objects,
5336   and better error reporting for trait objects starting with `?Sized`.
5337 - [0e+10 is now a valid floating point literal][40589]
5338 - [Now warns if you bind a lifetime parameter to 'static][40734]
5339 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5340   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5341   representation in some cases.][40377]
5342
5343 Compiler
5344 --------
5345
5346 - [rustc can now emit mir with `--emit mir`][39891]
5347 - [Improved LLVM IR for trivial functions][40367]
5348 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5349 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5350   opportunities found through profiling
5351 - [Improved backtrace formatting when panicking][38165]
5352
5353 Libraries
5354 ---------
5355
5356 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5357   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5358   iteration or reallocation.
5359 - [Simplified HashMap Bucket interface][40561] provides performance
5360   improvements for iterating and cloning.
5361 - [Specialize Vec::from_elem to use calloc][40409]
5362 - [Fixed Race condition in fs::create_dir_all][39799]
5363 - [No longer caching stdio on Windows][40516]
5364 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5365   2.50%~ faster and in one case now 12.50% faster.
5366 - [Optimized `AtomicBool::fetch_nand`][41143]
5367
5368 Stabilized APIs
5369 ---------------
5370
5371 - [`Child::try_wait`]
5372 - [`HashMap::retain`]
5373 - [`HashSet::retain`]
5374 - [`PeekMut::pop`]
5375 - [`TcpStream::peek`]
5376 - [`UdpSocket::peek`]
5377 - [`UdpSocket::peek_from`]
5378
5379 Cargo
5380 -----
5381
5382 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5383   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5384 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5385 - [Added Android build support][cargo/3885]
5386 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5387   of a certain type, for example `cargo build --bins` will build all
5388   binaries.
5389 - [Added support for haiku][cargo/3952]
5390
5391 Misc
5392 ----
5393
5394 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5395 - [Added rust-windbg script for better debugging on Windows][39983]
5396 - [Rust now uses the official cross compiler for NetBSD][40612]
5397 - [rustdoc now accepts `#` at the start of files][40828]
5398 - [Fixed jemalloc support for musl][41168]
5399
5400 Compatibility Notes
5401 -------------------
5402
5403 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5404   always placed after the sign if it exists and before the digits. With the `#`
5405   flag the zeroes are placed after the prefix and before the digits.
5406 - [Due to the struct field optimisation][40377], using `transmute` on structs
5407   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5408   always been undefined behavior, but is now more likely to break in practice.
5409 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5410   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5411   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5412 - [Overlapping inherent `impl`s are now a hard error][40728]
5413 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5414 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5415   `out.asm` and `out.ll` instead of only one of the filetypes.
5416 - [ calling a function that returns `Self` will no longer work][41805] when
5417   the size of `Self` cannot be statically determined.
5418 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5419   this has caused a few regressions namely:
5420
5421   - Changed the link order of local static/dynamic libraries (respecting the
5422     order on given rather than having the compiler reorder).
5423   - Changed how MinGW is linked, native code linked to dynamic libraries
5424     may require manually linking to the gcc support library (for the native
5425     code itself)
5426
5427 [38165]: https://github.com/rust-lang/rust/pull/38165
5428 [39799]: https://github.com/rust-lang/rust/pull/39799
5429 [39891]: https://github.com/rust-lang/rust/pull/39891
5430 [39983]: https://github.com/rust-lang/rust/pull/39983
5431 [40043]: https://github.com/rust-lang/rust/pull/40043
5432 [40241]: https://github.com/rust-lang/rust/pull/40241
5433 [40338]: https://github.com/rust-lang/rust/pull/40338
5434 [40367]: https://github.com/rust-lang/rust/pull/40367
5435 [40377]: https://github.com/rust-lang/rust/pull/40377
5436 [40409]: https://github.com/rust-lang/rust/pull/40409
5437 [40516]: https://github.com/rust-lang/rust/pull/40516
5438 [40556]: https://github.com/rust-lang/rust/pull/40556
5439 [40561]: https://github.com/rust-lang/rust/pull/40561
5440 [40589]: https://github.com/rust-lang/rust/pull/40589
5441 [40612]: https://github.com/rust-lang/rust/pull/40612
5442 [40723]: https://github.com/rust-lang/rust/pull/40723
5443 [40728]: https://github.com/rust-lang/rust/pull/40728
5444 [40731]: https://github.com/rust-lang/rust/pull/40731
5445 [40734]: https://github.com/rust-lang/rust/pull/40734
5446 [40805]: https://github.com/rust-lang/rust/pull/40805
5447 [40807]: https://github.com/rust-lang/rust/pull/40807
5448 [40828]: https://github.com/rust-lang/rust/pull/40828
5449 [40870]: https://github.com/rust-lang/rust/pull/40870
5450 [41085]: https://github.com/rust-lang/rust/pull/41085
5451 [41143]: https://github.com/rust-lang/rust/pull/41143
5452 [41168]: https://github.com/rust-lang/rust/pull/41168
5453 [41270]: https://github.com/rust-lang/rust/issues/41270
5454 [41469]: https://github.com/rust-lang/rust/pull/41469
5455 [41805]: https://github.com/rust-lang/rust/issues/41805
5456 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5457 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5458 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5459 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5460 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5461 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5462 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5463 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5464 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5465 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5466 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5467 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5468 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5469 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5470
5471
5472 Version 1.17.0 (2017-04-27)
5473 ===========================
5474
5475 Language
5476 --------
5477
5478 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5479 * [Fields of structs may be initialized without duplicating the field/variable
5480   names][39761]. [RFC 1682]
5481 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5482 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5483   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5484   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5485   `'b`. Soundness fix.
5486 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5487 * [Static variables may contain references to other statics][40027]
5488
5489 Compiler
5490 --------
5491
5492 * [Exit quickly on only `--emit dep-info`][40336]
5493 * [Make `-C relocation-model` more correctly determine whether the linker
5494   creates a position-independent executable][40245]
5495 * [Add `-C overflow-checks` to directly control whether integer overflow
5496   panics][40037]
5497 * [The rustc type checker now checks items on demand instead of in a single
5498   in-order pass][40008]. This is mostly an internal refactoring in support of
5499   future work, including incremental type checking, but also resolves [RFC
5500   1647], allowing `Self` to appear in `impl` `where` clauses.
5501 * [Optimize vtable loads][39995]
5502 * [Turn off vectorization for Emscripten targets][39990]
5503 * [Provide suggestions for unknown macros imported with `use`][39953]
5504 * [Fix ICEs in path resolution][39939]
5505 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5506 * [Add clearer error message using `&str + &str`][39116]
5507
5508 Stabilized APIs
5509 ---------------
5510
5511 * [`Arc::into_raw`]
5512 * [`Arc::from_raw`]
5513 * [`Arc::ptr_eq`]
5514 * [`Rc::into_raw`]
5515 * [`Rc::from_raw`]
5516 * [`Rc::ptr_eq`]
5517 * [`Ordering::then`]
5518 * [`Ordering::then_with`]
5519 * [`BTreeMap::range`]
5520 * [`BTreeMap::range_mut`]
5521 * [`collections::Bound`]
5522 * [`process::abort`]
5523 * [`ptr::read_unaligned`]
5524 * [`ptr::write_unaligned`]
5525 * [`Result::expect_err`]
5526 * [`Cell::swap`]
5527 * [`Cell::replace`]
5528 * [`Cell::into_inner`]
5529 * [`Cell::take`]
5530
5531 Libraries
5532 ---------
5533
5534 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5535 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5536 * [`String` implements `FromIterator<&char>`][40028]
5537 * `Box` [implements][40009] a number of new conversions:
5538   `From<Box<str>> for String`,
5539   `From<Box<[T]>> for Vec<T>`,
5540   `From<Box<CStr>> for CString`,
5541   `From<Box<OsStr>> for OsString`,
5542   `From<Box<Path>> for PathBuf`,
5543   `Into<Box<str>> for String`,
5544   `Into<Box<[T]>> for Vec<T>`,
5545   `Into<Box<CStr>> for CString`,
5546   `Into<Box<OsStr>> for OsString`,
5547   `Into<Box<Path>> for PathBuf`,
5548   `Default for Box<str>`,
5549   `Default for Box<CStr>`,
5550   `Default for Box<OsStr>`,
5551   `From<&CStr> for Box<CStr>`,
5552   `From<&OsStr> for Box<OsStr>`,
5553   `From<&Path> for Box<Path>`
5554 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5555 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5556 * [Slightly optimize `slice::sort`][39538]
5557 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5558 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5559   `Box<str>` implements `From<&str>`][39438]
5560 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5561   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5562 * [`format!` estimates the needed capacity before writing a string][39356]
5563 * [Support unprivileged symlink creation in Windows][38921]
5564 * [`PathBuf` implements `Default`][38764]
5565 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5566 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5567   and poor hash functions.
5568
5569 Cargo
5570 -----
5571
5572 * [Add `cargo check --all`][cargo/3731]
5573 * [Add an option to ignore SSL revocation checking][cargo/3699]
5574 * [Add `cargo run --package`][cargo/3691]
5575 * [Add `required_features`][cargo/3667]
5576 * [Assume `build.rs` is a build script][cargo/3664]
5577 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5578
5579 Misc
5580 ----
5581
5582 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5583   `rustbook`][39633]
5584 * [The "Unstable Book" documents nightly-only features][ubook]
5585 * [Improve the style of the sidebar in rustdoc output][40265]
5586 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5587 * [Fix MSP430 breakage due to `i128`][40257]
5588 * [Preliminary Solaris/SPARCv9 support][39903]
5589 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5590   run without installing the MSVC runtime.
5591 * [`rustdoc --test` includes file names in test names][39788]
5592 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5593   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5594 * [Initial support for `aarch64-unknown-freebsd`][39491]
5595 * [Initial support for `i686-unknown-netbsd`][39426]
5596 * [This release no longer includes the old makefile build system][39431]. Rust
5597   is built with a custom build system, written in Rust, and with Cargo.
5598 * [Add Debug implementations for libcollection structs][39002]
5599 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5600 * [`--test-threads=0` produces an error][38945]
5601 * [`rustup` installs documentation by default][40526]
5602 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5603   WinDbg and Visual Studio to improve the debugging experience.
5604
5605 Compatibility Notes
5606 -------------------
5607
5608 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5609   workaround, either use MSVC 2015 or run vcvars.bat.
5610 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5611   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5612   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5613   fix.
5614 * [`format!` and `Display::to_string` panic if an underlying formatting
5615   implementation returns an error][40117]. Previously the error was silently
5616   ignored. It is incorrect for `write_fmt` to return an error when writing
5617   to a string.
5618 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5619   crates were marked stable and could be accessed from the stable toolchain.
5620 * [Rust git source no longer includes vendored crates][39728]. Those that need
5621   to build with vendored crates should build from release tarballs.
5622 * [Fix inert attributes from `proc_macro_derives`][39572]
5623 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5624   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5625   build system.
5626 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5627   existing code generally ignores the type of dead-code unless a type-hint is
5628   provided; this can cause surprising inference interactions particularly around
5629   defaulting. The new code uniformly ignores the result type of dead-code.
5630 * [Tuple-struct constructors with private fields are no longer visible][38932]
5631 * [Lifetime parameters that do not appear in the arguments are now considered
5632   early-bound][38897], resolving a soundness bug (#[32330]). The
5633   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5634   April of 2016.
5635 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5636 * [Make transmuting from fn item types to pointer-sized types a hard
5637   error][34198]
5638
5639 [27787]: https://github.com/rust-lang/rust/issues/27787
5640 [32330]: https://github.com/rust-lang/rust/issues/32330
5641 [34198]: https://github.com/rust-lang/rust/pull/34198
5642 [38161]: https://github.com/rust-lang/rust/pull/38161
5643 [38368]: https://github.com/rust-lang/rust/pull/38368
5644 [38584]: https://github.com/rust-lang/rust/issues/38584
5645 [38661]: https://github.com/rust-lang/rust/pull/38661
5646 [38764]: https://github.com/rust-lang/rust/pull/38764
5647 [38864]: https://github.com/rust-lang/rust/issues/38864
5648 [38897]: https://github.com/rust-lang/rust/pull/38897
5649 [38921]: https://github.com/rust-lang/rust/pull/38921
5650 [38932]: https://github.com/rust-lang/rust/pull/38932
5651 [38945]: https://github.com/rust-lang/rust/pull/38945
5652 [38981]: https://github.com/rust-lang/rust/pull/38981
5653 [39002]: https://github.com/rust-lang/rust/pull/39002
5654 [39116]: https://github.com/rust-lang/rust/pull/39116
5655 [39193]: https://github.com/rust-lang/rust/pull/39193
5656 [39265]: https://github.com/rust-lang/rust/pull/39265
5657 [39356]: https://github.com/rust-lang/rust/pull/39356
5658 [39372]: https://github.com/rust-lang/rust/pull/39372
5659 [39426]: https://github.com/rust-lang/rust/pull/39426
5660 [39431]: https://github.com/rust-lang/rust/pull/39431
5661 [39438]: https://github.com/rust-lang/rust/pull/39438
5662 [39440]: https://github.com/rust-lang/rust/pull/39440
5663 [39485]: https://github.com/rust-lang/rust/pull/39485
5664 [39491]: https://github.com/rust-lang/rust/pull/39491
5665 [39518]: https://github.com/rust-lang/rust/pull/39518
5666 [39538]: https://github.com/rust-lang/rust/pull/39538
5667 [39572]: https://github.com/rust-lang/rust/pull/39572
5668 [39633]: https://github.com/rust-lang/rust/pull/39633
5669 [39642]: https://github.com/rust-lang/rust/pull/39642
5670 [39728]: https://github.com/rust-lang/rust/pull/39728
5671 [39761]: https://github.com/rust-lang/rust/pull/39761
5672 [39788]: https://github.com/rust-lang/rust/pull/39788
5673 [39793]: https://github.com/rust-lang/rust/pull/39793
5674 [39837]: https://github.com/rust-lang/rust/pull/39837
5675 [39843]: https://github.com/rust-lang/rust/pull/39843
5676 [39851]: https://github.com/rust-lang/rust/pull/39851
5677 [39903]: https://github.com/rust-lang/rust/pull/39903
5678 [39939]: https://github.com/rust-lang/rust/pull/39939
5679 [39953]: https://github.com/rust-lang/rust/pull/39953
5680 [39960]: https://github.com/rust-lang/rust/pull/39960
5681 [39990]: https://github.com/rust-lang/rust/pull/39990
5682 [39995]: https://github.com/rust-lang/rust/pull/39995
5683 [40008]: https://github.com/rust-lang/rust/pull/40008
5684 [40009]: https://github.com/rust-lang/rust/pull/40009
5685 [40027]: https://github.com/rust-lang/rust/pull/40027
5686 [40028]: https://github.com/rust-lang/rust/pull/40028
5687 [40037]: https://github.com/rust-lang/rust/pull/40037
5688 [40117]: https://github.com/rust-lang/rust/pull/40117
5689 [40166]: https://github.com/rust-lang/rust/pull/40166
5690 [40245]: https://github.com/rust-lang/rust/pull/40245
5691 [40257]: https://github.com/rust-lang/rust/pull/40257
5692 [40261]: https://github.com/rust-lang/rust/pull/40261
5693 [40265]: https://github.com/rust-lang/rust/pull/40265
5694 [40319]: https://github.com/rust-lang/rust/pull/40319
5695 [40336]: https://github.com/rust-lang/rust/pull/40336
5696 [40526]: https://github.com/rust-lang/rust/pull/40526
5697 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5698 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5699 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5700 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5701 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5702 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5703 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5704 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5705 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5706 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5707 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5708 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5709 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5710 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5711 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5712 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5713 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5714 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5715 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5716 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5717 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5718 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5719 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5720 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5721 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5722 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5723 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5724 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5725 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5726 [mdbook]: https://crates.io/crates/mdbook
5727 [ubook]: https://doc.rust-lang.org/unstable-book/
5728
5729
5730 Version 1.16.0 (2017-03-16)
5731 ===========================
5732
5733 Language
5734 --------
5735
5736 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5737 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5738   match patterns][38069]
5739 * [Clean up semantics of `self` in an import list][38313]
5740 * [`Self` may appear in `impl` headers][38920]
5741 * [`Self` may appear in struct expressions][39282]
5742
5743 Compiler
5744 --------
5745
5746 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5747   a `.rmeta` file containing only crate metadata][38571]. This can be
5748   used by tools like the Rust Language Service to perform
5749   metadata-only builds.
5750 * [Levenshtein based typo suggestions now work in most places, while
5751   previously they worked only for fields and sometimes for local
5752   variables][38927]. Together with the overhaul of "no
5753   resolution"/"unexpected resolution" errors (#[38154]) they result in
5754   large and systematic improvement in resolution diagnostics.
5755 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5756   `U`][38670]
5757 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5758 * [`rustc` no longer attempts to provide "consider using an explicit
5759   lifetime" suggestions][37057]. They were inaccurate.
5760
5761 Stabilized APIs
5762 ---------------
5763
5764 * [`VecDeque::truncate`]
5765 * [`VecDeque::resize`]
5766 * [`String::insert_str`]
5767 * [`Duration::checked_add`]
5768 * [`Duration::checked_sub`]
5769 * [`Duration::checked_div`]
5770 * [`Duration::checked_mul`]
5771 * [`str::replacen`]
5772 * [`str::repeat`]
5773 * [`SocketAddr::is_ipv4`]
5774 * [`SocketAddr::is_ipv6`]
5775 * [`IpAddr::is_ipv4`]
5776 * [`IpAddr::is_ipv6`]
5777 * [`Vec::dedup_by`]
5778 * [`Vec::dedup_by_key`]
5779 * [`Result::unwrap_or_default`]
5780 * [`<*const T>::wrapping_offset`]
5781 * [`<*mut T>::wrapping_offset`]
5782 * `CommandExt::creation_flags`
5783 * [`File::set_permissions`]
5784 * [`String::split_off`]
5785
5786 Libraries
5787 ---------
5788
5789 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5790   their argument by `Borrow` parameter][37761]
5791 * [All public types in std implement `Debug`][38006]
5792 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5793 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5794 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5795   Windows][38274]
5796 * [std: Fix partial writes in `LineWriter`][38062]
5797 * [std: Clamp max read/write sizes on Unix][38062]
5798 * [Use more specific panic message for `&str` slicing errors][38066]
5799 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5800   functionality cannot be achieved in std currently.
5801 * [`writeln!`, like `println!`, now accepts a form with no string
5802   or formatting arguments, to just print a newline][38469]
5803 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5804 * [Reduce the size of static data in `std_unicode::tables`][38781]
5805 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5806   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5807   `Display`][38909]
5808 * [`Duration` implements `Sum`][38712]
5809 * [`String` implements `ToSocketAddrs`][39048]
5810
5811 Cargo
5812 -----
5813
5814 * [The `cargo check` command does a type check of a project without
5815   building it][cargo/3296]
5816 * [crates.io will display CI badges from Travis and AppVeyor, if
5817   specified in Cargo.toml][cargo/3546]
5818 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5819 * [Compilation profiles accept integer values for `debug`, in addition
5820   to `true` and `false`. These are passed to `rustc` as the value to
5821   `-C debuginfo`][cargo/3534]
5822 * [Implement `cargo --version --verbose`][cargo/3604]
5823 * [All builds now output 'dep-info' build dependencies compatible with
5824   make and ninja][cargo/3557]
5825 * [Build all workspace members with `build --all`][cargo/3511]
5826 * [Document all workspace members with `doc --all`][cargo/3515]
5827 * [Path deps outside workspace are not members][cargo/3443]
5828
5829 Misc
5830 ----
5831
5832 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5833   the path to the Rust implementation][38589]
5834 * [The `armv7-linux-androideabi` target no longer enables NEON
5835   extensions, per Google's ABI guide][38413]
5836 * [The stock standard library can be compiled for Redox OS][38401]
5837 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5838   available.
5839 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5840   builds available.
5841 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5842
5843 Compatibility Notes
5844 -------------------
5845
5846 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5847   match patterns][38069]
5848 * In this release, references to uninhabited types can not be
5849   pattern-matched. This was accidentally allowed in 1.15.
5850 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5851 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5852   Windows][38274]
5853 * [Clean up semantics of `self` in an import list][38313]
5854 * Reimplemented lifetime elision. This change was almost entirely compatible
5855   with existing code, but it did close a number of small bugs and loopholes,
5856   as well as being more accepting in some other [cases][41105].
5857
5858 [37057]: https://github.com/rust-lang/rust/pull/37057
5859 [37761]: https://github.com/rust-lang/rust/pull/37761
5860 [38006]: https://github.com/rust-lang/rust/pull/38006
5861 [38051]: https://github.com/rust-lang/rust/pull/38051
5862 [38062]: https://github.com/rust-lang/rust/pull/38062
5863 [38062]: https://github.com/rust-lang/rust/pull/38622
5864 [38066]: https://github.com/rust-lang/rust/pull/38066
5865 [38069]: https://github.com/rust-lang/rust/pull/38069
5866 [38131]: https://github.com/rust-lang/rust/pull/38131
5867 [38154]: https://github.com/rust-lang/rust/pull/38154
5868 [38274]: https://github.com/rust-lang/rust/pull/38274
5869 [38304]: https://github.com/rust-lang/rust/pull/38304
5870 [38313]: https://github.com/rust-lang/rust/pull/38313
5871 [38314]: https://github.com/rust-lang/rust/pull/38314
5872 [38327]: https://github.com/rust-lang/rust/pull/38327
5873 [38401]: https://github.com/rust-lang/rust/pull/38401
5874 [38413]: https://github.com/rust-lang/rust/pull/38413
5875 [38469]: https://github.com/rust-lang/rust/pull/38469
5876 [38559]: https://github.com/rust-lang/rust/pull/38559
5877 [38571]: https://github.com/rust-lang/rust/pull/38571
5878 [38580]: https://github.com/rust-lang/rust/pull/38580
5879 [38589]: https://github.com/rust-lang/rust/pull/38589
5880 [38670]: https://github.com/rust-lang/rust/pull/38670
5881 [38712]: https://github.com/rust-lang/rust/pull/38712
5882 [38726]: https://github.com/rust-lang/rust/pull/38726
5883 [38781]: https://github.com/rust-lang/rust/pull/38781
5884 [38798]: https://github.com/rust-lang/rust/pull/38798
5885 [38909]: https://github.com/rust-lang/rust/pull/38909
5886 [38920]: https://github.com/rust-lang/rust/pull/38920
5887 [38927]: https://github.com/rust-lang/rust/pull/38927
5888 [39048]: https://github.com/rust-lang/rust/pull/39048
5889 [39282]: https://github.com/rust-lang/rust/pull/39282
5890 [39379]: https://github.com/rust-lang/rust/pull/39379
5891 [41105]: https://github.com/rust-lang/rust/issues/41105
5892 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5893 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5894 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5895 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5896 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5897 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5898 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5899 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5900 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5901 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5902 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5903 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5904 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5905 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5906 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5907 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5908 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5909 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5910 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5911 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5912 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5913 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5914 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5915 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5916 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5917 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5918 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5919 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5920 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5921 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5922
5923
5924 Version 1.15.1 (2017-02-09)
5925 ===========================
5926
5927 * [Fix IntoIter::as_mut_slice's signature][39466]
5928 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5929
5930 [39466]: https://github.com/rust-lang/rust/pull/39466
5931 [39523]: https://github.com/rust-lang/rust/pull/39523
5932
5933
5934 Version 1.15.0 (2017-02-02)
5935 ===========================
5936
5937 Language
5938 --------
5939
5940 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5941   stable. This allows popular code-generating crates like Serde and Diesel to
5942   work ergonomically. [RFC 1681].
5943 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5944   with curly braces][36868]. Part of [RFC 1506].
5945 * [A number of minor changes to name resolution have been activated][37127].
5946   They add up to more consistent semantics, allowing for future evolution of
5947   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5948   details of what is different. The breaking changes here have been transitioned
5949   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5950 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5951   bounds][38279]
5952 * [`?Sized` can be used in `where` clauses][37791]
5953 * [There is now a limit on the size of monomorphized types and it can be
5954   modified with the `#![type_size_limit]` crate attribute, similarly to
5955   the `#![recursion_limit]` attribute][37789]
5956
5957 Compiler
5958 --------
5959
5960 * [On Windows, the compiler will apply dllimport attributes when linking to
5961   extern functions][37973]. Additional attributes and flags can control which
5962   library kind is linked and its name. [RFC 1717].
5963 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5964 * [The `--test` flag works with procedural macro crates][38107]
5965 * [Fix `extern "aapcs" fn` ABI][37814]
5966 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5967 * [The `format!` expander recognizes incorrect `printf` and shell-style
5968   formatting directives and suggests the correct format][37613].
5969 * [Only report one error for all unused imports in an import list][37456]
5970
5971 Compiler Performance
5972 --------------------
5973
5974 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5975 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5976 * [Don't clone in `UnificationTable::probe`][37848]
5977 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5978 * [Use small vectors in type walker][37760]
5979 * [Macro expansion performance was improved][37701]
5980 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5981 * [Replace FNV with a faster hash function][37229]
5982
5983 Stabilized APIs
5984 ---------------
5985
5986 * [`std::iter::Iterator::min_by`]
5987 * [`std::iter::Iterator::max_by`]
5988 * [`std::os::*::fs::FileExt`]
5989 * [`std::sync::atomic::Atomic*::get_mut`]
5990 * [`std::sync::atomic::Atomic*::into_inner`]
5991 * [`std::vec::IntoIter::as_slice`]
5992 * [`std::vec::IntoIter::as_mut_slice`]
5993 * [`std::sync::mpsc::Receiver::try_iter`]
5994 * [`std::os::unix::process::CommandExt::before_exec`]
5995 * [`std::rc::Rc::strong_count`]
5996 * [`std::rc::Rc::weak_count`]
5997 * [`std::sync::Arc::strong_count`]
5998 * [`std::sync::Arc::weak_count`]
5999 * [`std::char::encode_utf8`]
6000 * [`std::char::encode_utf16`]
6001 * [`std::cell::Ref::clone`]
6002 * [`std::io::Take::into_inner`]
6003
6004 Libraries
6005 ---------
6006
6007 * [The standard sorting algorithm has been rewritten for dramatic performance
6008   improvements][38192]. It is a hybrid merge sort, drawing influences from
6009   Timsort. Previously it was a naive merge sort.
6010 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6011 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6012   performance.
6013 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6014   and `char_indices().last()`][37882]
6015 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6016 * [Chinese characters display correctly in `fmt::Debug`][37855]
6017 * [Derive `Default` for `Duration`][37699]
6018 * [Support creation of anonymous pipes on WinXP/2k][37677]
6019 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6020 * [Don't pass overlapped handles to processes][38835]
6021
6022 Cargo
6023 -----
6024
6025 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6026   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6027   should instead check the variable at runtime with `std::env`. That the value
6028   was set at build time was a bug, and incorrect when cross-compiling. This
6029   change is known to cause breakage.
6030 * [Add `--all` flag to `cargo test`][cargo/3221]
6031 * [Compile statically against the MSVC CRT][cargo/3363]
6032 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6033 * [Link OpenSSL statically on OSX][cargo/3311]
6034 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6035 * [Test for bad path overrides with summaries][cargo/3336]
6036 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6037 * [Fix retrying crate downloads for network errors][cargo/3348]
6038 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6039 * [Emit more info on --message-format=json][cargo/3319]
6040 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6041 * [Don't ignore errors in workspace manifest][cargo/3409]
6042 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6043
6044 Tooling
6045 -------
6046
6047 * [Test runners (binaries built with `--test`) now support a `--list` argument
6048   that lists the tests it contains][38185]
6049 * [Test runners now support a `--exact` argument that makes the test filter
6050   match exactly, instead of matching only a substring of the test name][38181]
6051 * [rustdoc supports a `--playground-url` flag][37763]
6052 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6053
6054 Misc
6055 ----
6056
6057 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6058   continue to be used in this release by passing `--disable-rustbuild` to the
6059   configure script, but they will be deleted soon. Note that the new build
6060   system uses a different on-disk layout that will likely affect any scripts
6061   building Rust.
6062 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6063   releases.
6064 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6065 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6066   releases.
6067
6068 Compatibility Notes
6069 -------------------
6070
6071 * [A number of minor changes to name resolution have been activated][37127].
6072   They add up to more consistent semantics, allowing for future evolution of
6073   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6074   details of what is different. The breaking changes here have been transitioned
6075   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6076 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6077   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6078   should instead check the variable at runtime with `std::env`. That the value
6079   was set at build time was a bug, and incorrect when cross-compiling. This
6080   change is known to cause breakage.
6081 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6082   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6083   1.10 and is now an error by default. It will become a hard error in the near
6084   future.
6085 * [The semantics relating modules to file system directories are changing in
6086   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6087   lint, which is a warning in this release, and will become a hard error in the
6088   future.
6089 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6090 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6091   the underlying iterator][37834]
6092
6093 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6094 [33685]: https://github.com/rust-lang/rust/issues/33685
6095 [36868]: https://github.com/rust-lang/rust/pull/36868
6096 [37127]: https://github.com/rust-lang/rust/pull/37127
6097 [37229]: https://github.com/rust-lang/rust/pull/37229
6098 [37456]: https://github.com/rust-lang/rust/pull/37456
6099 [37527]: https://github.com/rust-lang/rust/pull/37527
6100 [37602]: https://github.com/rust-lang/rust/pull/37602
6101 [37613]: https://github.com/rust-lang/rust/pull/37613
6102 [37615]: https://github.com/rust-lang/rust/pull/37615
6103 [37636]: https://github.com/rust-lang/rust/pull/37636
6104 [37627]: https://github.com/rust-lang/rust/pull/37627
6105 [37642]: https://github.com/rust-lang/rust/pull/37642
6106 [37677]: https://github.com/rust-lang/rust/pull/37677
6107 [37699]: https://github.com/rust-lang/rust/pull/37699
6108 [37701]: https://github.com/rust-lang/rust/pull/37701
6109 [37705]: https://github.com/rust-lang/rust/pull/37705
6110 [37749]: https://github.com/rust-lang/rust/pull/37749
6111 [37760]: https://github.com/rust-lang/rust/pull/37760
6112 [37763]: https://github.com/rust-lang/rust/pull/37763
6113 [37764]: https://github.com/rust-lang/rust/pull/37764
6114 [37789]: https://github.com/rust-lang/rust/pull/37789
6115 [37791]: https://github.com/rust-lang/rust/pull/37791
6116 [37814]: https://github.com/rust-lang/rust/pull/37814
6117 [37817]: https://github.com/rust-lang/rust/pull/37817
6118 [37834]: https://github.com/rust-lang/rust/pull/37834
6119 [37848]: https://github.com/rust-lang/rust/pull/37848
6120 [37855]: https://github.com/rust-lang/rust/pull/37855
6121 [37882]: https://github.com/rust-lang/rust/pull/37882
6122 [37888]: https://github.com/rust-lang/rust/pull/37888
6123 [37973]: https://github.com/rust-lang/rust/pull/37973
6124 [37979]: https://github.com/rust-lang/rust/pull/37979
6125 [38086]: https://github.com/rust-lang/rust/pull/38086
6126 [38107]: https://github.com/rust-lang/rust/pull/38107
6127 [38117]: https://github.com/rust-lang/rust/pull/38117
6128 [38134]: https://github.com/rust-lang/rust/pull/38134
6129 [38146]: https://github.com/rust-lang/rust/pull/38146
6130 [38181]: https://github.com/rust-lang/rust/pull/38181
6131 [38182]: https://github.com/rust-lang/rust/pull/38182
6132 [38185]: https://github.com/rust-lang/rust/pull/38185
6133 [38192]: https://github.com/rust-lang/rust/pull/38192
6134 [38279]: https://github.com/rust-lang/rust/pull/38279
6135 [38835]: https://github.com/rust-lang/rust/pull/38835
6136 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6137 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6138 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6139 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6140 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6141 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6142 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6143 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6144 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6145 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6146 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6147 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6148 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6149 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6150 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6151 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6152 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6153 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6154 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6155 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6156 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6157 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6158 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6159 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6160 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6161 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6162 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6163 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6164 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6165 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6166 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6167 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6168 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6169 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6170 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6171 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6172 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6173 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6174
6175
6176 Version 1.14.0 (2016-12-22)
6177 ===========================
6178
6179 Language
6180 --------
6181
6182 * [`..` matches multiple tuple fields in enum variants, structs
6183   and tuples][36843]. [RFC 1492].
6184 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6185 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6186 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6187   dereferencing][36822]
6188
6189 Compiler
6190 --------
6191
6192 * [Mark enums with non-zero discriminant as non-zero][37224]
6193 * [Lower-case `static mut` names are linted like other
6194   statics and consts][37162]
6195 * [Fix ICE on some macros in const integer positions
6196    (e.g. `[u8; m!()]`)][36819]
6197 * [Improve error message and snippet for "did you mean `x`"][36798]
6198 * [Add a panic-strategy field to the target specification][36794]
6199 * [Include LLVM version in `--version --verbose`][37200]
6200
6201 Compile-time Optimizations
6202 --------------------------
6203
6204 * [Improve macro expansion performance][37569]
6205 * [Shrink `Expr_::ExprInlineAsm`][37445]
6206 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6207 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6208 * [Avoid more allocations when compiling html5ever][37373]
6209 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6210 * [Avoid some allocations in the macro parser][37318]
6211 * [Use a faster deflate setting][37298]
6212 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6213   during interning of slices][37270]
6214 * [Optimize `write_metadata`][37267]
6215 * [Don't process obligation forest cycles when stalled][37231]
6216 * [Avoid many `CrateConfig` clones][37161]
6217 * [Optimize `Substs::super_fold_with`][37108]
6218 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6219 * [Speed up `plug_leaks`][36917]
6220
6221 Libraries
6222 ---------
6223
6224 * [`println!()`, with no arguments, prints newline][36825].
6225   Previously, an empty string was required to achieve the same.
6226 * [`Wrapping` impls standard binary and unary operators, as well as
6227    the `Sum` and `Product` iterators][37356]
6228 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6229   Vec<T>`][37326]
6230 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6231   `VecDeque` iterators][37315]
6232 * [Improve `SipHasher` performance on small values][37312]
6233 * [Add Iterator trait TrustedLen to enable better FromIterator /
6234   Extend][37306]
6235 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6236 * [`ReadDir` implements `Debug`][37221]
6237 * [Implement `RefUnwindSafe` for atomic types][37178]
6238 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6239 * [Avoid allocations in `Decoder::read_str`][37064]
6240 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6241 * [Impl `Debug` for raw pointers to unsized data][36880]
6242 * [Don't reuse `HashMap` random seeds][37470]
6243 * [The internal memory layout of `HashMap` is more cache-friendly, for
6244   significant improvements in some operations][36692]
6245 * [`HashMap` uses less memory on 32-bit architectures][36595]
6246 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6247
6248 Cargo
6249 -----
6250
6251 * [Expose rustc cfg values to build scripts][cargo/3243]
6252 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6253 * [Fix passing --features when testing multiple packages][cargo/3280]
6254 * [Use a single profile set per workspace][cargo/3249]
6255 * [Load `replace` sections from lock files][cargo/3220]
6256 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6257
6258 Tooling
6259 -------
6260
6261 * [rustup is the recommended Rust installation method][1.14rustup]
6262 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6263   S390x. These are [tier 2] platforms and may have major defects. Follow the
6264   instructions on the website to install, or add the targets to an existing
6265   installation with `rustup target add`. The new target triples are:
6266   - `mips-unknown-linux-gnu`
6267   - `mipsel-unknown-linux-gnu`
6268   - `mips64-unknown-linux-gnuabi64`
6269   - `mips64el-unknown-linux-gnuabi64 `
6270   - `powerpc-unknown-linux-gnu`
6271   - `powerpc64-unknown-linux-gnu`
6272   - `powerpc64le-unknown-linux-gnu`
6273   - `s390x-unknown-linux-gnu `
6274 * This release includes target (std) builds for ARM Linux running MUSL
6275   libc. These are [tier 2] platforms and may have major defects. Add the
6276   following triples to an existing rustup installation with `rustup target add`:
6277   - `arm-unknown-linux-musleabi`
6278   - `arm-unknown-linux-musleabihf`
6279   - `armv7-unknown-linux-musleabihf`
6280 * This release includes [experimental support for WebAssembly][1.14wasm], via
6281   the `wasm32-unknown-emscripten` target. This target is known to have major
6282   defects. Please test, report, and fix.
6283 * rustup no longer installs documentation by default. Run `rustup
6284   component add rust-docs` to install.
6285 * [Fix line stepping in debugger][37310]
6286 * [Enable line number debuginfo in releases][37280]
6287
6288 Misc
6289 ----
6290
6291 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6292 * [Add support for Fuchsia OS][37313]
6293 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6294
6295 Compatibility Notes
6296 -------------------
6297
6298 * [A number of forward-compatibility lints used by the compiler
6299   to gradually introduce language changes have been converted
6300   to deny by default][36894]:
6301   - ["use of inaccessible extern crate erroneously allowed"][36886]
6302   - ["type parameter default erroneously allowed in invalid location"][36887]
6303   - ["detects super or self keywords at the beginning of global path"][36888]
6304   - ["two overlapping inherent impls define an item with the same name
6305     were erroneously allowed"][36889]
6306   - ["floating-point constants cannot be used in patterns"][36890]
6307   - ["constants of struct or enum type can only be used in a pattern if
6308      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6309   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6310 * [Prohibit patterns in trait methods without bodies][37378]
6311 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6312 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6313 * [The `$crate` macro variable is accepted in fewer locations][37213]
6314 * [Impls specifying extra region requirements beyond the trait
6315   they implement are rejected][37167]
6316 * [Enums may not be unsized][37111]. Unsized enums are intended to
6317   work but never have. For now they are forbidden.
6318 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6319
6320 [tier 2]: https://forge.rust-lang.org/platform-support.html
6321 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6322 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6323 [36430]: https://github.com/rust-lang/rust/pull/36430
6324 [36595]: https://github.com/rust-lang/rust/pull/36595
6325 [36595]: https://github.com/rust-lang/rust/pull/36595
6326 [36692]: https://github.com/rust-lang/rust/pull/36692
6327 [36767]: https://github.com/rust-lang/rust/pull/36767
6328 [36794]: https://github.com/rust-lang/rust/pull/36794
6329 [36798]: https://github.com/rust-lang/rust/pull/36798
6330 [36819]: https://github.com/rust-lang/rust/pull/36819
6331 [36822]: https://github.com/rust-lang/rust/pull/36822
6332 [36825]: https://github.com/rust-lang/rust/pull/36825
6333 [36843]: https://github.com/rust-lang/rust/pull/36843
6334 [36880]: https://github.com/rust-lang/rust/pull/36880
6335 [36886]: https://github.com/rust-lang/rust/issues/36886
6336 [36887]: https://github.com/rust-lang/rust/issues/36887
6337 [36888]: https://github.com/rust-lang/rust/issues/36888
6338 [36889]: https://github.com/rust-lang/rust/issues/36889
6339 [36890]: https://github.com/rust-lang/rust/issues/36890
6340 [36891]: https://github.com/rust-lang/rust/issues/36891
6341 [36892]: https://github.com/rust-lang/rust/issues/36892
6342 [36894]: https://github.com/rust-lang/rust/pull/36894
6343 [36917]: https://github.com/rust-lang/rust/pull/36917
6344 [36993]: https://github.com/rust-lang/rust/pull/36993
6345 [37037]: https://github.com/rust-lang/rust/pull/37037
6346 [37064]: https://github.com/rust-lang/rust/pull/37064
6347 [37094]: https://github.com/rust-lang/rust/pull/37094
6348 [37108]: https://github.com/rust-lang/rust/pull/37108
6349 [37111]: https://github.com/rust-lang/rust/pull/37111
6350 [37161]: https://github.com/rust-lang/rust/pull/37161
6351 [37162]: https://github.com/rust-lang/rust/pull/37162
6352 [37167]: https://github.com/rust-lang/rust/pull/37167
6353 [37178]: https://github.com/rust-lang/rust/pull/37178
6354 [37200]: https://github.com/rust-lang/rust/pull/37200
6355 [37213]: https://github.com/rust-lang/rust/pull/37213
6356 [37221]: https://github.com/rust-lang/rust/pull/37221
6357 [37224]: https://github.com/rust-lang/rust/pull/37224
6358 [37230]: https://github.com/rust-lang/rust/pull/37230
6359 [37231]: https://github.com/rust-lang/rust/pull/37231
6360 [37247]: https://github.com/rust-lang/rust/pull/37247
6361 [37267]: https://github.com/rust-lang/rust/pull/37267
6362 [37270]: https://github.com/rust-lang/rust/pull/37270
6363 [37273]: https://github.com/rust-lang/rust/pull/37273
6364 [37280]: https://github.com/rust-lang/rust/pull/37280
6365 [37298]: https://github.com/rust-lang/rust/pull/37298
6366 [37306]: https://github.com/rust-lang/rust/pull/37306
6367 [37310]: https://github.com/rust-lang/rust/pull/37310
6368 [37312]: https://github.com/rust-lang/rust/pull/37312
6369 [37313]: https://github.com/rust-lang/rust/pull/37313
6370 [37315]: https://github.com/rust-lang/rust/pull/37315
6371 [37318]: https://github.com/rust-lang/rust/pull/37318
6372 [37322]: https://github.com/rust-lang/rust/pull/37322
6373 [37326]: https://github.com/rust-lang/rust/pull/37326
6374 [37351]: https://github.com/rust-lang/rust/pull/37351
6375 [37356]: https://github.com/rust-lang/rust/pull/37356
6376 [37367]: https://github.com/rust-lang/rust/pull/37367
6377 [37373]: https://github.com/rust-lang/rust/pull/37373
6378 [37378]: https://github.com/rust-lang/rust/pull/37378
6379 [37389]: https://github.com/rust-lang/rust/pull/37389
6380 [37392]: https://github.com/rust-lang/rust/pull/37392
6381 [37427]: https://github.com/rust-lang/rust/pull/37427
6382 [37439]: https://github.com/rust-lang/rust/pull/37439
6383 [37445]: https://github.com/rust-lang/rust/pull/37445
6384 [37470]: https://github.com/rust-lang/rust/pull/37470
6385 [37569]: https://github.com/rust-lang/rust/pull/37569
6386 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6387 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6388 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6389 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6390 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6391 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6392 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6393
6394
6395 Version 1.13.0 (2016-11-10)
6396 ===========================
6397
6398 Language
6399 --------
6400
6401 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6402   errors, like the `try!` macro, described in [RFC 0243].
6403 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6404 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6405 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6406 * [Fix lifetime rules for 'if' conditions][36029]
6407 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6408
6409 Compiler
6410 --------
6411
6412 * [Add the `-C link-arg` argument][36574]
6413 * [Remove the old AST-based backend from rustc_trans][35764]
6414 * [Don't enable NEON by default on armv7 Linux][35814]
6415 * [Fix debug line number info for macro expansions][35238]
6416 * [Do not emit "class method" debuginfo for types that are not
6417   DICompositeType][36008]
6418 * [Warn about multiple conflicting #[repr] hints][34623]
6419 * [When sizing DST, don't double-count nested struct prefixes][36351]
6420 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6421 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6422 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6423 * [Expand macros without recursing to avoid stack overflows][36214]
6424
6425 Diagnostics
6426 -----------
6427
6428 * [Replace macro backtraces with labeled local uses][35702]
6429 * [Improve error message for misplaced doc comments][33922]
6430 * [Buffer unix and lock windows to prevent message interleaving][35975]
6431 * [Update lifetime errors to specifically note temporaries][36171]
6432 * [Special case a few colors for Windows][36178]
6433 * [Suggest `use self` when such an import resolves][36289]
6434 * [Be more specific when type parameter shadows primitive type][36338]
6435 * Many minor improvements
6436
6437 Compile-time Optimizations
6438 --------------------------
6439
6440 * [Compute and cache HIR hashes at beginning][35854]
6441 * [Don't hash types in loan paths][36004]
6442 * [Cache projections in trans][35761]
6443 * [Optimize the parser's last token handling][36527]
6444 * [Only instantiate #[inline] functions in codegen units referencing
6445   them][36524]. This leads to big improvements in cases where crates export
6446   define many inline functions without using them directly.
6447 * [Lazily allocate TypedArena's first chunk][36592]
6448 * [Don't allocate during default HashSet creation][36734]
6449
6450 Stabilized APIs
6451 ---------------
6452
6453 * [`checked_abs`]
6454 * [`wrapping_abs`]
6455 * [`overflowing_abs`]
6456 * [`RefCell::try_borrow`]
6457 * [`RefCell::try_borrow_mut`]
6458
6459 Libraries
6460 ---------
6461
6462 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6463 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6464   covariant][35354]
6465 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6466 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6467 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6468 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6469 * [Use arc4rand on FreeBSD][35884]
6470 * [memrchr: Correct aligned offset computation][35969]
6471 * [Improve Demangling of Rust Symbols][36059]
6472 * [Use monotonic time in condition variables][35048]
6473 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6474 * [Implement conversion traits for `char`][35755]
6475 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6476 * [Zero first byte of CString on drop][36264]
6477 * [Inherit overflow checks for sum and product][36372]
6478 * [Add missing Eq implementations][36423]
6479 * [Implement `Debug` for `DirEntry`][36631]
6480 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6481   `errno`][36754]
6482 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6483 * [Implement more traits for `std::io::ErrorKind`][35911]
6484 * [Optimize BinaryHeap bounds checking][36072]
6485 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6486   `extend_with_element`][36355]
6487 * [Fix overflow checking in unsigned pow()][34942]
6488
6489 Cargo
6490 -----
6491
6492 * This release includes security fixes to both curl and OpenSSL.
6493 * [Fix transitive doctests when panic=abort][cargo/3021]
6494 * [Add --all-features flag to cargo][cargo/3038]
6495 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6496 * [Don't parse the home directory more than once][cargo/3078]
6497 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6498 * [Update OpenSSL to 1.0.2j][cargo/3121]
6499 * [Add license and license_file to cargo metadata output][cargo/3110]
6500 * [Make crates-io registry URL optional in config; ignore all changes to
6501   source.crates-io][cargo/3089]
6502 * [Don't download dependencies from other platforms][cargo/3123]
6503 * [Build transitive dev-dependencies when needed][cargo/3125]
6504 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6505 * [Avoid updating registry when adding existing deps][cargo/3144]
6506 * [Warn about path overrides that won't work][cargo/3136]
6507 * [Use workspaces during `cargo install`][cargo/3146]
6508 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6509 * [Add --message-format flag][cargo/3000]
6510 * [Pass target environment for rustdoc][cargo/3205]
6511 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6512 * [Update curl and curl-sys][cargo/3241]
6513 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6514
6515 Tooling
6516 -------
6517
6518 * [rustdoc: Add the `--sysroot` argument][36586]
6519 * [rustdoc: Fix a couple of issues with the search results][35655]
6520 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6521 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6522 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6523
6524 Misc
6525 ----
6526
6527 * [Remove unmaintained style guide][35124]
6528 * [Add s390x support][36369]
6529 * [Initial work at Haiku OS support][36727]
6530 * [Add mips-uclibc targets][35734]
6531 * [Crate-ify compiler-rt into compiler-builtins][35021]
6532 * [Add rustc version info (git hash + date) to dist tarball][36213]
6533 * Many documentation improvements
6534
6535 Compatibility Notes
6536 -------------------
6537
6538 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6539 * [Deny (by default) transmuting from fn item types to pointer-sized
6540   types][34923]. Continuing the long transition to zero-sized fn items,
6541   per [RFC 401].
6542 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6543   Part of [RFC 1506].
6544 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6545 * [Fix lifetime rules for 'if' conditions][36029].
6546 * [Inherit overflow checks for sum and product][36372].
6547 * [Forbid user-defined macros named "macro_rules"][36730].
6548
6549 [33922]: https://github.com/rust-lang/rust/pull/33922
6550 [34623]: https://github.com/rust-lang/rust/pull/34623
6551 [34923]: https://github.com/rust-lang/rust/pull/34923
6552 [34942]: https://github.com/rust-lang/rust/pull/34942
6553 [34982]: https://github.com/rust-lang/rust/pull/34982
6554 [35021]: https://github.com/rust-lang/rust/pull/35021
6555 [35048]: https://github.com/rust-lang/rust/pull/35048
6556 [35074]: https://github.com/rust-lang/rust/pull/35074
6557 [35124]: https://github.com/rust-lang/rust/pull/35124
6558 [35234]: https://github.com/rust-lang/rust/pull/35234
6559 [35238]: https://github.com/rust-lang/rust/pull/35238
6560 [35354]: https://github.com/rust-lang/rust/pull/35354
6561 [35559]: https://github.com/rust-lang/rust/pull/35559
6562 [35585]: https://github.com/rust-lang/rust/pull/35585
6563 [35627]: https://github.com/rust-lang/rust/pull/35627
6564 [35655]: https://github.com/rust-lang/rust/pull/35655
6565 [35702]: https://github.com/rust-lang/rust/pull/35702
6566 [35707]: https://github.com/rust-lang/rust/pull/35707
6567 [35728]: https://github.com/rust-lang/rust/pull/35728
6568 [35734]: https://github.com/rust-lang/rust/pull/35734
6569 [35755]: https://github.com/rust-lang/rust/pull/35755
6570 [35761]: https://github.com/rust-lang/rust/pull/35761
6571 [35764]: https://github.com/rust-lang/rust/pull/35764
6572 [35814]: https://github.com/rust-lang/rust/pull/35814
6573 [35854]: https://github.com/rust-lang/rust/pull/35854
6574 [35871]: https://github.com/rust-lang/rust/pull/35871
6575 [35884]: https://github.com/rust-lang/rust/pull/35884
6576 [35911]: https://github.com/rust-lang/rust/pull/35911
6577 [35969]: https://github.com/rust-lang/rust/pull/35969
6578 [35975]: https://github.com/rust-lang/rust/pull/35975
6579 [36004]: https://github.com/rust-lang/rust/pull/36004
6580 [36008]: https://github.com/rust-lang/rust/pull/36008
6581 [36014]: https://github.com/rust-lang/rust/pull/36014
6582 [36029]: https://github.com/rust-lang/rust/pull/36029
6583 [36059]: https://github.com/rust-lang/rust/pull/36059
6584 [36072]: https://github.com/rust-lang/rust/pull/36072
6585 [36101]: https://github.com/rust-lang/rust/pull/36101
6586 [36104]: https://github.com/rust-lang/rust/pull/36104
6587 [36171]: https://github.com/rust-lang/rust/pull/36171
6588 [36173]: https://github.com/rust-lang/rust/pull/36173
6589 [36178]: https://github.com/rust-lang/rust/pull/36178
6590 [36213]: https://github.com/rust-lang/rust/pull/36213
6591 [36214]: https://github.com/rust-lang/rust/pull/36214
6592 [36264]: https://github.com/rust-lang/rust/pull/36264
6593 [36266]: https://github.com/rust-lang/rust/pull/36266
6594 [36289]: https://github.com/rust-lang/rust/pull/36289
6595 [36338]: https://github.com/rust-lang/rust/pull/36338
6596 [36351]: https://github.com/rust-lang/rust/pull/36351
6597 [36355]: https://github.com/rust-lang/rust/pull/36355
6598 [36369]: https://github.com/rust-lang/rust/pull/36369
6599 [36372]: https://github.com/rust-lang/rust/pull/36372
6600 [36423]: https://github.com/rust-lang/rust/pull/36423
6601 [36482]: https://github.com/rust-lang/rust/pull/36482
6602 [36505]: https://github.com/rust-lang/rust/pull/36505
6603 [36524]: https://github.com/rust-lang/rust/pull/36524
6604 [36527]: https://github.com/rust-lang/rust/pull/36527
6605 [36551]: https://github.com/rust-lang/rust/pull/36551
6606 [36574]: https://github.com/rust-lang/rust/pull/36574
6607 [36586]: https://github.com/rust-lang/rust/pull/36586
6608 [36592]: https://github.com/rust-lang/rust/pull/36592
6609 [36631]: https://github.com/rust-lang/rust/pull/36631
6610 [36639]: https://github.com/rust-lang/rust/pull/36639
6611 [36721]: https://github.com/rust-lang/rust/pull/36721
6612 [36727]: https://github.com/rust-lang/rust/pull/36727
6613 [36730]: https://github.com/rust-lang/rust/pull/36730
6614 [36734]: https://github.com/rust-lang/rust/pull/36734
6615 [36754]: https://github.com/rust-lang/rust/pull/36754
6616 [36995]: https://github.com/rust-lang/rust/pull/36995
6617 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6618 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6619 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6620 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6621 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6622 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6623 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6624 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6625 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6626 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6627 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6628 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6629 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6630 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6631 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6632 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6633 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6634 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6635 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6636 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6637 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6638 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6639 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6640 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6641 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6642 [rustup]: https://www.rustup.rs
6643 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6644 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6645 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6646 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6647 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6648 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6649 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6650
6651
6652 Version 1.12.1 (2016-10-20)
6653 ===========================
6654
6655 Regression Fixes
6656 ----------------
6657
6658 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6659 * [Confusion with double negation and booleans][36856]
6660 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6661 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6662 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6663 * [Corrupted memory after updated to 1.12][36936]
6664 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6665 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6666 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6667
6668 [36381]: https://github.com/rust-lang/rust/issues/36381
6669 [36856]: https://github.com/rust-lang/rust/issues/36856
6670 [36875]: https://github.com/rust-lang/rust/issues/36875
6671 [36924]: https://github.com/rust-lang/rust/issues/36924
6672 [36926]: https://github.com/rust-lang/rust/issues/36926
6673 [36936]: https://github.com/rust-lang/rust/issues/36936
6674 [37026]: https://github.com/rust-lang/rust/issues/37026
6675 [37112]: https://github.com/rust-lang/rust/issues/37112
6676 [37153]: https://github.com/rust-lang/rust/issues/37153
6677
6678
6679 Version 1.12.0 (2016-09-29)
6680 ===========================
6681
6682 Highlights
6683 ----------
6684
6685 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6686   This translation pass is far simpler than the previous AST->LLVM pass, and
6687   creates opportunities to perform new optimizations directly on the MIR. It
6688   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6689 * [`rustc` presents a new, more readable error format, along with
6690   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6691   Most common editors supporting Rust have been updated to work with it. It was
6692   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6693
6694 Compiler
6695 --------
6696
6697 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6698   This translation pass is far simpler than the previous AST->LLVM pass, and
6699   creates opportunities to perform new optimizations directly on the MIR. It
6700   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6701 * [Print the Rust target name, not the LLVM target name, with
6702   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6703 * [The computation of `TypeId` is correct in some cases where it was previously
6704   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6705 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6706 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6707   `--print relocation-models`, and `--print code-models` print the available
6708   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6709   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6710 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6711   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6712   These targets produce statically-linked binaries. There are no binary release
6713   builds yet though.
6714
6715 Diagnostics
6716 -----------
6717
6718 * [`rustc` presents a new, more readable error format, along with
6719   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6720   Most common editors supporting Rust have been updated to work with it. It was
6721   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6722 * [In error descriptions, references are now described in plain English,
6723   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6724 * [In error type descriptions, unknown numeric types are named `{integer}` or
6725   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6726 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6727
6728 Language
6729 --------
6730
6731 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6732 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6733 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6734   useful](https://github.com/rust-lang/rust/pull/34908)
6735 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6736   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6737 * [Semicolons are properly required as statement delimiters inside
6738   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6739 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6740
6741 Stabilized APIs
6742 ---------------
6743
6744 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6745 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6746 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6747 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6748 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6749 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6750 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6751 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6752 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6753 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6754   Both on Unix and Windows.
6755 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6756 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6757 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6758 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6759 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6760 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6761 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6762 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6763
6764 Libraries
6765 ---------
6766
6767 * [The `format!` macro and friends now allow a single argument to be formatted
6768   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6769 * [The lifetime bounds on `[T]::binary_search_by` and
6770   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6771 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6772 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6773 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6774 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6775 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6776 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6777 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6778 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6779   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6780 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6781   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6782 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6783 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6784   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6785 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6786 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6787 * [`mpsc::sync_channel` `Receiver`s return any available message before
6788   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6789 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6790 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6791
6792 Cargo
6793 -----
6794
6795 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6796 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6797 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6798 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6799 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6800 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6801 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6802 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6803 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6804 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6805 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6806 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6807 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6808 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6809 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6810 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6811
6812 Performance
6813 -----------
6814
6815 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6816 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6817
6818 Tooling
6819 -------
6820
6821 * [Test binaries now support a `--test-threads` argument to specify the number
6822   of threads used to run tests, and which acts the same as the
6823   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6824 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6825 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6826 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6827 * [Rust releases now come with source packages that can be installed by rustup
6828   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6829   The resulting source code can be used by tools and IDES, located in the
6830   sysroot under `lib/rustlib/src`.
6831
6832 Misc
6833 ----
6834
6835 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6836 * Many minor improvements to the documentation.
6837 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6838
6839 Compatibility Notes
6840 -------------------
6841
6842 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6843   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6844 * [When formatting strings, if "precision" is specified, the "fill",
6845   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6846 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6847
6848
6849 Version 1.11.0 (2016-08-18)
6850 ===========================
6851
6852 Language
6853 --------
6854
6855 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6856 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6857 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6858 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6859
6860 Stabilized APIs
6861 ---------------
6862
6863 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6864 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6865 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6866 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6867 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6868 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6869   (in libcore - previously stabilized in libstd)
6870 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6871   (in libcore - previously stabilized in libstd)
6872 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6873   (in libcore - previously stabilized in libstd)
6874 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6875   (in libcore - previously stabilized in libstd)
6876 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6877 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6878 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6879 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6880
6881 Libraries
6882 ---------
6883
6884 * [The `thread_local!` macro supports multiple definitions in a single
6885    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6886 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6887 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6888   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6889 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6890 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6891 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6892 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6893
6894 Cargo
6895 -----
6896
6897 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6898 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6899 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6900 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6901 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6902   and `-vv` prints warnings for all crates.
6903 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6904 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6905   This provides room for expansion by arbitrary tools.
6906 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6907 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6908 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6909 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6910 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6911 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6912 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6913
6914 Performance
6915 -----------
6916
6917 * [Caching projections speeds up type check dramatically for some
6918   workloads](https://github.com/rust-lang/rust/pull/33816)
6919 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6920   This hasher is faster, but is believed to provide sufficient
6921   protection from collision attacks.
6922 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6923
6924 Rustdoc
6925 -------
6926
6927 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6928 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6929 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6930 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6931 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6932
6933 Tooling
6934 -------
6935
6936 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6937 * [When emitting debug info, rustc emits frame pointers for closures,
6938   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6939 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6940 * Many more errors have been given error codes and extended
6941   explanations
6942 * API documentation continues to be improved, with many new examples
6943
6944 Misc
6945 ----
6946
6947 * [rustc no longer hangs when dependencies recursively re-export
6948   submodules](https://github.com/rust-lang/rust/pull/34542)
6949 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6950 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6951   rewritten](https://github.com/rust-lang/rust/pull/33895)
6952 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6953   No targets use this yet, but it works toward AVR support.
6954
6955 Compatibility Notes
6956 -------------------
6957
6958 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6959 * [The new follow-set rules that place restrictions on `macro_rules!`
6960   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6961   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6962   and has been a warning since 1.10.
6963 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6964   This causes breakage in some corner cases.
6965
6966
6967 Version 1.10.0 (2016-07-07)
6968 ===========================
6969
6970 Language
6971 --------
6972
6973 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6974   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6975 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6976 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6977 * [`panic!` can be converted to a runtime abort with the
6978   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6979   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6980 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6981   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6982   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6983   Note that Cargo does not yet directly support cdylibs.
6984
6985 Stabilized APIs
6986 ---------------
6987
6988 * `os::windows::fs::OpenOptionsExt::access_mode`
6989 * `os::windows::fs::OpenOptionsExt::share_mode`
6990 * `os::windows::fs::OpenOptionsExt::custom_flags`
6991 * `os::windows::fs::OpenOptionsExt::attributes`
6992 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6993 * `os::unix::fs::OpenOptionsExt::custom_flags`
6994 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6995 * `Default for sync::Weak`
6996 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6997 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6998 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6999 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
7000 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7001 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7002 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7003 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7004 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7005 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7006 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7007 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7008 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7009 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7010 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7011 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7012 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7013 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7014 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7015 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7016 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7017 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7018 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7019 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7020 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7021 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7022 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7023 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7024 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7025 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7026 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7027 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7028 * Read/Write/RawFd impls for `UnixStream`
7029 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7030 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7031 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7032 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7033 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7034 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7035 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7036 * RawFd impls for `UnixListener`
7037 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7038 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7039 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7040 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7041 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7042 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7043 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7044 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7045 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7046 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7047 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7048 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7049 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7050 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7051 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7052 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7053 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7054 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7055 * RawFd impls for `UnixDatagram`
7056 * `{BTree,Hash}Map::values_mut`
7057 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7058
7059 Libraries
7060 ---------
7061
7062 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7063   The semantics of this minor method are subtle and probably not what
7064   most people want.
7065 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7066 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7067   will fall back to `/dev/urandom` temporarily to avoid blocking
7068   during early boot](https://github.com/rust-lang/rust/pull/33086).
7069 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7070 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7071 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7072 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7073 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7074 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7075   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7076
7077 Cargo
7078 -----
7079 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7080   This controls the runtime behavior of the `panic!` macro
7081   and can be either "unwind" (the default), or "abort".
7082   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7083 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7084 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7085 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7086   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7087 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7088 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7089 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7090   By default they are retried twice, which can be customized with the
7091   `net.retry` value in `.cargo/config`.
7092 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7093 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7094 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7095 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7096   Makes it possible to install multiple crates in parallel.
7097 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7098 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7099 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7100 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7101 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7102 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7103
7104 Performance
7105 -----------
7106
7107 * [rustc memory usage was reduced by refactoring the context used for
7108   type checking](https://github.com/rust-lang/rust/pull/33425).
7109 * [Speed up creation of `HashMap`s by caching the random keys used
7110   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7111 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7112 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7113 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7114   10x faster than the previous lookup tables.
7115 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7116
7117 Usability
7118 ---------
7119
7120 * Many incremental improvements to documentation and rustdoc.
7121 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7122 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7123 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7124 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7125 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7126 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7127 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7128
7129 Misc
7130 ----
7131
7132 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7133 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7134 * [`std` no longer prints backtraces on platforms where the running
7135   module must be loaded with `env::current_exe`, which can't be relied
7136   on](https://github.com/rust-lang/rust/pull/33554).
7137 * This release includes std binaries for the i586-unknown-linux-gnu,
7138   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7139   i586 target is for old x86 hardware without SSE2, and the armv7
7140   target is for Android running on modern ARM architectures.
7141 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7142   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7143 * [On Unix the runtime aborts by calling `libc::abort` instead of
7144   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7145 * [Rust is now bootstrapped from the previous release of Rust,
7146   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7147
7148 Compatibility Notes
7149 -------------------
7150
7151 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7152 * [`target_env` for Linux ARM targets is just `gnu`, not
7153   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7154 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7155 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7156 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7157   Affects how macros are parsed.
7158 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7159 * [Feature-gated attributes on macro-generated macro invocations are
7160   now rejected](https://github.com/rust-lang/rust/pull/32791).
7161 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7162   This caused some minor changes to type inference.
7163
7164
7165 Version 1.9.0 (2016-05-26)
7166 ==========================
7167
7168 Language
7169 --------
7170
7171 * The `#[deprecated]` attribute when applied to an API will generate
7172   warnings when used. The warnings may be suppressed with
7173   `#[allow(deprecated)]`. [RFC 1270].
7174 * [`fn` item types are zero sized, and each `fn` names a unique
7175   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7176   `transmute` on a `fn` type will generate a warning for a few cycles,
7177   then will be converted to an error.
7178 * [Field and method resolution understand visibility, so private
7179   fields and methods cannot prevent the proper use of public fields
7180   and methods][1.9fv].
7181 * [The parser considers unicode codepoints in the
7182   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7183
7184 Stabilized APIs
7185 ---------------
7186
7187 * [`std::panic`]
7188 * [`std::panic::catch_unwind`] (renamed from `recover`)
7189 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7190 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7191 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7192 * [`str::is_char_boundary`]
7193 * [`<*const T>::as_ref`]
7194 * [`<*mut T>::as_ref`]
7195 * [`<*mut T>::as_mut`]
7196 * [`AsciiExt::make_ascii_uppercase`]
7197 * [`AsciiExt::make_ascii_lowercase`]
7198 * [`char::decode_utf16`]
7199 * [`char::DecodeUtf16`]
7200 * [`char::DecodeUtf16Error`]
7201 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7202 * [`BTreeSet::take`]
7203 * [`BTreeSet::replace`]
7204 * [`BTreeSet::get`]
7205 * [`HashSet::take`]
7206 * [`HashSet::replace`]
7207 * [`HashSet::get`]
7208 * [`OsString::with_capacity`]
7209 * [`OsString::clear`]
7210 * [`OsString::capacity`]
7211 * [`OsString::reserve`]
7212 * [`OsString::reserve_exact`]
7213 * [`OsStr::is_empty`]
7214 * [`OsStr::len`]
7215 * [`std::os::unix::thread`]
7216 * [`RawPthread`]
7217 * [`JoinHandleExt`]
7218 * [`JoinHandleExt::as_pthread_t`]
7219 * [`JoinHandleExt::into_pthread_t`]
7220 * [`HashSet::hasher`]
7221 * [`HashMap::hasher`]
7222 * [`CommandExt::exec`]
7223 * [`File::try_clone`]
7224 * [`SocketAddr::set_ip`]
7225 * [`SocketAddr::set_port`]
7226 * [`SocketAddrV4::set_ip`]
7227 * [`SocketAddrV4::set_port`]
7228 * [`SocketAddrV6::set_ip`]
7229 * [`SocketAddrV6::set_port`]
7230 * [`SocketAddrV6::set_flowinfo`]
7231 * [`SocketAddrV6::set_scope_id`]
7232 * [`slice::copy_from_slice`]
7233 * [`ptr::read_volatile`]
7234 * [`ptr::write_volatile`]
7235 * [`OpenOptions::create_new`]
7236 * [`TcpStream::set_nodelay`]
7237 * [`TcpStream::nodelay`]
7238 * [`TcpStream::set_ttl`]
7239 * [`TcpStream::ttl`]
7240 * [`TcpStream::set_only_v6`]
7241 * [`TcpStream::only_v6`]
7242 * [`TcpStream::take_error`]
7243 * [`TcpStream::set_nonblocking`]
7244 * [`TcpListener::set_ttl`]
7245 * [`TcpListener::ttl`]
7246 * [`TcpListener::set_only_v6`]
7247 * [`TcpListener::only_v6`]
7248 * [`TcpListener::take_error`]
7249 * [`TcpListener::set_nonblocking`]
7250 * [`UdpSocket::set_broadcast`]
7251 * [`UdpSocket::broadcast`]
7252 * [`UdpSocket::set_multicast_loop_v4`]
7253 * [`UdpSocket::multicast_loop_v4`]
7254 * [`UdpSocket::set_multicast_ttl_v4`]
7255 * [`UdpSocket::multicast_ttl_v4`]
7256 * [`UdpSocket::set_multicast_loop_v6`]
7257 * [`UdpSocket::multicast_loop_v6`]
7258 * [`UdpSocket::set_multicast_ttl_v6`]
7259 * [`UdpSocket::multicast_ttl_v6`]
7260 * [`UdpSocket::set_ttl`]
7261 * [`UdpSocket::ttl`]
7262 * [`UdpSocket::set_only_v6`]
7263 * [`UdpSocket::only_v6`]
7264 * [`UdpSocket::join_multicast_v4`]
7265 * [`UdpSocket::join_multicast_v6`]
7266 * [`UdpSocket::leave_multicast_v4`]
7267 * [`UdpSocket::leave_multicast_v6`]
7268 * [`UdpSocket::take_error`]
7269 * [`UdpSocket::connect`]
7270 * [`UdpSocket::send`]
7271 * [`UdpSocket::recv`]
7272 * [`UdpSocket::set_nonblocking`]
7273
7274 Libraries
7275 ---------
7276
7277 * [`std::sync::Once` is poisoned if its initialization function
7278   fails][1.9o].
7279 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7280 * [Most types implement `fmt::Debug`][1.9db].
7281 * [The default buffer size used by `BufReader` and `BufWriter` was
7282   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7283   used by other languages.
7284 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7285   `Duration` additionally implements `*=` and `/=`][1.9ta].
7286 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7287 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7288 * [`Chain` implements `BufRead`][1.9ch].
7289 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7290
7291 Cargo
7292 -----
7293
7294 * [Cargo can now run concurrently][1.9cc].
7295 * [Top-level overrides allow specific revisions of crates to be
7296   overridden through the entire crate graph][1.9ct].  This is intended
7297   to make upgrades easier for large projects, by allowing crates to be
7298   forked temporarily until they've been upgraded and republished.
7299 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7300 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7301   on the commandline][1.9cf]. `rustc` arguments can also be specified
7302   in the `build.rustflags` configuration key.
7303
7304 Performance
7305 -----------
7306
7307 * [The time complexity of comparing variables for equivalence during type
7308   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7309   to major compilation time improvement in some scenarios.
7310 * [`ToString` is specialized for `str`, giving it the same performance
7311   as `to_owned`][1.9ts].
7312 * [Spawning processes with `Command::output` no longer creates extra
7313   threads][1.9sp].
7314 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7315   for C-like enums][1.9cl].
7316
7317 Misc
7318 ----
7319
7320 * [Passing the `--quiet` flag to a test runner will produce
7321   much-abbreviated output][1.9q].
7322 * The Rust Project now publishes std binaries for the
7323   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7324   `i586-pc-windows-msvc` targets.
7325
7326 Compatibility Notes
7327 -------------------
7328
7329 * [`std::sync::Once` is poisoned if its initialization function
7330   fails][1.9o].
7331 * [It is illegal to define methods with the same name in overlapping
7332   inherent `impl` blocks][1.9sn].
7333 * [`fn` item types are zero sized, and each `fn` names a unique
7334   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7335   `transmute` on a `fn` type will generate a warning for a few cycles,
7336   then will be converted to an error.
7337 * [Improvements to const evaluation may trigger new errors when integer
7338   literals are out of range][1.9ce].
7339
7340
7341 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7342 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7343 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7344 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7345 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7346 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7347 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7348 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7349 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7350 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7351 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7352 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7353 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7354 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7355 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7356 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7357 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7358 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7359 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7360 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7361 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7362 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7363 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7364 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7365 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7366 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7367 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7368 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7369 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7370 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7371 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7372 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7373 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7374 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7375 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7376 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7377 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7378 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7379 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7380 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7381 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7382 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7383 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7384 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7385 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7386 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7387 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7388 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7389 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7390 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7391 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7392 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7393 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7394 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7395 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7396 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7397 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7398 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7399 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7400 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7401 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7402 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7403 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7404 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7405 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7406 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7407 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7408 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7409 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7410 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7411 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7412 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7413 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7414 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7415 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7416 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7417 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7418 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7419 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7420 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7421 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7422 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7423 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7424 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7425 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7426 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7427 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7428 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7429 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7430 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7431 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7432 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7433 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7434 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7435 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7436 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7437 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7438 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7439 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7440 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7441 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7442 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7443 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7444 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7445 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7446 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7447 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7448 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7449 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7450 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7451
7452
7453 Version 1.8.0 (2016-04-14)
7454 ==========================
7455
7456 Language
7457 --------
7458
7459 * Rust supports overloading of compound assignment statements like
7460   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7461   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7462   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7463   traits. [RFC 953].
7464 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7465   addition to the non-braced form, `struct Foo;`. [RFC 218].
7466
7467 Libraries
7468 ---------
7469
7470 * Stabilized APIs:
7471   * [`str::encode_utf16`] (renamed from `utf16_units`)
7472   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7473   * [`Ref::map`]
7474   * [`RefMut::map`]
7475   * [`ptr::drop_in_place`]
7476   * [`time::Instant`]
7477   * [`time::SystemTime`]
7478   * [`Instant::now`]
7479   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7480   * [`Instant::elapsed`]
7481   * [`SystemTime::now`]
7482   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7483   * [`SystemTime::elapsed`]
7484   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7485   * [`SystemTimeError`]
7486   * [`SystemTimeError::duration`]
7487   * Various impls for `SystemTimeError`
7488   * [`UNIX_EPOCH`]
7489   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7490     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7491     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7492 * [The `write!` and `writeln!` macros correctly emit errors if any of
7493   their arguments can't be formatted][1.8w].
7494 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7495 * [The Unix-specific `raw` modules, which contain a number of
7496   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7497   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7498   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7499   across platforms was making it difficult to implement `std`
7500   correctly. Those that need these definitions should use the `libc`
7501   crate. [RFC 1415].
7502 * The Unix-specific `MetadataExt` traits, including
7503   `os::unix::fs::MetadataExt`, which expose values such as inode
7504   numbers [no longer return platform-specific types][1.8r], but
7505   instead return widened integers. [RFC 1415].
7506 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7507 * [Atomic loads and stores are not volatile][1.8a].
7508 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7509
7510 Performance
7511 -----------
7512
7513 * [Inlining hash functions lead to a 3% compile-time improvement in
7514   some workloads][1.8h].
7515 * When using jemalloc, its symbols are [unprefixed so that it
7516   overrides the libc malloc implementation][1.8h]. This means that for
7517   rustc, LLVM is now using jemalloc, which results in a 6%
7518   compile-time improvement on a specific workload.
7519 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7520
7521 Misc
7522 ----
7523
7524 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7525   i686-pc-windows-msvc is now considered a tier-1 platform.
7526 * [The `--print targets` flag prints a list of supported targets][1.8t].
7527 * [The `--print cfg` flag prints the `cfg`s defined for the current
7528   target][1.8cf].
7529 * [`rustc` can be built with an new Cargo-based build system, written
7530   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7531   build system. To enable it configure with `configure --rustbuild`.
7532 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7533   variants while also indicating the total number of missing variants
7534   if more than 3][1.8m].
7535 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7536 * The Rust Project now publishes binary releases of the standard
7537   library for a number of tier-2 targets:
7538   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7539   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7540   `x86_64-rumprun-netbsd`. These can be installed with
7541   tools such as [multirust][1.8mr].
7542
7543 Cargo
7544 -----
7545
7546 * [`cargo init` creates a new Cargo project in the current
7547   directory][1.8ci].  It is otherwise like `cargo new`.
7548 * [Cargo has configuration keys for `-v` and
7549   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7550   `[term]` section of `.cargo/config`.
7551 * [Configuration keys that evaluate to strings or integers can be set
7552   via environment variables][1.8ce]. For example the `build.jobs` key
7553   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7554   precedence over config files.
7555 * [Target-specific dependencies support Rust `cfg` syntax for
7556   describing targets][1.8cfg] so that dependencies for multiple
7557   targets can be specified together. [RFC 1361].
7558 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7559   `RUSTDOC` take precedence over the `build.target-dir`,
7560   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7561 * [The child process tree is killed on Windows when Cargo is
7562   killed][1.8ck].
7563 * [The `build.target` configuration value sets the target platform,
7564   like `--target`][1.8ct].
7565
7566 Compatibility Notes
7567 -------------------
7568
7569 * [Unstable compiler flags have been further restricted][1.8u]. Since
7570   1.0 `-Z` flags have been considered unstable, and other flags that
7571   were considered unstable additionally required passing `-Z
7572   unstable-options` to access. Unlike unstable language and library
7573   features though, these options have been accessible on the stable
7574   release channel. Going forward, *new unstable flags will not be
7575   available on the stable release channel*, and old unstable flags
7576   will warn about their usage. In the future, all unstable flags will
7577   be unavailable on the stable release channel.
7578 * [It is no longer possible to `match` on empty enum variants using
7579   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7580 * The Unix-specific `MetadataExt` traits, including
7581   `os::unix::fs::MetadataExt`, which expose values such as inode
7582   numbers [no longer return platform-specific types][1.8r], but
7583   instead return widened integers. [RFC 1415].
7584 * [Modules sourced from the filesystem cannot appear within arbitrary
7585   blocks, but only within other modules][1.8mf].
7586 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7587 * On Unix, [stack overflow triggers a runtime abort instead of a
7588   SIGSEGV][1.8so].
7589 * [`Command::spawn` and its equivalents return an error if any of
7590   its command-line arguments contain interior `NUL`s][1.8n].
7591 * [Tuple and unit enum variants from other crates are in the type
7592   namespace][1.8tn].
7593 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7594   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7595   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7596   instead of `foo.lib`.
7597
7598
7599 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7600 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7601 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7602 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7603 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7604 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7605 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7606 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7607 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7608 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7609 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7610 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7611 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7612 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7613 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7614 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7615 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7616 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7617 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7618 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7619 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7620 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7621 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7622 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7623 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7624 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7625 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7626 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7627 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7628 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7629 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7630 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7631 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7632 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7633 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7634 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7635 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7636 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7637 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7638 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7639 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7640 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7641 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7642 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7643 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7644 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7645 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7646 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7647 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7648 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7649 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7650 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7651 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7652 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7653 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7654 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7655 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7656 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7657 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7658 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7659
7660
7661 Version 1.7.0 (2016-03-03)
7662 ==========================
7663
7664 Libraries
7665 ---------
7666
7667 * Stabilized APIs
7668   * `Path`
7669     * [`Path::strip_prefix`] (renamed from relative_from)
7670     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7671   * `Ipv4Addr`
7672     * [`Ipv4Addr::is_loopback`]
7673     * [`Ipv4Addr::is_private`]
7674     * [`Ipv4Addr::is_link_local`]
7675     * [`Ipv4Addr::is_multicast`]
7676     * [`Ipv4Addr::is_broadcast`]
7677     * [`Ipv4Addr::is_documentation`]
7678   * `Ipv6Addr`
7679     * [`Ipv6Addr::is_unspecified`]
7680     * [`Ipv6Addr::is_loopback`]
7681     * [`Ipv6Addr::is_multicast`]
7682   * `Vec`
7683     * [`Vec::as_slice`]
7684     * [`Vec::as_mut_slice`]
7685   * `String`
7686     * [`String::as_str`]
7687     * [`String::as_mut_str`]
7688   * Slices
7689     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7690     be the same length
7691     * `<[T]>::`[`sort_by_key`]
7692   * checked, saturated, and overflowing operations
7693     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7694     * [`i32::saturating_mul`]
7695     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7696     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7697     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7698     * [`u32::saturating_mul`]
7699     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7700     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7701     * and checked, saturated, and overflowing operations for other primitive types
7702   * FFI
7703     * [`ffi::IntoStringError`]
7704     * [`CString::into_string`]
7705     * [`CString::into_bytes`]
7706     * [`CString::into_bytes_with_nul`]
7707     * `From<CString> for Vec<u8>`
7708   * `IntoStringError`
7709     * [`IntoStringError::into_cstring`]
7710     * [`IntoStringError::utf8_error`]
7711     * `Error for IntoStringError`
7712   * Hashing
7713     * [`std::hash::BuildHasher`]
7714     * [`BuildHasher::Hasher`]
7715     * [`BuildHasher::build_hasher`]
7716     * [`std::hash::BuildHasherDefault`]
7717     * [`HashMap::with_hasher`]
7718     * [`HashMap::with_capacity_and_hasher`]
7719     * [`HashSet::with_hasher`]
7720     * [`HashSet::with_capacity_and_hasher`]
7721     * [`std::collections::hash_map::RandomState`]
7722     * [`RandomState::new`]
7723 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7724   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7725   from bytes is faster.
7726 * [The performance of `LineWriter` (and thus `io::stdout`) was
7727   improved by using `memchr` to search for newlines][1.7m].
7728 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7729   `f64` variants were stabilized previously.
7730 * [`BTreeMap` was rewritten to use less memory and improve the performance
7731   of insertion and iteration, the latter by as much as 5x][1.7bm].
7732 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7733   covariant over their contained type][1.7bt].
7734 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7735   over their contained type][1.7ll].
7736 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7737   searching methods.
7738 * [`Any` is implemented for unsized types][1.7a].
7739 * [`Hash` is implemented for `Duration`][1.7h].
7740
7741 Misc
7742 ----
7743
7744 * [When running tests with `--test`, rustdoc will pass `--cfg`
7745   arguments to the compiler][1.7dt].
7746 * [The compiler is built with RPATH information by default][1.7rpa].
7747   This means that it will be possible to run `rustc` when installed in
7748   unusual configurations without configuring the dynamic linker search
7749   path explicitly.
7750 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7751   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7752   over `LD_LIBRARY_PATH`.
7753
7754 Cargo
7755 -----
7756
7757 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7758   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7759 * [The `rerun-if-changed` build script directive no longer causes the
7760   build script to incorrectly run twice in certain scenarios][1.7rr].
7761
7762 Compatibility Notes
7763 -------------------
7764
7765 * Soundness fixes to the interactions between associated types and
7766   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7767   code that violates the new rules. This is a significant change that
7768   is known to break existing code, so it has emitted warnings for the
7769   new error cases since 1.4 to give crate authors time to adapt. The
7770   details of what is changing are subtle; read the RFC for more.
7771 * [Several bugs in the compiler's visibility calculations were
7772   fixed][1.7v]. Since this was found to break significant amounts of
7773   code, the new errors will be emitted as warnings for several release
7774   cycles, under the `private_in_public` lint.
7775 * Defaulted type parameters were accidentally accepted in positions
7776   that were not intended. In this release, [defaulted type parameters
7777   appearing outside of type definitions will generate a
7778   warning][1.7d], which will become an error in future releases.
7779 * [Parsing "." as a float results in an error instead of 0][1.7p].
7780   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7781 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7782
7783 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7784 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7785 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7786 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7787 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7788 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7789 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7790 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7791 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7792 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7793 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7794 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7795 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7796 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7797 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7798 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7799 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7800 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7801 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7802 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7803 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7804 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7805 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7806 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7807 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7808 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7809 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7810 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7811 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7812 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7813 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7814 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7815 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7816 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7817 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7818 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7819 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7820 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7821 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7822 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7823 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7824 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7825 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7826 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7827 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7828 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7829 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7830 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7831 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7832 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7833 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7834 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7835 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7836 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7837 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7838 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7839 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7840 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7841 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7842 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7843 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7844 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7845 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7846 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7847 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7848 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7849 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7850 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7851 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7852 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7853 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7854 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7855 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7856 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7857 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7858 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7859 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7860 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7861 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7862
7863
7864 Version 1.6.0 (2016-01-21)
7865 ==========================
7866
7867 Language
7868 --------
7869
7870 * The `#![no_std]` attribute causes a crate to not be linked to the
7871   standard library, but only the [core library][1.6co], as described
7872   in [RFC 1184]. The core library defines common types and traits but
7873   has no platform dependencies whatsoever, and is the basis for Rust
7874   software in environments that cannot support a full port of the
7875   standard library, such as operating systems. Most of the core
7876   library is now stable.
7877
7878 Libraries
7879 ---------
7880
7881 * Stabilized APIs:
7882   [`Read::read_exact`],
7883   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7884   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7885   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7886   [`os::unix::fs::DirBuilderExt`],
7887   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7888   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7889   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7890   [`collections::hash_map::Drain`],
7891   [`collections::hash_map::HashMap::drain`],
7892   [`collections::hash_set::Drain`],
7893   [`collections::hash_set::HashSet::drain`],
7894   [`collections::binary_heap::Drain`],
7895   [`collections::binary_heap::BinaryHeap::drain`],
7896   [`Vec::extend_from_slice`] (renamed from `push_all`),
7897   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7898   [`RwLock::into_inner`],
7899   [`Iterator::min_by_key`] (renamed from `min_by`),
7900   [`Iterator::max_by_key`] (renamed from `max_by`).
7901 * The [core library][1.6co] is stable, as are most of its APIs.
7902 * [The `assert_eq!` macro supports arguments that don't implement
7903   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7904   `assert!`.
7905 * Several timer functions that take duration in milliseconds [are
7906   deprecated in favor of those that take `Duration`][1.6ms]. These
7907   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7908   `thread::park_timeout_ms`.
7909 * The algorithm by which `Vec` reserves additional elements was
7910   [tweaked to not allocate excessive space][1.6a] while still growing
7911   exponentially.
7912 * `From` conversions are [implemented from integers to floats][1.6f]
7913   in cases where the conversion is lossless. Thus they are not
7914   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7915   or `f64`. They are also not implemented for `isize` and `usize`
7916   because the implementations would be platform-specific. `From` is
7917   also implemented from `f32` to `f64`.
7918 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7919 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7920 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7921 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7922   improvements.
7923 * Sorting slices that are already sorted [is 50% faster in some
7924   cases][1.6s].
7925
7926 Cargo
7927 -----
7928
7929 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7930 * Cargo build scripts can specify their dependencies by emitting the
7931   [`rerun-if-changed`][1.6rr] key.
7932 * crates.io will reject publication of crates with dependencies that
7933   have a wildcard version constraint. Crates with wildcard
7934   dependencies were seen to cause a variety of problems, as described
7935   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7936   warning.
7937 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7938   release folder.  A variety of artifacts that Cargo failed to clean
7939   are now correctly deleted.
7940
7941 Misc
7942 ----
7943
7944 * The `unreachable_code` lint [warns when a function call's argument
7945   diverges][1.6dv].
7946 * The parser indicates [failures that may be caused by
7947   confusingly-similar Unicode characters][1.6uc]
7948 * Certain macro errors [are reported at definition time][1.6m], not
7949   expansion.
7950
7951 Compatibility Notes
7952 -------------------
7953
7954 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7955   environment variable when locating crates. This was a pre-cargo
7956   feature for integrating with the package manager that was
7957   accidentally never removed.
7958 * [A number of bugs were fixed in the privacy checker][1.6p] that
7959   could cause previously-accepted code to break.
7960 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7961 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7962   struct pattern syntax (`Foo(..)`) can no longer be used to match
7963   unit structs. This is a warning now, but will become an error in
7964   future releases. Patterns that share the same name as a const are
7965   now an error.
7966 * A bug was fixed that causes [rustc not to apply default type
7967   parameters][1.6xc] when resolving certain method implementations of
7968   traits defined in other crates.
7969
7970 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7971 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7972 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7973 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7974 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7975 [1.6co]: http://doc.rust-lang.org/core/index.html
7976 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7977 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7978 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7979 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7980 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7981 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7982 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7983 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7984 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7985 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7986 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7987 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7988 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7989 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7990 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7991 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7992 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7993 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7994 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7995 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7996 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7997 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7998 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7999 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
8000 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8001 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8002 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8003 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8004 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8005 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8006 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8007 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8008 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8009 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8010 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8011 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8012 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8013 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8014 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8015 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8016 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8017
8018
8019 Version 1.5.0 (2015-12-10)
8020 ==========================
8021
8022 * ~700 changes, numerous bugfixes
8023
8024 Highlights
8025 ----------
8026
8027 * Stabilized APIs:
8028   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8029   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8030   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8031   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8032   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8033   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8034   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8035   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8036   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8037   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8038   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8039   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8040   [`Path::read_link`], [`Path::symlink_metadata`],
8041   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8042   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8043   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8044   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8045   [`slice::split_first_mut`], [`slice::split_first`],
8046   [`slice::split_last_mut`], [`slice::split_last`],
8047   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8048   [`str::MatchIndices`], [`str::RMatchIndices`],
8049   [`str::match_indices`], [`str::rmatch_indices`],
8050   [`str::slice_mut_unchecked`], [`string::ParseError`].
8051 * Rust applications hosted on crates.io can be installed locally to
8052   `~/.cargo/bin` with the [`cargo install`] command. Among other
8053   things this makes it easier to augment Cargo with new subcommands:
8054   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8055   invoked as `cargo foo`.
8056 * Crates with wildcard (`*`) dependencies will [emit warnings when
8057   published][1.5w]. In 1.6 it will no longer be possible to publish
8058   crates with wildcard dependencies.
8059
8060 Breaking Changes
8061 ----------------
8062
8063 * The rules determining when a particular lifetime must outlive
8064   a particular value (known as '[dropck]') have been [modified
8065   to not rely on parametricity][1.5p].
8066 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8067   and `Arc`][1.5a]. Because these smart pointer types implement
8068   `Deref`, this causes breakage in cases where the interior type
8069   contains methods of the same name.
8070 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8071   that they could drop their content. Soundness fix.
8072 * All method invocations are [properly checked][1.5wf1] for
8073   [well-formedness][1.5wf2]. Soundness fix.
8074 * Traits whose supertraits contain `Self` are [not object
8075   safe][1.5o]. Soundness fix.
8076 * Target specifications support a [`no_default_libraries`][1.5nd]
8077   setting that controls whether `-nodefaultlibs` is passed to the
8078   linker, and in turn the `is_like_windows` setting no longer affects
8079   the `-nodefaultlibs` flag.
8080 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8081 * The `#[inline]` and `#[repr]` attributes [can only appear
8082   in valid locations][1.5at].
8083 * Native libraries linked from the local crate are [passed to
8084   the linker before native libraries from upstream crates][1.5nl].
8085 * Two rarely-used attributes, `#[no_debug]` and
8086   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8087 * Negation of unsigned integers, which has been a warning for
8088   several releases, [is now behind a feature gate and will
8089   generate errors][1.5nu].
8090 * The parser accidentally accepted visibility modifiers on
8091   enum variants, a bug [which has been fixed][1.5ev].
8092 * [A bug was fixed that allowed `use` statements to import unstable
8093   features][1.5use].
8094
8095 Language
8096 --------
8097
8098 * When evaluating expressions at compile-time that are not
8099   compile-time constants (const-evaluating expressions in non-const
8100   contexts), incorrect code such as overlong bitshifts and arithmetic
8101   overflow will [generate a warning instead of an error][1.5ce],
8102   delaying the error until runtime. This will allow the
8103   const-evaluator to be expanded in the future backwards-compatibly.
8104 * The `improper_ctypes` lint [no longer warns about using `isize` and
8105   `usize` in FFI][1.5ict].
8106
8107 Libraries
8108 ---------
8109
8110 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8111   invariant][1.5c].
8112 * `Default` is [implemented for mutable slices][1.5d].
8113 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8114 * There are now `From` conversions [between floating point
8115   types][1.5f] where the conversions are lossless.
8116 * There are now `From` conversions [between integer types][1.5i] where
8117   the conversions are lossless.
8118 * [`fs::Metadata` implements `Clone`][1.5fs].
8119 * The `parse` method [accepts a leading "+" when parsing
8120   integers][1.5pi].
8121 * [`AsMut` is implemented for `Vec`][1.5am].
8122 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8123   been optimized][1.5cf] and no longer rely on the default impl.
8124 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8125   `unsafe extern "C"` function types now [implement `Clone`,
8126   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8127   `fmt::Debug` for up to 12 arguments][1.5fp].
8128 * [Dropping `Vec`s is much faster in unoptimized builds when the
8129   element types don't implement `Drop`][1.5dv].
8130 * A bug that caused in incorrect behavior when [combining `VecDeque`
8131   with zero-sized types][1.5vdz] was resolved.
8132 * [`PartialOrd` for slices is faster][1.5po].
8133
8134 Miscellaneous
8135 -------------
8136
8137 * [Crate metadata size was reduced by 20%][1.5md].
8138 * [Improvements to code generation reduced the size of libcore by 3.3
8139   MB and rustc's memory usage by 18MB][1.5m].
8140 * [Improvements to deref translation increased performance in
8141   unoptimized builds][1.5dr].
8142 * Various errors in trait resolution [are deduplicated to only be
8143   reported once][1.5te].
8144 * Rust has preliminary [support for rumprun kernels][1.5rr].
8145 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8146
8147 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8148 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8149 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8150 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8151 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8152 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8153 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8154 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8155 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8156 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8157 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8158 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8159 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8160 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8161 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8162 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8163 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8164 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8165 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8166 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8167 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8168 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8169 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8170 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8171 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8172 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8173 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8174 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8175 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8176 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8177 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8178 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8179 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8180 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8181 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8182 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8183 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8184 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8185 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8186 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8187 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8188 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8189 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8190 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8191 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8192 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8193 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8194 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8195 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8196 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8197 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8198 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8199 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8200 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8201 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8202 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8203 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8204 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8205 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8206 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8207 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8208 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8209 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8210 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8211 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8212 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8213 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8214 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8215 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8216 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8217 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8218 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8219 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8220 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8221 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8222 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8223 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8224 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8225 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8226 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8227 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8228 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8229 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8230 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8231 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8232 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8233 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8234 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8235 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8236
8237 Version 1.4.0 (2015-10-29)
8238 ==========================
8239
8240 * ~1200 changes, numerous bugfixes
8241
8242 Highlights
8243 ----------
8244
8245 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8246   GNU) are now supported and recommended for use.
8247
8248 Breaking Changes
8249 ----------------
8250
8251 * [Several changes have been made to fix type soundness and improve
8252   the behavior of associated types][sound]. See [RFC 1214]. Although
8253   we have mostly introduced these changes as warnings this release, to
8254   become errors next release, there are still some scenarios that will
8255   see immediate breakage.
8256 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8257   line breaks in addition to `\n`][crlf].
8258 * [Loans of `'static` lifetime extend to the end of a function][stat].
8259 * [`str::parse` no longer introduces avoidable rounding error when
8260   parsing floating point numbers. Together with earlier changes to
8261   float formatting/output, "round trips" like f.to_string().parse()
8262   now preserve the value of f exactly. Additionally, leading plus
8263   signs are now accepted][fp3].
8264
8265
8266 Language
8267 --------
8268
8269 * `use` statements that import multiple items [can now rename
8270   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8271 * [Binops work correctly on fat pointers][binfat].
8272 * `pub extern crate`, which does not behave as expected, [issues a
8273   warning][pec] until a better solution is found.
8274
8275 Libraries
8276 ---------
8277
8278 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8279   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8280   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8281   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8282   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8283   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8284   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8285   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8286   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8287   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8288   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8289   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8290   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8291   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8292   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8293   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8294   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8295   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8296   [`thread::sleep`].
8297 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8298   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8299   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8300   `f64::from_str_radix`.
8301 * [Reverse-searching strings is faster with the 'two-way'
8302   algorithm][s].
8303 * [`std::io::copy` allows `?Sized` arguments][cc].
8304 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8305   [override `count`, `nth` and `last` with an O(1)
8306   implementation][it].
8307 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8308 * [`IntoRawFd` has been added to the Unix-specific prelude,
8309   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8310   prelude][pr].
8311 * [`Extend<String>` and `FromIterator<String` are both implemented for
8312   `String`][es].
8313 * [`IntoIterator` is implemented for references to `Option` and
8314   `Result`][into2].
8315 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8316   Copy`][ext] as part of [RFC 839]. This will cause type inference
8317   breakage in rare situations.
8318 * [`BinaryHeap` implements `Debug`][bh2].
8319 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8320   arrays][bm].
8321 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8322   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8323 * [String comparison is faster][faststr].
8324 * `&mut T` where `T: std::fmt::Write` [also implements
8325   `std::fmt::Write`][mutw].
8326 * [A stable regression in `VecDeque::push_back` and other
8327   capacity-altering methods that caused panics for zero-sized types
8328   was fixed][vd].
8329 * [Function pointers implement traits for up to 12 parameters][fp2].
8330
8331 Miscellaneous
8332 -------------
8333
8334 * The compiler [no longer uses the 'morestack' feature to prevent
8335   stack overflow][mm]. Instead it uses guard pages and stack
8336   probes (though stack probes are not yet implemented on any platform
8337   but Windows).
8338 * [The compiler matches traits faster when projections are involved][p].
8339 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8340   `usize`][ffi].
8341 * [Cargo now displays useful information about what its doing during
8342   `cargo update`][cu].
8343
8344 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8345 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8346 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8347 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8348 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8349 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8350 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8351 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8352 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8353 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8354 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8355 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8356 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8357 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8358 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8359 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8360 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8361 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8362 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8363 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8364 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8365 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8366 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8367 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8368 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8369 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8370 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8371 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8372 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8373 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8374 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8375 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8376 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8377 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8378 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8379 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8380 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8381 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8382 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8383 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8384 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8385 [bh2]: https://github.com/rust-lang/rust/pull/28156
8386 [binfat]: https://github.com/rust-lang/rust/pull/28270
8387 [bm]: https://github.com/rust-lang/rust/pull/28197
8388 [cc]: https://github.com/rust-lang/rust/pull/27531
8389 [crlf]: https://github.com/rust-lang/rust/pull/28034
8390 [cu]: https://github.com/rust-lang/cargo/pull/1931
8391 [d]: https://github.com/rust-lang/rust/pull/27825
8392 [dep]: https://github.com/rust-lang/rust/pull/28339
8393 [es]: https://github.com/rust-lang/rust/pull/27956
8394 [ext]: https://github.com/rust-lang/rust/pull/28094
8395 [faststr]: https://github.com/rust-lang/rust/pull/28338
8396 [ffi]: https://github.com/rust-lang/rust/pull/28779
8397 [fp]: https://github.com/rust-lang/rust/pull/28268
8398 [fp2]: https://github.com/rust-lang/rust/pull/28560
8399 [fp3]: https://github.com/rust-lang/rust/pull/27307
8400 [i]: https://github.com/rust-lang/rust/pull/27451
8401 [into2]: https://github.com/rust-lang/rust/pull/28039
8402 [it]: https://github.com/rust-lang/rust/pull/27652
8403 [mm]: https://github.com/rust-lang/rust/pull/27338
8404 [mutw]: https://github.com/rust-lang/rust/pull/28368
8405 [sound]: https://github.com/rust-lang/rust/pull/27641
8406 [p]: https://github.com/rust-lang/rust/pull/27866
8407 [pec]: https://github.com/rust-lang/rust/pull/28486
8408 [pr]: https://github.com/rust-lang/rust/pull/27896
8409 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8410 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8411 [s]: https://github.com/rust-lang/rust/pull/27474
8412 [stab]: https://github.com/rust-lang/rust/pull/28339
8413 [stat]: https://github.com/rust-lang/rust/pull/28321
8414 [vd]: https://github.com/rust-lang/rust/pull/28494
8415
8416 Version 1.3.0 (2015-09-17)
8417 ==============================
8418
8419 * ~900 changes, numerous bugfixes
8420
8421 Highlights
8422 ----------
8423
8424 * The [new object lifetime defaults][nold] have been [turned
8425   on][nold2] after a cycle of warnings about the change. Now types
8426   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8427   being interpreted as `&'a Box<Trait+'a>` to `&'a
8428   Box<Trait+'static>`.
8429 * [The Rustonomicon][nom] is a new book in the official documentation
8430   that dives into writing unsafe Rust.
8431 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8432   timekeeping is employed by other std APIs, as well as out-of-tree
8433   time crates.
8434
8435 Breaking Changes
8436 ----------------
8437
8438 * The [new object lifetime defaults][nold] have been [turned
8439   on][nold2] after a cycle of warnings about the change.
8440 * There is a known [regression][lr] in how object lifetime elision is
8441   interpreted, the proper solution for which is undetermined.
8442 * The `#[prelude_import]` attribute, an internal implementation
8443   detail, was accidentally stabilized previously. [It has been put
8444   behind the `prelude_import` feature gate][pi]. This change is
8445   believed to break no existing code.
8446 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8447   [more sane for dynamically sized types][dst3]. Code that relied on
8448   the previous behavior is thought to be broken.
8449 * The `dropck` rules, which checks that destructors can't access
8450   destroyed values, [have been updated][dropck] to match the
8451   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8452   cause some previously-compiling code to no longer build.
8453
8454 Language
8455 --------
8456
8457 * The [new object lifetime defaults][nold] have been [turned
8458   on][nold2] after a cycle of warnings about the change.
8459 * Semicolons may [now follow types and paths in
8460   macros](https://github.com/rust-lang/rust/pull/27000).
8461 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8462   [more sane for dynamically sized types][dst3]. Code that relied on
8463   the previous behavior is not known to exist, and suspected to be
8464   broken.
8465 * `'static` variables [may now be recursive][st].
8466 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8467   implementations correctly.
8468 * The `dropck` rules, which checks that destructors can't access
8469   destroyed values, [have been updated][dropck] to match the
8470   [RFC][dropckrfc].
8471
8472 Libraries
8473 ---------
8474
8475 * The [`Duration`] API, [has been stabilized][ds], as well as the
8476   `std::time` module, which presently contains only `Duration`.
8477 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8478 * The owned C string, [`CString`], implements [`Borrow`] and the
8479   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8480   these allow C strings to be borrowed and cloned in generic code.
8481 * [`CStr`] implements [`Debug`].
8482 * [`AtomicPtr`] implements [`Debug`].
8483 * [`Error`] trait objects [can be downcast to their concrete types][e]
8484   in many common configurations, using the [`is`], [`downcast`],
8485   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8486   [`Any`] trait.
8487 * Searching for substrings now [employs the two-way algorithm][search]
8488   instead of doing a naive search. This gives major speedups to a
8489   number of methods, including [`contains`][sc], [`find`][sf],
8490   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8491   [`ends_with`][sew] are also faster.
8492 * The performance of `PartialEq` for slices is [much faster][ps].
8493 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8494   is overridden and optimized by the implementations for scalars.
8495 * The [`Hasher`] trait now has a number of specialized `write_*`
8496   methods for primitive types, for efficiency.
8497 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8498   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8499   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8500   of [`std::error::Error::cause`][iec] also delegates to the inner
8501   error.
8502 * [`process::Child`][pc] gained the [`id`] method, which returns a
8503   `u32` representing the platform-specific process identifier.
8504 * The [`connect`] method on slices is deprecated, replaced by the new
8505   [`join`] method (note that both of these are on the *unstable*
8506   [`SliceConcatExt`] trait, but through the magic of the prelude are
8507   available to stable code anyway).
8508 * The [`Div`] operator is implemented for [`Wrapping`] types.
8509 * [`DerefMut` is implemented for `String`][dms].
8510 * Performance of SipHash (the default hasher for `HashMap`) is
8511   [better for long data][sh].
8512 * [`AtomicPtr`] implements [`Send`].
8513 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8514   are now [specialized to use uninitialized buffers for increased
8515   performance][rte].
8516 * Lifetime parameters of foreign functions [are now resolved
8517   properly][f].
8518
8519 Misc
8520 ----
8521
8522 * Rust can now, with some coercion, [produce programs that run on
8523   Windows XP][xp], though XP is not considered a supported platform.
8524 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8525   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8526   recommended for use in 1.3, though should be fully-functional
8527   in the [64-bit 1.4 beta][b14].
8528 * On Fedora-based systems installation will [properly configure the
8529   dynamic linker][fl].
8530 * The compiler gained many new extended error descriptions, which can
8531   be accessed with the `--explain` flag.
8532 * The `dropck` pass, which checks that destructors can't access
8533   destroyed values, [has been rewritten][dropck]. This fixes some
8534   soundness holes, and as such will cause some previously-compiling
8535   code to no longer build.
8536 * `rustc` now uses [LLVM to write archive files where possible][ar].
8537   Eventually this will eliminate the compiler's dependency on the ar
8538   utility.
8539 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8540   supported FreeBSD on x86_64).
8541 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8542   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8543   more strict.
8544 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8545   will kill the process instead of leaking][nlp].
8546
8547 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8548 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8549 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8550 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8551 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8552 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8553 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8554 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8555 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8556 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8557 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8558 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8559 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8560 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8561 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8562 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8563 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8564 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8565 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8566 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8567 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8568 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8569 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8570 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8571 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8572 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8573 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8574 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8575 [ar]: https://github.com/rust-lang/rust/pull/26926
8576 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8577 [dms]: https://github.com/rust-lang/rust/pull/26241
8578 [dropck]: https://github.com/rust-lang/rust/pull/27261
8579 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8580 [ds]: https://github.com/rust-lang/rust/pull/26818
8581 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8582 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8583 [dst3]: https://github.com/rust-lang/rust/pull/27351
8584 [e]: https://github.com/rust-lang/rust/pull/24793
8585 [f]: https://github.com/rust-lang/rust/pull/26588
8586 [fb]: https://github.com/rust-lang/rust/pull/26959
8587 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8588 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8589 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8590 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8591 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8592 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8593 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8594 [lic]: https://github.com/rust-lang/rust/pull/26583
8595 [lnu]: https://github.com/rust-lang/rust/pull/27026
8596 [lr]: https://github.com/rust-lang/rust/issues/27248
8597 [lum]: https://github.com/rust-lang/rust/pull/26378
8598 [lur]: https://github.com/rust-lang/rust/pull/26783
8599 [nlp]: https://github.com/rust-lang/rust/pull/27176
8600 [nold2]: https://github.com/rust-lang/rust/pull/27045
8601 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8602 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8603 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8604 [pi]: https://github.com/rust-lang/rust/pull/26699
8605 [ps]: https://github.com/rust-lang/rust/pull/26884
8606 [rte]: https://github.com/rust-lang/rust/pull/26950
8607 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8608 [search]: https://github.com/rust-lang/rust/pull/26327
8609 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8610 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8611 [sh]: https://github.com/rust-lang/rust/pull/27280
8612 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8613 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8614 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8615 [st]: https://github.com/rust-lang/rust/pull/26630
8616 [win1]: https://github.com/rust-lang/rust/pull/26569
8617 [win2]: https://github.com/rust-lang/rust/pull/26741
8618 [win3]: https://github.com/rust-lang/rust/pull/26741
8619 [win4]: https://github.com/rust-lang/rust/pull/27210
8620 [xp]: https://github.com/rust-lang/rust/pull/26569
8621
8622 Version 1.2.0 (2015-08-07)
8623 ==========================
8624
8625 * ~1200 changes, numerous bugfixes
8626
8627 Highlights
8628 ----------
8629
8630 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8631   like `Rc` to contain types without a fixed size, arrays and trait
8632   objects, finally enabling use of `Rc<[T]>` and completing the
8633   implementation of DST.
8634 * [Parallel codegen][parcodegen] is now working again, which can
8635   substantially speed up large builds in debug mode; It also gets
8636   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8637   jobs). It's not enabled by default, but will be "in the near
8638   future". It can be activated with the `-C codegen-units=N` flag to
8639   `rustc`.
8640 * This is the first release with [experimental support for linking
8641   with the MSVC linker and lib C on Windows (instead of using the GNU
8642   variants via MinGW)][win]. It is yet recommended only for the most
8643   intrepid Rustaceans.
8644 * Benchmark compilations are showing a 30% improvement in
8645   bootstrapping over 1.1.
8646
8647 Breaking Changes
8648 ----------------
8649
8650 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8651   unicode case mapping, which is a previously-planned change in
8652   behavior and considered a bugfix.
8653 * [`mem::align_of`] now specifies [the *minimum alignment* for
8654   T][align], which is usually the alignment programs are interested
8655   in, and the same value reported by clang's
8656   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8657   break real code.
8658 * [The `#[packed]` attribute is no longer silently accepted by the
8659   compiler][packed]. This attribute did nothing and code that
8660   mentioned it likely did not work as intended.
8661 * Associated type defaults are [now behind the
8662   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8663   defaults *did not work*, but could be mentioned syntactically. As
8664   such this breakage has minimal impact.
8665
8666 Language
8667 --------
8668
8669 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8670   matching against dereferenceable values.
8671
8672 Libraries
8673 ---------
8674
8675 * The [`Extend`] trait, which grows a collection from an iterator, is
8676   implemented over iterators of references, for `String`, `Vec`,
8677   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8678   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8679 * The [`iter::once`] function returns an iterator that yields a single
8680   element, and [`iter::empty`] returns an iterator that yields no
8681   elements.
8682 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8683   over substring matches.
8684 * [`Cell`] and [`RefCell`] both implement `Eq`.
8685 * A number of methods for wrapping arithmetic are added to the
8686   integral types, [`wrapping_div`], [`wrapping_rem`],
8687   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8688   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8689   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8690   type.. It is illegal for the default arithmetic operations in Rust
8691   to overflow; the desire to wrap must be explicit.
8692 * The `{:#?}` formatting specifier [displays the alternate,
8693   pretty-printed][debugfmt] form of the `Debug` formatter. This
8694   feature was actually introduced prior to 1.0 with little
8695   fanfare.
8696 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8697   for writing data to formatted strings, similar to [`io::Write`].
8698 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8699   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8700   are used by code generators to emit implementations of [`Debug`].
8701 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8702   methods that convert case, following Unicode case mapping.
8703 * It is now easier to handle poisoned locks. The [`PoisonError`]
8704   type, returned by failing lock operations, exposes `into_inner`,
8705   `get_ref`, and `get_mut`, which all give access to the inner lock
8706   guard, and allow the poisoned lock to continue to operate. The
8707   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8708   poisoned lock without attempting to take the lock.
8709 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8710   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8711   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8712   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8713   `ChildStderr`.
8714 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8715   malformed input.
8716
8717 Misc
8718 ----
8719
8720 * `rustc` employs smarter heuristics for guessing at [typos].
8721 * `rustc` emits more efficient code for [no-op conversions between
8722   unsafe pointers][nop].
8723 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8724   resulting in faster compile times and smaller code.
8725
8726 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8727 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8728 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8729 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8730 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8731 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8732 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8733 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8734 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8735 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8736 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8737 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8738 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8739 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8740 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8741 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8742 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8743 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8744 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8745 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8746 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8747 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8748 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8749 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8750 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8751 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8752 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8753 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8754 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8755 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8756 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8757 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8758 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8759 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8760 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8761 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8762 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8763 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8764 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8765 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8766 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8767 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8768 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8769 [align]: https://github.com/rust-lang/rust/pull/25646
8770 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8771 [typos]: https://github.com/rust-lang/rust/pull/26087
8772 [nop]: https://github.com/rust-lang/rust/pull/26336
8773 [fat]: https://github.com/rust-lang/rust/pull/26411
8774 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8775 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8776 [packed]: https://github.com/rust-lang/rust/pull/25541
8777 [ad]: https://github.com/rust-lang/rust/pull/27382
8778 [win]: https://github.com/rust-lang/rust/pull/25350
8779
8780 Version 1.1.0 (2015-06-25)
8781 =========================
8782
8783 * ~850 changes, numerous bugfixes
8784
8785 Highlights
8786 ----------
8787
8788 * The [`std::fs` module has been expanded][fs] to expand the set of
8789   functionality exposed:
8790   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8791     don't incur a syscall on some platforms.
8792   * A `symlink_metadata` function has been added.
8793   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8794     access to all underlying information.
8795 * The compiler now contains extended explanations of many errors. When an error
8796   with an explanation occurs the compiler suggests using the `--explain` flag
8797   to read the explanation. Error explanations are also [available online][err-index].
8798 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8799   well as other work, the time to bootstrap the compiler decreased by
8800   32%.
8801
8802 Libraries
8803 ---------
8804
8805 * The [`str::split_whitespace`] method splits a string on unicode
8806   whitespace boundaries.
8807 * On both Windows and Unix, new extension traits provide conversion of
8808   I/O types to and from the underlying system handles. On Unix, these
8809   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8810   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8811   `TcpListener`, and `UpdSocket`. Further implementations for
8812   `std::process` will be stabilized later.
8813 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8814   Windows, symlinks can be created with
8815   `std::os::windows::symlink_dir` and
8816   `std::os::windows::symlink_file`.
8817 * The `mpsc::Receiver` type can now be converted into an iterator with
8818   `into_iter` on the [`IntoIterator`] trait.
8819 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8820   implementation of the [`From`] trait.
8821 * The `Debug` implementation for `RangeFull` [creates output that is
8822   more consistent with other implementations][rf].
8823 * [`Debug` is implemented for `File`][file].
8824 * The `Default` implementation for `Arc` [no longer requires `Sync +
8825   Send`][arc].
8826 * [The `Iterator` methods `count`, `nth`, and `last` have been
8827   overridden for slices to have O(1) performance instead of O(n)][si].
8828 * Incorrect handling of paths on Windows has been improved in both the
8829   compiler and the standard library.
8830 * [`AtomicPtr` gained a `Default` implementation][ap].
8831 * In accordance with Rust's policy on arithmetic overflow `abs` now
8832   [panics on overflow when debug assertions are enabled][abs].
8833 * The [`Cloned`] iterator, which was accidentally left unstable for
8834   1.0 [has been stabilized][c].
8835 * The [`Incoming`] iterator, which iterates over incoming TCP
8836   connections, and which was accidentally unnamable in 1.0, [is now
8837   properly exported][inc].
8838 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8839   `sift_up` or `sift_down` panic][bh].
8840 * The [`split_off`] method of `LinkedList` [no longer corrupts
8841   the list in certain scenarios][ll].
8842
8843 Misc
8844 ----
8845
8846 * Type checking performance [has improved notably][sk] with
8847   [multiple improvements][pre].
8848 * The compiler [suggests code changes][ch] for more errors.
8849 * rustc and it's build system have experimental support for [building
8850   toolchains against MUSL][m] instead of glibc on Linux.
8851 * The compiler defines the `target_env` cfg value, which is used for
8852   distinguishing toolchains that are otherwise for the same
8853   platform. Presently this is set to `gnu` for common GNU Linux
8854   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8855 * The [`cargo rustc`][crc] command invokes a build with custom flags
8856   to rustc.
8857 * [Android executables are always position independent][pie].
8858 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8859   with `Drop`][drop].
8860
8861 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8862 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8863 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8864 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8865 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8866 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8867 [rf]: https://github.com/rust-lang/rust/pull/24491
8868 [err-index]: https://doc.rust-lang.org/error-index.html
8869 [sk]: https://github.com/rust-lang/rust/pull/24615
8870 [pre]: https://github.com/rust-lang/rust/pull/25323
8871 [file]: https://github.com/rust-lang/rust/pull/24598
8872 [ch]: https://github.com/rust-lang/rust/pull/24683
8873 [arc]: https://github.com/rust-lang/rust/pull/24695
8874 [si]: https://github.com/rust-lang/rust/pull/24701
8875 [ap]: https://github.com/rust-lang/rust/pull/24834
8876 [m]: https://github.com/rust-lang/rust/pull/24777
8877 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8878 [crc]: https://github.com/rust-lang/cargo/pull/1568
8879 [pie]: https://github.com/rust-lang/rust/pull/24953
8880 [abs]: https://github.com/rust-lang/rust/pull/25441
8881 [c]: https://github.com/rust-lang/rust/pull/25496
8882 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8883 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8884 [inc]: https://github.com/rust-lang/rust/pull/25522
8885 [bh]: https://github.com/rust-lang/rust/pull/25856
8886 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8887 [ll]: https://github.com/rust-lang/rust/pull/26022
8888 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8889 [drop]: https://github.com/rust-lang/rust/pull/24935
8890
8891 Version 1.0.0 (2015-05-15)
8892 ========================
8893
8894 * ~1500 changes, numerous bugfixes
8895
8896 Highlights
8897 ----------
8898
8899 * The vast majority of the standard library is now `#[stable]`. It is
8900   no longer possible to use unstable features with a stable build of
8901   the compiler.
8902 * Many popular crates on [crates.io] now work on the stable release
8903   channel.
8904 * Arithmetic on basic integer types now [checks for overflow in debug
8905   builds][overflow].
8906
8907 Language
8908 --------
8909
8910 * Several [restrictions have been added to trait coherence][coh] in
8911   order to make it easier for upstream authors to change traits
8912   without breaking downstream code.
8913 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8914   improve error messages and macro behavior. For example, `0b1234` is
8915   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8916 * Trait bounds [are always invariant][inv], eliminating the need for
8917   the `PhantomFn` and `MarkerTrait` lang items, which have been
8918   removed.
8919 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8920   "foo" as bar` syntax has been replaced with `extern crate foo as
8921   bar`, and Cargo now automatically translates "-" in *package* names
8922   to underscore for the crate name.
8923 * [Lifetime shadowing is an error][lt].
8924 * [`Send` no longer implies `'static`][send-rfc].
8925 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8926   `MyType::default()`.
8927 * Primitive types [now have inherent methods][prim-inherent],
8928   obviating the need for extension traits like `SliceExt`.
8929 * Methods with `Self: Sized` in their `where` clause are [considered
8930   object-safe][self-sized], allowing many extension traits like
8931   `IteratorExt` to be merged into the traits they extended.
8932 * You can now [refer to associated types][assoc-where] whose
8933   corresponding trait bounds appear only in a `where` clause.
8934 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8935   like `Send` and `Sync` are now library-defined.
8936 * A [Reflect trait][reflect] was introduced, which means that
8937   downcasting via the `Any` trait is effectively limited to concrete
8938   types. This helps retain the potentially-important "parametricity"
8939   property: generic code cannot behave differently for different type
8940   arguments except in minor ways.
8941 * The `unsafe_destructor` feature is now deprecated in favor of the
8942   [new `dropck`][dropck]. This change is a major reduction in unsafe
8943   code.
8944
8945 Libraries
8946 ---------
8947
8948 * The `thread_local` module [has been renamed to `std::thread`][th].
8949 * The methods of `IteratorExt` [have been moved to the `Iterator`
8950   trait itself][ie].
8951 * Several traits that implement Rust's conventions for type
8952   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8953   [centralized in the `std::convert` module][con].
8954 * The `FromError` trait [was removed in favor of `From`][fe].
8955 * The basic sleep function [has moved to
8956   `std::thread::sleep_ms`][slp].
8957 * The `splitn` function now takes an `n` parameter that represents the
8958   number of items yielded by the returned iterator [instead of the
8959   number of 'splits'][spl].
8960 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8961 * [Derived implementations of `PartialOrd` now order enums according
8962   to their explicitly-assigned discriminants][po].
8963 * [Methods for searching strings are generic over `Pattern`s][pat],
8964   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8965   some others.
8966 * [In method resolution, object methods are resolved before inherent
8967   methods][meth].
8968 * [`String::from_str` has been deprecated in favor of the `From` impl,
8969   `String::from`][sf].
8970 * [`io::Error` implements `Sync`][ios].
8971 * [The `words` method on `&str` has been replaced with
8972   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8973   a word?'
8974 * The new path and IO modules are complete and `#[stable]`. This
8975   was the major library focus for this cycle.
8976 * The path API was [revised][path-normalize] to normalize `.`,
8977   adjusting the tradeoffs in favor of the most common usage.
8978 * A large number of remaining APIs in `std` were also stabilized
8979   during this cycle; about 75% of the non-deprecated API surface
8980   is now stable.
8981 * The new [string pattern API][string-pattern] landed, which makes
8982   the string slice API much more internally consistent and flexible.
8983 * A new set of [generic conversion traits][conversion] replaced
8984   many existing ad hoc traits.
8985 * Generic numeric traits were [completely removed][num-traits]. This
8986   was made possible thanks to inherent methods for primitive types,
8987   and the removal gives maximal flexibility for designing a numeric
8988   hierarchy in the future.
8989 * The `Fn` traits are now related via [inheritance][fn-inherit]
8990   and provide ergonomic [blanket implementations][fn-blanket].
8991 * The `Index` and `IndexMut` traits were changed to
8992   [take the index by value][index-value], enabling code like
8993   `hash_map["string"]` to work.
8994 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8995   `Copy` data is known to be `Clone` as well.
8996
8997 Misc
8998 ----
8999
9000 * Many errors now have extended explanations that can be accessed with
9001   the `--explain` flag to `rustc`.
9002 * Many new examples have been added to the standard library
9003   documentation.
9004 * rustdoc has received a number of improvements focused on completion
9005   and polish.
9006 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9007 * Much headway was made on ecosystem-wide CI, making it possible
9008   to [compare builds for breakage][ci-compare].
9009
9010
9011 [crates.io]: http://crates.io
9012 [clo]: https://github.com/rust-lang/rust/pull/24034
9013 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9014 [con]: https://github.com/rust-lang/rust/pull/23875
9015 [cr]: https://github.com/rust-lang/rust/pull/23419
9016 [fe]: https://github.com/rust-lang/rust/pull/23879
9017 [ie]: https://github.com/rust-lang/rust/pull/23300
9018 [inv]: https://github.com/rust-lang/rust/pull/23938
9019 [ios]: https://github.com/rust-lang/rust/pull/24133
9020 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9021 [lt]: https://github.com/rust-lang/rust/pull/24057
9022 [meth]: https://github.com/rust-lang/rust/pull/24056
9023 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9024 [po]: https://github.com/rust-lang/rust/pull/24270
9025 [sf]: https://github.com/rust-lang/rust/pull/24517
9026 [slp]: https://github.com/rust-lang/rust/pull/23949
9027 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9028 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9029 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9030 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9031 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9032 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9033 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9034 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9035 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9036 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9037 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9038 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9039 [reflect]: https://github.com/rust-lang/rust/pull/23712
9040 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9041 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9042 [index-value]: https://github.com/rust-lang/rust/pull/23601
9043 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9044 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9045 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9046 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9047 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9048 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9049
9050
9051 Version 1.0.0-alpha.2 (2015-02-20)
9052 =====================================
9053
9054 * ~1300 changes, numerous bugfixes
9055
9056 * Highlights
9057
9058     * The various I/O modules were [overhauled][io-rfc] to reduce
9059       unnecessary abstractions and provide better interoperation with
9060       the underlying platform. The old `io` module remains temporarily
9061       at `std::old_io`.
9062     * The standard library now [participates in feature gating][feat],
9063       so use of unstable libraries now requires a `#![feature(...)]`
9064       attribute. The impact of this change is [described on the
9065       forum][feat-forum]. [RFC][feat-rfc].
9066
9067 * Language
9068
9069     * `for` loops [now operate on the `IntoIterator` trait][into],
9070       which eliminates the need to call `.iter()`, etc. to iterate
9071       over collections. There are some new subtleties to remember
9072       though regarding what sort of iterators various types yield, in
9073       particular that `for foo in bar { }` yields values from a move
9074       iterator, destroying the original collection. [RFC][into-rfc].
9075     * Objects now have [default lifetime bounds][obj], so you don't
9076       have to write `Box<Trait+'static>` when you don't care about
9077       storing references. [RFC][obj-rfc].
9078     * In types that implement `Drop`, [lifetimes must outlive the
9079       value][drop]. This will soon make it possible to safely
9080       implement `Drop` for types where `#[unsafe_destructor]` is now
9081       required. Read the [gorgeous RFC][drop-rfc] for details.
9082     * The fully qualified <T as Trait>::X syntax lets you set the Self
9083       type for a trait method or associated type. [RFC][ufcs-rfc].
9084     * References to types that implement `Deref<U>` now [automatically
9085       coerce to references][deref] to the dereferenced type `U`,
9086       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9087       should eliminate many unsightly uses of `&*`, as when converting
9088       from references to vectors into references to
9089       slices. [RFC][deref-rfc].
9090     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9091       `|:|`) is obsolete and closure kind is inferred from context.
9092     * [`Self` is a keyword][Self].
9093
9094 * Libraries
9095
9096     * The `Show` and `String` formatting traits [have been
9097       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9098       their related purposes. Automatically getting a string
9099       conversion to use with `format!("{:?}", something_to_debug)` is
9100       now written `#[derive(Debug)]`.
9101     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9102       OsStr}`, provide strings in platform-specific encodings for easier
9103       interop with system APIs. [RFC][osstr-rfc].
9104     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9105       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9106       creating raw pointers.
9107
9108 * Tooling
9109
9110     * Certain long error messages of the form 'expected foo found bar'
9111       are now [split neatly across multiple
9112       lines][multiline]. Examples in the PR.
9113     * On Unix Rust can be [uninstalled][un] by running
9114       `/usr/local/lib/rustlib/uninstall.sh`.
9115     * The `#[rustc_on_unimplemented]` attribute, requiring the
9116       'on_unimplemented' feature, lets rustc [display custom error
9117       messages when a trait is expected to be implemented for a type
9118       but is not][onun].
9119
9120 * Misc
9121
9122     * Rust is tested against a [LALR grammar][lalr], which parses
9123       almost all the Rust files that rustc does.
9124
9125 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9126 [close]: https://github.com/rust-lang/rust/pull/21843
9127 [deref]: https://github.com/rust-lang/rust/pull/21351
9128 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9129 [drop]: https://github.com/rust-lang/rust/pull/21972
9130 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9131 [feat]: https://github.com/rust-lang/rust/pull/21248
9132 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9133 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9134 [fmt]: https://github.com/rust-lang/rust/pull/21457
9135 [into]: https://github.com/rust-lang/rust/pull/20790
9136 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9137 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9138 [lalr]: https://github.com/rust-lang/rust/pull/21452
9139 [multiline]: https://github.com/rust-lang/rust/pull/19870
9140 [obj]: https://github.com/rust-lang/rust/pull/22230
9141 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9142 [onun]: https://github.com/rust-lang/rust/pull/20889
9143 [osstr]: https://github.com/rust-lang/rust/pull/21488
9144 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9145 [Self]: https://github.com/rust-lang/rust/pull/22158
9146 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9147 [un]: https://github.com/rust-lang/rust/pull/22256
9148
9149
9150 Version 1.0.0-alpha (2015-01-09)
9151 ==================================
9152
9153   * ~2400 changes, numerous bugfixes
9154
9155   * Highlights
9156
9157     * The language itself is considered feature complete for 1.0,
9158       though there will be many usability improvements and bugfixes
9159       before the final release.
9160     * Nearly 50% of the public API surface of the standard library has
9161       been declared 'stable'. Those interfaces are unlikely to change
9162       before 1.0.
9163     * The long-running debate over integer types has been
9164       [settled][ints]: Rust will ship with types named `isize` and
9165       `usize`, rather than `int` and `uint`, for pointer-sized
9166       integers. Guidelines will be rolled out during the alpha cycle.
9167     * Most crates that are not `std` have been moved out of the Rust
9168       distribution into the Cargo ecosystem so they can evolve
9169       separately and don't need to be stabilized as quickly, including
9170       'time', 'getopts', 'num', 'regex', and 'term'.
9171     * Documentation continues to be expanded with more API coverage, more
9172       examples, and more in-depth explanations. The guides have been
9173       consolidated into [The Rust Programming Language][trpl].
9174     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9175     * All official Rust binary installers now come with [Cargo], the
9176       Rust package manager.
9177
9178 * Language
9179
9180     * Closures have been [completely redesigned][unboxed] to be
9181       implemented in terms of traits, can now be used as generic type
9182       bounds and thus monomorphized and inlined, or via an opaque
9183       pointer (boxed) as in the old system. The new system is often
9184       referred to as 'unboxed' closures.
9185     * Traits now support [associated types][assoc], allowing families
9186       of related types to be defined together and used generically in
9187       powerful ways.
9188     * Enum variants are [namespaced by their type names][enum].
9189     * [`where` clauses][where] provide a more versatile and attractive
9190       syntax for specifying generic bounds, though the previous syntax
9191       remains valid.
9192     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9193       numeric types.
9194     * Rust [no longer has a runtime][rt] of any description, and only
9195       supports OS threads, not green threads.
9196     * At long last, Rust has been overhauled for 'dynamically-sized
9197       types' ([DST]), which integrates 'fat pointers' (object types,
9198       arrays, and `str`) more deeply into the type system, making it
9199       more consistent.
9200     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9201       `..j` that produce range types and which, when combined with the
9202       `Index` operator and multidispatch, leads to a convenient slice
9203       notation, `[i..j]`.
9204     * The new range syntax revealed an ambiguity in the fixed-length
9205       array syntax, so now fixed length arrays [are written `[T;
9206       N]`][arrays].
9207     * The `Copy` trait is no longer implemented automatically. Unsafe
9208       pointers no longer implement `Sync` and `Send` so types
9209       containing them don't automatically either. `Sync` and `Send`
9210       are now 'unsafe traits' so one can "forcibly" implement them via
9211       `unsafe impl` if a type confirms to the requirements for them
9212       even though the internals do not (e.g. structs containing unsafe
9213       pointers like `Arc`). These changes are intended to prevent some
9214       footguns and are collectively known as [opt-in built-in
9215       traits][oibit] (though `Sync` and `Send` will soon become pure
9216       library types unknown to the compiler).
9217     * Operator traits now take their operands [by value][ops], and
9218       comparison traits can use multidispatch to compare one type
9219       against multiple other types, allowing e.g. `String` to be
9220       compared with `&str`.
9221     * `if let` and `while let` are no longer feature-gated.
9222     * Rust has adopted a more [uniform syntax for escaping unicode
9223       characters][unicode].
9224     * `macro_rules!` [has been declared stable][mac]. Though it is a
9225       flawed system it is sufficiently popular that it must be usable
9226       for 1.0. Effort has gone into [future-proofing][mac-future] it
9227       in ways that will allow other macro systems to be developed in
9228       parallel, and won't otherwise impact the evolution of the
9229       language.
9230     * The prelude has been [pared back significantly][prelude] such
9231       that it is the minimum necessary to support the most pervasive
9232       code patterns, and through [generalized where clauses][where]
9233       many of the prelude extension traits have been consolidated.
9234     * Rust's rudimentary reflection [has been removed][refl], as it
9235       incurred too much code generation for little benefit.
9236     * [Struct variants][structvars] are no longer feature-gated.
9237     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9238       known as 'higher-ranked trait bounds', this crucially allows
9239       unboxed closures to work.
9240     * Macros invocations surrounded by parens or square brackets and
9241       not terminated by a semicolon are [parsed as
9242       expressions][macros], which makes expressions like `vec![1i32,
9243       2, 3].len()` work as expected.
9244     * Trait objects now implement their traits automatically, and
9245       traits that can be coerced to objects now must be [object
9246       safe][objsafe].
9247     * Automatically deriving traits is now done with `#[derive(...)]`
9248       not `#[deriving(...)]` for [consistency with other naming
9249       conventions][derive].
9250     * Importing the containing module or enum at the same time as
9251       items or variants they contain is [now done with `self` instead
9252       of `mod`][self], as in use `foo::{self, bar}`
9253     * Glob imports are no longer feature-gated.
9254     * The `box` operator and `box` patterns have been feature-gated
9255       pending a redesign. For now unique boxes should be allocated
9256       like other containers, with `Box::new`.
9257
9258 * Libraries
9259
9260     * A [series][coll1] of [efforts][coll2] to establish
9261       [conventions][coll3] for collections types has resulted in API
9262       improvements throughout the standard library.
9263     * New [APIs for error handling][err] provide ergonomic interop
9264       between error types, and [new conventions][err-conv] describe
9265       more clearly the recommended error handling strategies in Rust.
9266     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9267       it is easier to discuss failure in the context of error handling
9268       without making clarifications as to whether you are referring to
9269       the 'fail' macro or failure more generally.
9270     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9271       syscall when available.
9272     * The 'serialize' crate has been renamed 'rustc-serialize' and
9273       moved out of the distribution to Cargo. Although it is widely
9274       used now, it is expected to be superseded in the near future.
9275     * The `Show` formatter, typically implemented with
9276       `#[derive(Show)]` is [now requested with the `{:?}`
9277       specifier][show] and is intended for use by all types, for uses
9278       such as `println!` debugging. The new `String` formatter must be
9279       implemented by hand, uses the `{}` specifier, and is intended
9280       for full-fidelity conversions of things that can logically be
9281       represented as strings.
9282
9283 * Tooling
9284
9285     * [Flexible target specification][flex] allows rustc's code
9286       generation to be configured to support otherwise-unsupported
9287       platforms.
9288     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9289       respective debuggers with Rust-appropriate pretty-printing.
9290     * The Windows installation of Rust is distributed with the
9291       MinGW components currently required to link binaries on that
9292       platform.
9293
9294 * Misc
9295
9296     * Nullable enum optimizations have been extended to more types so
9297       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9298       space than the inner types themselves.
9299     * Work has begun on supporting AArch64.
9300
9301 [Cargo]: https://crates.io
9302 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9303 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9304 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9305 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9306 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9307 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9308 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9309 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9310 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9311 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9312 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9313 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9314 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9315 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9316 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9317 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9318 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9319 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9320 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9321 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9322 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9323 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9324 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9325 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9326 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9327 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9328 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9329 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9330 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9331 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9332 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9333 [trpl]: https://doc.rust-lang.org/book/index.html
9334 [rbe]: http://rustbyexample.com/
9335
9336
9337 Version 0.12.0 (2014-10-09)
9338 =============================
9339
9340   * ~1900 changes, numerous bugfixes
9341
9342   * Highlights
9343
9344     * The introductory documentation (now called The Rust Guide) has
9345       been completely rewritten, as have a number of supplementary
9346       guides.
9347     * Rust's package manager, Cargo, continues to improve and is
9348       sometimes considered to be quite awesome.
9349     * Many API's in `std` have been reviewed and updated for
9350       consistency with the in-development Rust coding
9351       guidelines. The standard library documentation tracks
9352       stabilization progress.
9353     * Minor libraries have been moved out-of-tree to the rust-lang org
9354       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9355       be installed with Cargo.
9356     * Lifetime elision allows lifetime annotations to be left off of
9357       function declarations in many common scenarios.
9358     * Rust now works on 64-bit Windows.
9359
9360   * Language
9361     * Indexing can be overloaded with the `Index` and `IndexMut`
9362       traits.
9363     * The `if let` construct takes a branch only if the `let` pattern
9364       matches, currently behind the 'if_let' feature gate.
9365     * 'where clauses', a more flexible syntax for specifying trait
9366       bounds that is more aesthetic, have been added for traits and
9367       free functions. Where clauses will in the future make it
9368       possible to constrain associated types, which would be
9369       impossible with the existing syntax.
9370     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9371       the 'slicing_syntax' feature gate, and can be overloaded with
9372       the `Slice` or `SliceMut` traits.
9373     * The syntax for matching of sub-slices has been changed to use a
9374       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9375       consistency with other uses of `..` and to future-proof
9376       potential additional uses of the syntax.
9377     * The syntax for matching inclusive ranges in patterns has changed
9378       from `0..3` to `0...4` to be consistent with the exclusive range
9379       syntax for slicing.
9380     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9381       c]`) has been put behind the 'advanced_slice_patterns' feature
9382       gate and may be removed in the future.
9383     * Components of tuples and tuple structs can be extracted using
9384       the `value.0` syntax, currently behind the `tuple_indexing`
9385       feature gate.
9386     * The `#[crate_id]` attribute is no longer supported; versioning
9387       is handled by the package manager.
9388     * Renaming crate imports are now written `extern crate foo as bar`
9389       instead of `extern crate bar = foo`.
9390     * Renaming use statements are now written `use foo as bar` instead
9391       of `use bar = foo`.
9392     * `let` and `match` bindings and argument names in macros are now
9393       hygienic.
9394     * The new, more efficient, closure types ('unboxed closures') have
9395       been added under a feature gate, 'unboxed_closures'. These will
9396       soon replace the existing closure types, once higher-ranked
9397       trait lifetimes are added to the language.
9398     * `move` has been added as a keyword, for indicating closures
9399       that capture by value.
9400     * Mutation and assignment is no longer allowed in pattern guards.
9401     * Generic structs and enums can now have trait bounds.
9402     * The `Share` trait is now called `Sync` to free up the term
9403       'shared' to refer to 'shared reference' (the default reference
9404       type.
9405     * Dynamically-sized types have been mostly implemented,
9406       unifying the behavior of fat-pointer types with the rest of the
9407       type system.
9408     * As part of dynamically-sized types, the `Sized` trait has been
9409       introduced, which qualifying types implement by default, and
9410       which type parameters expect by default. To specify that a type
9411       parameter does not need to be sized, write `<Sized? T>`. Most
9412       types are `Sized`, notable exceptions being unsized arrays
9413       (`[T]`) and trait types.
9414     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9415     * Lifetime bounds can now be applied to type parameters and object
9416       types.
9417     * The old, reference counted GC type, `Gc<T>` which was once
9418       denoted by the `@` sigil, has finally been removed. GC will be
9419       revisited in the future.
9420
9421   * Libraries
9422     * Library documentation has been improved for a number of modules.
9423     * Bit-vectors, collections::bitv has been modernized.
9424     * The url crate is deprecated in favor of
9425       http://github.com/servo/rust-url, which can be installed with
9426       Cargo.
9427     * Most I/O stream types can be cloned and subsequently closed from
9428       a different thread.
9429     * A `std::time::Duration` type has been added for use in I/O
9430       methods that rely on timers, as well as in the 'time' crate's
9431       `Timespec` arithmetic.
9432     * The runtime I/O abstraction layer that enabled the green thread
9433       scheduler to do non-thread-blocking I/O has been removed, along
9434       with the libuv-based implementation employed by the green thread
9435       scheduler. This will greatly simplify the future I/O work.
9436     * `collections::btree` has been rewritten to have a more
9437       idiomatic and efficient design.
9438
9439   * Tooling
9440     * rustdoc output now indicates the stability levels of API's.
9441     * The `--crate-name` flag can specify the name of the crate
9442       being compiled, like `#[crate_name]`.
9443     * The `-C metadata` specifies additional metadata to hash into
9444       symbol names, and `-C extra-filename` specifies additional
9445       information to put into the output filename, for use by the
9446       package manager for versioning.
9447     * debug info generation has continued to improve and should be
9448       more reliable under both gdb and lldb.
9449     * rustc has experimental support for compiling in parallel
9450       using the `-C codegen-units` flag.
9451     * rustc no longer encodes rpath information into binaries by
9452       default.
9453
9454   * Misc
9455     * Stack usage has been optimized with LLVM lifetime annotations.
9456     * Official Rust binaries on Linux are more compatible with older
9457       kernels and distributions, built on CentOS 5.10.
9458
9459
9460 Version 0.11.0 (2014-07-02)
9461 ==========================
9462
9463   * ~1700 changes, numerous bugfixes
9464
9465   * Language
9466     * ~[T] has been removed from the language. This type is superseded by
9467       the Vec<T> type.
9468     * ~str has been removed from the language. This type is superseded by
9469       the String type.
9470     * ~T has been removed from the language. This type is superseded by the
9471       Box<T> type.
9472     * @T has been removed from the language. This type is superseded by the
9473       standard library's std::gc::Gc<T> type.
9474     * Struct fields are now all private by default.
9475     * Vector indices and shift amounts are both required to be a `uint`
9476       instead of any integral type.
9477     * Byte character, byte string, and raw byte string literals are now all
9478       supported by prefixing the normal literal with a `b`.
9479     * Multiple ABIs are no longer allowed in an ABI string
9480     * The syntax for lifetimes on closures/procedures has been tweaked
9481       slightly: `<'a>|A, B|: 'b + K -> T`
9482     * Floating point modulus has been removed from the language; however it
9483       is still provided by a library implementation.
9484     * Private enum variants are now disallowed.
9485     * The `priv` keyword has been removed from the language.
9486     * A closure can no longer be invoked through a &-pointer.
9487     * The `use foo, bar, baz;` syntax has been removed from the language.
9488     * The transmute intrinsic no longer works on type parameters.
9489     * Statics now allow blocks/items in their definition.
9490     * Trait bounds are separated from objects with + instead of : now.
9491     * Objects can no longer be read while they are mutably borrowed.
9492     * The address of a static is now marked as insignificant unless the
9493       #[inline(never)] attribute is placed it.
9494     * The #[unsafe_destructor] attribute is now behind a feature gate.
9495     * Struct literals are no longer allowed in ambiguous positions such as
9496       if, while, match, and for..in.
9497     * Declaration of lang items and intrinsics are now feature-gated by
9498       default.
9499     * Integral literals no longer default to `int`, and floating point
9500       literals no longer default to `f64`. Literals must be suffixed with an
9501       appropriate type if inference cannot determine the type of the
9502       literal.
9503     * The Box<T> type is no longer implicitly borrowed to &mut T.
9504     * Procedures are now required to not capture borrowed references.
9505
9506   * Libraries
9507     * The standard library is now a "facade" over a number of underlying
9508       libraries. This means that development on the standard library should
9509       be speedier due to smaller crates, as well as a clearer line between
9510       all dependencies.
9511     * A new library, libcore, lives under the standard library's facade
9512       which is Rust's "0-assumption" library, suitable for embedded and
9513       kernel development for example.
9514     * A regex crate has been added to the standard distribution. This crate
9515       includes statically compiled regular expressions.
9516     * The unwrap/unwrap_err methods on Result require a Show bound for
9517       better error messages.
9518     * The return types of the std::comm primitives have been centralized
9519       around the Result type.
9520     * A number of I/O primitives have gained the ability to time out their
9521       operations.
9522     * A number of I/O primitives have gained the ability to close their
9523       reading/writing halves to cancel pending operations.
9524     * Reverse iterator methods have been removed in favor of `rev()` on
9525       their forward-iteration counterparts.
9526     * A bitflags! macro has been added to enable easy interop with C and
9527       management of bit flags.
9528     * A debug_assert! macro is now provided which is disabled when
9529       `--cfg ndebug` is passed to the compiler.
9530     * A graphviz crate has been added for creating .dot files.
9531     * The std::cast module has been migrated into std::mem.
9532     * The std::local_data api has been migrated from freestanding functions
9533       to being based on methods.
9534     * The Pod trait has been renamed to Copy.
9535     * jemalloc has been added as the default allocator for types.
9536     * The API for allocating memory has been changed to use proper alignment
9537       and sized deallocation
9538     * Connecting a TcpStream or binding a TcpListener is now based on a
9539       string address and a u16 port. This allows connecting to a hostname as
9540       opposed to an IP.
9541     * The Reader trait now contains a core method, read_at_least(), which
9542       correctly handles many repeated 0-length reads.
9543     * The process-spawning API is now centered around a builder-style
9544       Command struct.
9545     * The :? printing qualifier has been moved from the standard library to
9546       an external libdebug crate.
9547     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9548       have been renamed to Eq/Ord.
9549     * The select/plural methods have been removed from format!. The escapes
9550       for { and } have also changed from \{ and \} to {{ and }},
9551       respectively.
9552     * The TaskBuilder API has been re-worked to be a true builder, and
9553       extension traits for spawning native/green tasks have been added.
9554
9555   * Tooling
9556     * All breaking changes to the language or libraries now have their
9557       commit message annotated with `[breaking-change]` to allow for easy
9558       discovery of breaking changes.
9559     * The compiler will now try to suggest how to annotate lifetimes if a
9560       lifetime-related error occurs.
9561     * Debug info continues to be improved greatly with general bug fixes and
9562       better support for situations like link time optimization (LTO).
9563     * Usage of syntax extensions when cross-compiling has been fixed.
9564     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9565       -fdata-sections and --gc-sections has been enabled by default
9566     * The compiler is now stricter about where it will load module files
9567       from when a module is declared via `mod foo;`.
9568     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9569       Syntax extensions are now discovered via a "plugin registrar" type
9570       which will be extended in the future to other various plugins.
9571     * Lints have been restructured to allow for dynamically loadable lints.
9572     * A number of rustdoc improvements:
9573       * The HTML output has been visually redesigned.
9574       * Markdown is now powered by hoedown instead of sundown.
9575       * Searching heuristics have been greatly improved.
9576       * The search index has been reduced in size by a great amount.
9577       * Cross-crate documentation via `pub use` has been greatly improved.
9578       * Primitive types are now hyperlinked and documented.
9579     * Documentation has been moved from static.rust-lang.org/doc to
9580       doc.rust-lang.org
9581     * A new sandbox, play.rust-lang.org, is available for running and
9582       sharing rust code examples on-line.
9583     * Unused attributes are now more robustly warned about.
9584     * The dead_code lint now warns about unused struct fields.
9585     * Cross-compiling to iOS is now supported.
9586     * Cross-compiling to mipsel is now supported.
9587     * Stability attributes are now inherited by default and no longer apply
9588       to intra-crate usage, only inter-crate usage.
9589     * Error message related to non-exhaustive match expressions have been
9590       greatly improved.
9591
9592
9593 Version 0.10 (2014-04-03)
9594 =========================
9595
9596   * ~1500 changes, numerous bugfixes
9597
9598   * Language
9599     * A new RFC process is now in place for modifying the language.
9600     * Patterns with `@`-pointers have been removed from the language.
9601     * Patterns with unique vectors (`~[T]`) have been removed from the
9602       language.
9603     * Patterns with unique strings (`~str`) have been removed from the
9604       language.
9605     * `@str` has been removed from the language.
9606     * `@[T]` has been removed from the language.
9607     * `@self` has been removed from the language.
9608     * `@Trait` has been removed from the language.
9609     * Headers on `~` allocations which contain `@` boxes inside the type for
9610       reference counting have been removed.
9611     * The semantics around the lifetimes of temporary expressions have changed,
9612       see #3511 and #11585 for more information.
9613     * Cross-crate syntax extensions are now possible, but feature gated. See
9614       #11151 for more information. This includes both `macro_rules!` macros as
9615       well as syntax extensions such as `format!`.
9616     * New lint modes have been added, and older ones have been turned on to be
9617       warn-by-default.
9618       * Unnecessary parentheses
9619       * Uppercase statics
9620       * Camel Case types
9621       * Uppercase variables
9622       * Publicly visible private types
9623       * `#[deriving]` with raw pointers
9624     * Unsafe functions can no longer be coerced to closures.
9625     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9626     * The `#[simd]` attribute is now behind a feature gate.
9627     * Visibility is no longer allowed on `extern crate` statements, and
9628       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9629     * Trailing commas are now allowed in argument lists and tuple patterns.
9630     * The `do` keyword has been removed, it is now a reserved keyword.
9631     * Default type parameters have been implemented, but are feature gated.
9632     * Borrowed variables through captures in closures are now considered soundly.
9633     * `extern mod` is now `extern crate`
9634     * The `Freeze` trait has been removed.
9635     * The `Share` trait has been added for types that can be shared among
9636       threads.
9637     * Labels in macros are now hygienic.
9638     * Expression/statement macro invocations can be delimited with `{}` now.
9639     * Treatment of types allowed in `static mut` locations has been tweaked.
9640     * The `*` and `.` operators are now overloadable through the `Deref` and
9641       `DerefMut` traits.
9642     * `~Trait` and `proc` no longer have `Send` bounds by default.
9643     * Partial type hints are now supported with the `_` type marker.
9644     * An `Unsafe` type was introduced for interior mutability. It is now
9645       considered undefined to transmute from `&T` to `&mut T` without using the
9646       `Unsafe` type.
9647     * The #[linkage] attribute was implemented for extern statics/functions.
9648     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9649     * `Pod` was renamed to `Copy`.
9650
9651   * Libraries
9652     * The `libextra` library has been removed. It has now been decomposed into
9653       component libraries with smaller and more focused nuggets of
9654       functionality. The full list of libraries can be found on the
9655       documentation index page.
9656     * std: `std::condition` has been removed. All I/O errors are now propagated
9657       through the `Result` type. In order to assist with error handling, a
9658       `try!` macro for unwrapping errors with an early return and a lint for
9659       unused results has been added. See #12039 for more information.
9660     * std: The `vec` module has been renamed to `slice`.
9661     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9662       This will become the only growable vector in the future.
9663     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9664       are now found at `std::io::BufferedReader` instead of
9665       `std::io::buffered::BufferedReader`.
9666     * std: `print` and `println` are no longer in the prelude, the `print!` and
9667       `println!` macros are intended to be used instead.
9668     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9669       attempts to statically prevent cycles.
9670     * std: The standard distribution is adopting the policy of pushing failure
9671       to the user rather than failing in libraries. Many functions (such as
9672       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9673     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9674       deriving mode: `#[deriving(Show)]`.
9675     * std: `ToStr` is now implemented for all types implementing `Show`.
9676     * std: The formatting trait methods now take `&self` instead of `&T`
9677     * std: The `invert()` method on iterators has been renamed to `rev()`
9678     * std: `std::num` has seen a reduction in the genericity of its traits,
9679       consolidating functionality into a few core traits.
9680     * std: Backtraces are now printed on task failure if the environment
9681       variable `RUST_BACKTRACE` is present.
9682     * std: Naming conventions for iterators have been standardized. More details
9683       can be found on the wiki's style guide.
9684     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9685       still implement the function.
9686     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9687     * std: `assert_approx_eq!` has been removed
9688     * std: The `e` and `E` formatting specifiers for floats have been added to
9689       print them in exponential notation.
9690     * std: The `Times` trait has been removed
9691     * std: Indications of variance and opting out of builtin bounds is done
9692       through marker types in `std::kinds::marker` now
9693     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9694       `#[deriving(Hash)]` is now possible.
9695     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9696     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9697     * std: `Chan::new` is now `channel()`.
9698     * std: A new synchronous channel type has been implemented.
9699     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9700     * std: `hashmap` and `trie` have been moved to `libcollections`
9701     * std: `run` has been rolled into `io::process`
9702     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9703     * std: The equality and comparison traits have seen some reorganization.
9704     * std: `rand` has moved to `librand`.
9705     * std: `to_{lower,upper}case` has been implemented for `char`.
9706     * std: Logging has been moved to `liblog`.
9707     * collections: `HashMap` has been rewritten for higher performance and less
9708       memory usage.
9709     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9710       it can be booted manually. The runtime guide has more information and
9711       examples.
9712     * native: All I/O functionality except signals has been implemented.
9713     * green: Task spawning with `libgreen` has been optimized with stack caching
9714       and various trimming of code.
9715     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9716     * sync: The `extra::sync` module has been updated to modern rust (and moved
9717       to the `sync` library), tweaking and improving various interfaces while
9718       dropping redundant functionality.
9719     * sync: A new `Barrier` type has been added to the `sync` library.
9720     * sync: An efficient mutex for native and green tasks has been implemented.
9721     * serialize: The `base64` module has seen some improvement. It treats
9722       newlines better, has non-string error values, and has seen general
9723       cleanup.
9724     * fourcc: A `fourcc!` macro was introduced
9725     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9726       hexadecimal literal.
9727
9728   * Tooling
9729     * `rustpkg` has been deprecated and removed from the main repository. Its
9730       replacement, `cargo`, is under development.
9731     * Nightly builds of rust are now available
9732     * The memory usage of rustc has been improved many times throughout this
9733       release cycle.
9734     * The build process supports disabling rpath support for the rustc binary
9735       itself.
9736     * Code generation has improved in some cases, giving more information to the
9737       LLVM optimization passes to enable more extensive optimizations.
9738     * Debuginfo compatibility with lldb on OSX has been restored.
9739     * The master branch is now gated on an android bot, making building for
9740       android much more reliable.
9741     * Output flags have been centralized into one `--emit` flag.
9742     * Crate type flags have been centralized into one `--crate-type` flag.
9743     * Codegen flags have been consolidated behind a `-C` flag.
9744     * Linking against outdated crates now has improved error messages.
9745     * Error messages with lifetimes will often suggest how to annotate the
9746       function to fix the error.
9747     * Many more types are documented in the standard library, and new guides
9748       were written.
9749     * Many `rustdoc` improvements:
9750       * code blocks are syntax highlighted.
9751       * render standalone markdown files.
9752       * the --test flag tests all code blocks by default.
9753       * exported macros are displayed.
9754       * re-exported types have their documentation inlined at the location of the
9755         first re-export.
9756       * search works across crates that have been rendered to the same output
9757         directory.
9758
9759
9760 Version 0.9 (2014-01-09)
9761 ==========================
9762
9763    * ~1800 changes, numerous bugfixes
9764
9765    * Language
9766       * The `float` type has been removed. Use `f32` or `f64` instead.
9767       * A new facility for enabling experimental features (feature gating) has
9768         been added, using the crate-level `#[feature(foo)]` attribute.
9769       * Managed boxes (@) are now behind a feature gate
9770         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9771         standard library's `Gc` or `Rc` types instead.
9772       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9773       * Jumping back to the top of a loop is now done with `continue` instead of
9774         `loop`.
9775       * Strings can no longer be mutated through index assignment.
9776       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9777         hash delimiters, as in `r###"foo"###`.
9778       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9779         called once.
9780       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9781       * `@fn`s have been removed.
9782       * `do` only works with procs in order to make it obvious what the cost
9783         of `do` is.
9784       * Single-element tuple-like structs can no longer be dereferenced to
9785         obtain the inner value. A more comprehensive solution for overloading
9786         the dereference operator will be provided in the future.
9787       * The `#[link(...)]` attribute has been replaced with
9788         `#[crate_id = "name#vers"]`.
9789       * Empty `impl`s must be terminated with empty braces and may not be
9790         terminated with a semicolon.
9791       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9792         no longer has any special meaning.
9793       * The old `fmt!` string formatting macro has been removed.
9794       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9795         `print!` and `println!`.
9796       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9797       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9798         `extern mod foo = "bar"` instead.
9799       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9800       * Macros can have attributes.
9801       * Macros can expand to items with attributes.
9802       * Macros can expand to multiple items.
9803       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9804       * Comments may be nested.
9805       * Values automatically coerce to trait objects they implement, without
9806         an explicit `as`.
9807       * Enum discriminants are no longer an entire word but as small as needed to
9808         contain all the variants. The `repr` attribute can be used to override
9809         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9810         `#[repr(C)]` to match C enums.
9811       * Non-string literals are not allowed in attributes (they never worked).
9812       * The FFI now supports variadic functions.
9813       * Octal numeric literals, as in `0o7777`.
9814       * The `concat!` syntax extension performs compile-time string concatenation.
9815       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9816         removed as Rust no longer uses segmented stacks.
9817       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9818       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9819         not `*`; ignoring remaining fields of a struct is also done with `..`,
9820         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9821       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9822       * `rustc` supports the "system" calling convention, which defaults to the
9823         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9824         "C" elsewhere.
9825       * The `type_overflow` lint (default: warn) checks literals for overflow.
9826       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9827       * The `attribute_usage` lint (default: warn) warns about unknown
9828         attributes.
9829       * The `unknown_features` lint (default: warn) warns about unknown
9830         feature gates.
9831       * The `dead_code` lint (default: warn) checks for dead code.
9832       * Rust libraries can be linked statically to one another
9833       * `#[link_args]` is behind the `link_args` feature gate.
9834       * Native libraries are now linked with `#[link(name = "foo")]`
9835       * Native libraries can be statically linked to a rust crate
9836         (`#[link(name = "foo", kind = "static")]`).
9837       * Native OS X frameworks are now officially supported
9838         (`#[link(name = "foo", kind = "framework")]`).
9839       * The `#[thread_local]` attribute creates thread-local (not task-local)
9840         variables. Currently behind the `thread_local` feature gate.
9841       * The `return` keyword may be used in closures.
9842       * Types that can be copied via a memcpy implement the `Pod` kind.
9843       * The `cfg` attribute can now be used on struct fields and enum variants.
9844
9845    * Libraries
9846       * std: The `option` and `result` API's have been overhauled to make them
9847         simpler, more consistent, and more composable.
9848       * std: The entire `std::io` module has been replaced with one that is
9849         more comprehensive and that properly interfaces with the underlying
9850         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9851         implemented.
9852       * std: `io::util` contains a number of useful implementations of
9853         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9854         `ZeroReader`, `TeeReader`.
9855       * std: The reference counted pointer type `extra::rc` moved into std.
9856       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9857         just a wrapper around it).
9858       * std: The `Either` type has been removed.
9859       * std: `fmt::Default` can be implemented for any type to provide default
9860         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9861       * std: The `rand` API continues to be tweaked.
9862       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9863         on failure in gdb, is now named `rust_fail`.
9864       * std: The `each_key` and `each_value` methods on `HashMap` have been
9865         replaced by the `keys` and `values` iterators.
9866       * std: Functions dealing with type size and alignment have moved from the
9867         `sys` module to the `mem` module.
9868       * std: The `path` module was written and API changed.
9869       * std: `str::from_utf8` has been changed to cast instead of allocate.
9870       * std: `starts_with` and `ends_with` methods added to vectors via the
9871         `ImmutableEqVector` trait, which is in the prelude.
9872       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9873         if the index is out of bounds.
9874       * std: Task failure no longer propagates between tasks, as the model was
9875         complex, expensive, and incompatible with thread-based tasks.
9876       * std: The `Any` type can be used for dynamic typing.
9877       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9878         `task::try`.
9879       * std: Methods that produce iterators generally do not have an `_iter`
9880         suffix now.
9881       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9882         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9883       * std: `util::ignore` renamed to `prelude::drop`.
9884       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9885         trait.
9886       * std: `vec::raw` has seen a lot of cleanup and API changes.
9887       * std: The standard library no longer includes any C++ code, and very
9888         minimal C, eliminating the dependency on libstdc++.
9889       * std: Runtime scheduling and I/O functionality has been factored out into
9890         extensible interfaces and is now implemented by two different crates:
9891         libnative, for native threading and I/O; and libgreen, for green threading
9892         and I/O. This paves the way for using the standard library in more limited
9893         embedded environments.
9894       * std: The `comm` module has been rewritten to be much faster, have a
9895         simpler, more consistent API, and to work for both native and green
9896         threading.
9897       * std: All libuv dependencies have been moved into the rustuv crate.
9898       * native: New implementations of runtime scheduling on top of OS threads.
9899       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9900         and other I/O.
9901       * green: The green thread scheduler and message passing types are almost
9902         entirely lock-free.
9903       * extra: The `flatpipes` module had bitrotted and was removed.
9904       * extra: All crypto functions have been removed and Rust now has a policy of
9905         not reimplementing crypto in the standard library. In the future crypto
9906         will be provided by external crates with bindings to established libraries.
9907       * extra: `c_vec` has been modernized.
9908       * extra: The `sort` module has been removed. Use the `sort` method on
9909         mutable slices.
9910
9911    * Tooling
9912       * The `rust` and `rusti` commands have been removed, due to lack of
9913         maintenance.
9914       * `rustdoc` was completely rewritten.
9915       * `rustdoc` can test code examples in documentation.
9916       * `rustpkg` can test packages with the argument, 'test'.
9917       * `rustpkg` supports arbitrary dependencies, including C libraries.
9918       * `rustc`'s support for generating debug info is improved again.
9919       * `rustc` has better error reporting for unbalanced delimiters.
9920       * `rustc`'s JIT support was removed due to bitrot.
9921       * Executables and static libraries can be built with LTO (-Z lto)
9922       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9923         build tools.
9924
9925
9926 Version 0.8 (2013-09-26)
9927 ============================
9928
9929    * ~2200 changes, numerous bugfixes
9930
9931    * Language
9932       * The `for` loop syntax has changed to work with the `Iterator` trait.
9933       * At long last, unwinding works on Windows.
9934       * Default methods are ready for use.
9935       * Many trait inheritance bugs fixed.
9936       * Owned and borrowed trait objects work more reliably.
9937       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9938       * rustc can omit emission of code for the `debug!` macro if it is passed
9939         `--cfg ndebug`
9940       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9941         for foo.rs, then foo/mod.rs, and will generate an error when both are
9942         present.
9943       * Strings no longer contain trailing nulls. The new `std::c_str` module
9944         provides new mechanisms for converting to C strings.
9945       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9946       * The FFI has been overhauled such that foreign functions are called directly,
9947         instead of through a stack-switching wrapper.
9948       * Calling a foreign function must be done through a Rust function with the
9949         `#[fixed_stack_segment]` attribute.
9950       * The `externfn!` macro can be used to declare both a foreign function and
9951         a `#[fixed_stack_segment]` wrapper at once.
9952       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9953       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9954       * `priv` is disallowed everywhere except for struct fields and enum variants.
9955       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9956       * `ref` bindings in irrefutable patterns work correctly now.
9957       * `char` is now prevented from containing invalid code points.
9958       * Casting to `bool` is no longer allowed.
9959       * `\0` is now accepted as an escape in chars and strings.
9960       * `yield` is a reserved keyword.
9961       * `typeof` is a reserved keyword.
9962       * Crates may be imported by URL with `extern mod foo = "url";`.
9963       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9964       * Static vectors can be initialized with repeating elements,
9965         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9966       * Static structs can be initialized with functional record update,
9967         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9968       * `cfg!` can be used to conditionally execute code based on the crate
9969         configuration, similarly to `#[cfg(...)]`.
9970       * The `unnecessary_qualification` lint detects unneeded module
9971         prefixes (default: allow).
9972       * Arithmetic operations have been implemented on the SIMD types in
9973         `std::unstable::simd`.
9974       * Exchange allocation headers were removed, reducing memory usage.
9975       * `format!` implements a completely new, extensible, and higher-performance
9976         string formatting system. It will replace `fmt!`.
9977       * `print!` and `println!` write formatted strings (using the `format!`
9978         extension) to stdout.
9979       * `write!` and `writeln!` write formatted strings (using the `format!`
9980         extension) to the new Writers in `std::rt::io`.
9981       * The library section in which a function or static is placed may
9982         be specified with `#[link_section = "..."]`.
9983       * The `proto!` syntax extension for defining bounded message protocols
9984         was removed.
9985       * `macro_rules!` is hygienic for `let` declarations.
9986       * The `#[export_name]` attribute specifies the name of a symbol.
9987       * `unreachable!` can be used to indicate unreachable code, and fails
9988         if executed.
9989
9990    * Libraries
9991       * std: Transitioned to the new runtime, written in Rust.
9992       * std: Added an experimental I/O library, `rt::io`, based on the new
9993         runtime.
9994       * std: A new generic `range` function was added to the prelude, replacing
9995         `uint::range` and friends.
9996       * std: `range_rev` no longer exists. Since range is an iterator it can be
9997         reversed with `range(lo, hi).invert()`.
9998       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9999         renamed to `unwrap_or`.
10000       * std: The `iterator` module was renamed to `iter`.
10001       * std: Integral types now support the `checked_add`, `checked_sub`, and
10002         `checked_mul` operations for detecting overflow.
10003       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10004         consistency.
10005       * std: Methods are standardizing on conventions for casting methods:
10006         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10007         and cheap casts.
10008       * std: The `CString` type in `c_str` provides new ways to convert to and
10009         from C strings.
10010       * std: `DoubleEndedIterator` can yield elements in two directions.
10011       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10012         two splices.
10013       * std: `str::from_bytes` renamed to `str::from_utf8`.
10014       * std: `pop_opt` and `shift_opt` methods added to vectors.
10015       * std: The task-local data interface no longer uses @, and keys are
10016         no longer function pointers.
10017       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10018       * std: Added `SharedPort` to `comm`.
10019       * std: `Eq` has a default method for `ne`; only `eq` is required
10020         in implementations.
10021       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10022         is required in implementations.
10023       * std: `is_utf8` performance is improved, impacting many string functions.
10024       * std: `os::MemoryMap` provides cross-platform mmap.
10025       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10026         are not 'in-bounds' are considered undefined.
10027       * std: Many freestanding functions in `vec` removed in favor of methods.
10028       * std: Many freestanding functions on scalar types removed in favor of
10029         methods.
10030       * std: Many options to task builders were removed since they don't make
10031         sense in the new scheduler design.
10032       * std: More containers implement `FromIterator` so can be created by the
10033         `collect` method.
10034       * std: More complete atomic types in `unstable::atomics`.
10035       * std: `comm::PortSet` removed.
10036       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10037         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10038         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10039         default implementations.
10040       * std: Various `from_str` functions were removed in favor of a generic
10041         `from_str` which is available in the prelude.
10042       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10043       * extra: `dlist`, the doubly-linked list was modernized.
10044       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10045       * extra: Added `glob` module, replacing `std::os::glob`.
10046       * extra: `rope` was removed.
10047       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10048       * extra: `net`, and `timer` were removed. The experimental replacements
10049         are `std::rt::io::net` and `std::rt::io::timer`.
10050       * extra: Iterators implemented for `SmallIntMap`.
10051       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10052       * extra: `SmallIntSet` removed. Use `BitvSet`.
10053       * extra: Performance of JSON parsing greatly improved.
10054       * extra: `semver` updated to SemVer 2.0.0.
10055       * extra: `term` handles more terminals correctly.
10056       * extra: `dbg` module removed.
10057       * extra: `par` module removed.
10058       * extra: `future` was cleaned up, with some method renames.
10059       * extra: Most free functions in `getopts` were converted to methods.
10060
10061    * Other
10062       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10063       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10064         similarly to gcc's `--march` flag.
10065       * rustc's performance compiling small crates is much better.
10066       * rustpkg has received many improvements.
10067       * rustpkg supports git tags as package IDs.
10068       * rustpkg builds into target-specific directories so it can be used for
10069         cross-compiling.
10070       * The number of concurrent test tasks is controlled by the environment
10071         variable RUST_TEST_TASKS.
10072       * The test harness can now report metrics for benchmarks.
10073       * All tools have man pages.
10074       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10075       * The runtime uses jemalloc for allocations.
10076       * Segmented stacks are temporarily disabled as part of the transition to
10077         the new runtime. Stack overflows are possible!
10078       * A new documentation backend, rustdoc_ng, is available for use. It is
10079         still invoked through the normal `rustdoc` command.
10080
10081
10082 Version 0.7 (2013-07-03)
10083 =======================
10084
10085    * ~2000 changes, numerous bugfixes
10086
10087    * Language
10088       * `impl`s no longer accept a visibility qualifier. Put them on methods
10089         instead.
10090       * The borrow checker has been rewritten with flow-sensitivity, fixing
10091         many bugs and inconveniences.
10092       * The `self` parameter no longer implicitly means `&'self self`,
10093         and can be explicitly marked with a lifetime.
10094       * Overloadable compound operators (`+=`, etc.) have been temporarily
10095         removed due to bugs.
10096       * The `for` loop protocol now requires `for`-iterators to return `bool`
10097         so they compose better.
10098       * The `Durable` trait is replaced with the `'static` bounds.
10099       * Trait default methods work more often.
10100       * Structs with the `#[packed]` attribute have byte alignment and
10101         no padding between fields.
10102       * Type parameters bound by `Copy` must now be copied explicitly with
10103         the `copy` keyword.
10104       * It is now illegal to move out of a dereferenced unsafe pointer.
10105       * `Option<~T>` is now represented as a nullable pointer.
10106       * `@mut` does dynamic borrow checks correctly.
10107       * The `main` function is only detected at the topmost level of the crate.
10108         The `#[main]` attribute is still valid anywhere.
10109       * Struct fields may no longer be mutable. Use inherited mutability.
10110       * The `#[no_send]` attribute makes a type that would otherwise be
10111         `Send`, not.
10112       * The `#[no_freeze]` attribute makes a type that would otherwise be
10113         `Freeze`, not.
10114       * Unbounded recursion will abort the process after reaching the limit
10115         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10116       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10117         are never implicitly copyable.
10118       * `#[static_assert]` makes compile-time assertions about static bools.
10119       * At long last, 'argument modes' no longer exist.
10120       * The rarely used `use mod` statement no longer exists.
10121
10122    * Syntax extensions
10123       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10124         argument list.
10125       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10126         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10127         `#[deriving(...)]`.
10128       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10129         and unsuffixed integer literals.
10130
10131    * Libraries
10132       * The `core` crate was renamed to `std`.
10133       * The `std` crate was renamed to `extra`.
10134       * More and improved documentation.
10135       * std: `iterator` module for external iterator objects.
10136       * Many old-style (internal, higher-order function) iterators replaced by
10137         implementations of `Iterator`.
10138       * std: Many old internal vector and string iterators,
10139         incl. `any`, `all`. removed.
10140       * std: The `finalize` method of `Drop` renamed to `drop`.
10141       * std: The `drop` method now takes `&mut self` instead of `&self`.
10142       * std: The prelude no longer re-exports any modules, only types and traits.
10143       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10144         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10145       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10146         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10147       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10148         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10149       * std: Many types implement `Clone`.
10150       * std: `path` type renamed to `Path`.
10151       * std: `mut` module and `Mut` type removed.
10152       * std: Many standalone functions removed in favor of methods and iterators
10153         in `vec`, `str`. In the future methods will also work as functions.
10154       * std: `reinterpret_cast` removed. Use `transmute`.
10155       * std: ascii string handling in `std::ascii`.
10156       * std: `Rand` is implemented for ~/@.
10157       * std: `run` module for spawning processes overhauled.
10158       * std: Various atomic types added to `unstable::atomic`.
10159       * std: Various types implement `Zero`.
10160       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10161       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10162       * std: Added `os::mkdir_recursive`.
10163       * std: Added `os::glob` function performs filesystems globs.
10164       * std: `FuzzyEq` renamed to `ApproxEq`.
10165       * std: `Map` now defines `pop` and `swap` methods.
10166       * std: `Cell` constructors converted to static methods.
10167       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10168       * extra: `flate` module moved from `std` to `extra`.
10169       * extra: `fileinput` module for iterating over a series of files.
10170       * extra: `Complex` number type and `complex` module.
10171       * extra: `Rational` number type and `rational` module.
10172       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10173       * extra: `term` uses terminfo now, is more correct.
10174       * extra: `arc` functions converted to methods.
10175       * extra: Implementation of fixed output size variations of SHA-2.
10176
10177    * Tooling
10178       * `unused_variables` lint mode for unused variables (default: warn).
10179       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10180         (default: warn).
10181       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10182         (default: warn).
10183       * `dead_assignment` lint mode for unread variables (default: warn).
10184       * `unnecessary_allocation` lint mode detects some heap allocations that are
10185         immediately borrowed so could be written without allocating (default: warn).
10186       * `missing_doc` lint mode (default: allow).
10187       * `unreachable_code` lint mode (default: warn).
10188       * The `rusti` command has been rewritten and a number of bugs addressed.
10189       * rustc outputs in color on more terminals.
10190       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10191       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10192       * Compiling with `-g` will make the binary record information about
10193         dynamic borrowcheck failures for debugging.
10194       * rustdoc has a nicer stylesheet.
10195       * Various improvements to rustdoc.
10196       * Improvements to rustpkg (see the detailed release notes).
10197
10198
10199 Version 0.6 (2013-04-03)
10200 ========================
10201
10202    * ~2100 changes, numerous bugfixes
10203
10204    * Syntax changes
10205       * The self type parameter in traits is now spelled `Self`
10206       * The `self` parameter in trait and impl methods must now be explicitly
10207         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10208       * Static methods no longer require the `static` keyword and instead
10209         are distinguished by the lack of a `self` parameter
10210       * Replaced the `Durable` trait with the `'static` lifetime
10211       * The old closure type syntax with the trailing sigil has been
10212         removed in favor of the more consistent leading sigil
10213       * `super` is a keyword, and may be prefixed to paths
10214       * Trait bounds are separated with `+` instead of whitespace
10215       * Traits are implemented with `impl Trait for Type`
10216         instead of `impl Type: Trait`
10217       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10218       * The `export` keyword has finally been removed
10219       * The `move` keyword has been removed (see "Semantic changes")
10220       * The interior mutability qualifier on vectors, `[mut T]`, has been
10221         removed. Use `&mut [T]`, etc.
10222       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10223       * `fail` is no longer a keyword. Use `fail!()`
10224       * `assert` is no longer a keyword. Use `assert!()`
10225       * `log` is no longer a keyword. use `debug!`, etc.
10226       * 1-tuples may be represented as `(T,)`
10227       * Struct fields may no longer be `mut`. Use inherited mutability,
10228         `@mut T`, `core::mut` or `core::cell`
10229       * `extern mod { ... }` is no longer valid syntax for foreign
10230         function modules. Use extern blocks: `extern { ... }`
10231       * Newtype enums removed. Use tuple-structs.
10232       * Trait implementations no longer support visibility modifiers
10233       * Pattern matching over vectors improved and expanded
10234       * `const` renamed to `static` to correspond to lifetime name,
10235         and make room for future `static mut` unsafe mutable globals.
10236       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10237       * `Clone` implementations can be automatically generated with
10238         `#[deriving(Clone)]`
10239       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10240         instead of `foo as Bar`.
10241       * Fixed length vector types are now written as `[int, .. 3]`
10242         instead of `[int * 3]`.
10243       * Fixed length vector types can express the length as a constant
10244         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10245
10246    * Semantic changes
10247       * Types with owned pointers or custom destructors move by default,
10248         eliminating the `move` keyword
10249       * All foreign functions are considered unsafe
10250       * &mut is now unaliasable
10251       * Writes to borrowed @mut pointers are prevented dynamically
10252       * () has size 0
10253       * The name of the main function can be customized using #[main]
10254       * The default type of an inferred closure is &fn instead of @fn
10255       * `use` statements may no longer be "chained" - they cannot import
10256         identifiers imported by previous `use` statements
10257       * `use` statements are crate relative, importing from the "top"
10258         of the crate by default. Paths may be prefixed with `super::`
10259         or `self::` to change the search behavior.
10260       * Method visibility is inherited from the implementation declaration
10261       * Structural records have been removed
10262       * Many more types can be used in static items, including enums
10263         'static-lifetime pointers and vectors
10264       * Pattern matching over vectors improved and expanded
10265       * Typechecking of closure types has been overhauled to
10266         improve inference and eliminate unsoundness
10267       * Macros leave scope at the end of modules, unless that module is
10268         tagged with #[macro_escape]
10269
10270    * Libraries
10271       * Added big integers to `std::bigint`
10272       * Removed `core::oldcomm` module
10273       * Added pipe-based `core::comm` module
10274       * Numeric traits have been reorganized under `core::num`
10275       * `vec::slice` finally returns a slice
10276       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10277       * Containers reorganized around traits in `core::container`
10278       * `core::dvec` removed, `~[T]` is a drop-in replacement
10279       * `core::send_map` renamed to `core::hashmap`
10280       * `std::map` removed; replaced with `core::hashmap`
10281       * `std::treemap` reimplemented as an owned balanced tree
10282       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10283       * `core::trie` added as a fast ordered map for integer keys
10284       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10285       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10286         overload the comparison operators, whereas `TotalOrd` is used
10287         by certain container types
10288
10289    * Other
10290       * Replaced the 'cargo' package manager with 'rustpkg'
10291       * Added all-purpose 'rust' tool
10292       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10293       * rustc now *attempts* to offer spelling suggestions
10294       * Improved support for ARM and Android
10295       * Preliminary MIPS backend
10296       * Improved foreign function ABI implementation for x86, x86_64
10297       * Various memory usage improvements
10298       * Rust code may be embedded in foreign code under limited circumstances
10299       * Inline assembler supported by new asm!() syntax extension.
10300
10301
10302 Version 0.5 (2012-12-21)
10303 ===========================
10304
10305    * ~900 changes, numerous bugfixes
10306
10307    * Syntax changes
10308       * Removed `<-` move operator
10309       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10310       * Removed old fixed length vector syntax - `[T]/N`
10311       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10312       * Macros may now expand to items and statements
10313       * `a.b()` is always parsed as a method call, never as a field projection
10314       * `Eq` and `IterBytes` implementations can be automatically generated
10315         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10316       * Removed the special crate language for `.rc` files
10317       * Function arguments may consist of any irrefutable pattern
10318
10319    * Semantic changes
10320       * `&` and `~` pointers may point to objects
10321       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10322       * Enum variants may be structs
10323       * Destructors can be added to all nominal types with the Drop trait
10324       * Structs and nullary enum variants may be constants
10325       * Values that cannot be implicitly copied are now automatically moved
10326         without writing `move` explicitly
10327       * `&T` may now be coerced to `*T`
10328       * Coercions happen in `let` statements as well as function calls
10329       * `use` statements now take crate-relative paths
10330       * The module and type namespaces have been merged so that static
10331         method names can be resolved under the trait in which they are
10332         declared
10333
10334    * Improved support for language features
10335       * Trait inheritance works in many scenarios
10336       * More support for explicit self arguments in methods - `self`, `&self`
10337         `@self`, and `~self` all generally work as expected
10338       * Static methods work in more situations
10339       * Experimental: Traits may declare default methods for the implementations
10340         to use
10341
10342    * Libraries
10343       * New condition handling system in `core::condition`
10344       * Timsort added to `std::sort`
10345       * New priority queue, `std::priority_queue`
10346       * Pipes for serializable types, `std::flatpipes'
10347       * Serialization overhauled to be trait-based
10348       * Expanded `getopts` definitions
10349       * Moved futures to `std`
10350       * More functions are pure now
10351       * `core::comm` renamed to `oldcomm`. Still deprecated
10352       * `rustdoc` and `cargo` are libraries now
10353
10354    * Misc
10355       * Added a preliminary REPL, `rusti`
10356       * License changed from MIT to dual MIT/APL2
10357
10358
10359 Version 0.4 (2012-10-15)
10360 ==========================
10361
10362    * ~2000 changes, numerous bugfixes
10363
10364    * Syntax
10365       * All keywords are now strict and may not be used as identifiers anywhere
10366       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10367         'of', 'with', 'to', 'class'.
10368       * Classes are replaced with simpler structs
10369       * Explicit method self types
10370       * `ret` became `return` and `alt` became `match`
10371       * `import` is now `use`; `use is now `extern mod`
10372       * `extern mod { ... }` is now `extern { ... }`
10373       * `use mod` is the recommended way to import modules
10374       * `pub` and `priv` replace deprecated export lists
10375       * The syntax of `match` pattern arms now uses fat arrow (=>)
10376       * `main` no longer accepts an args vector; use `os::args` instead
10377
10378    * Semantics
10379       * Trait implementations are now coherent, ala Haskell typeclasses
10380       * Trait methods may be static
10381       * Argument modes are deprecated
10382       * Borrowed pointers are much more mature and recommended for use
10383       * Strings and vectors in the static region are stored in constant memory
10384       * Typestate was removed
10385       * Resolution rewritten to be more reliable
10386       * Support for 'dual-mode' data structures (freezing and thawing)
10387
10388    * Libraries
10389       * Most binary operators can now be overloaded via the traits in
10390         `core::ops'
10391       * `std::net::url` for representing URLs
10392       * Sendable hash maps in `core::send_map`
10393       * `core::task' gained a (currently unsafe) task-local storage API
10394
10395    * Concurrency
10396       * An efficient new intertask communication primitive called the pipe,
10397         along with a number of higher-level channel types, in `core::pipes`
10398       * `std::arc`, an atomically reference counted, immutable, shared memory
10399         type
10400       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10401       * Futures are now based on pipes and sendable
10402       * More robust linked task failure
10403       * Improved task builder API
10404
10405    * Other
10406       * Improved error reporting
10407       * Preliminary JIT support
10408       * Preliminary work on precise GC
10409       * Extensive architectural improvements to rustc
10410       * Begun a transition away from buggy C++-based reflection (shape) code to
10411         Rust-based (visitor) code
10412       * All hash functions and tables converted to secure, randomized SipHash
10413
10414
10415 Version 0.3  (2012-07-12)
10416 ========================
10417
10418    * ~1900 changes, numerous bugfixes
10419
10420    * New coding conveniences
10421       * Integer-literal suffix inference
10422       * Per-item control over warnings, errors
10423       * #[cfg(windows)] and #[cfg(unix)] attributes
10424       * Documentation comments
10425       * More compact closure syntax
10426       * 'do' expressions for treating higher-order functions as
10427         control structures
10428       * *-patterns (wildcard extended to all constructor fields)
10429
10430    * Semantic cleanup
10431       * Name resolution pass and exhaustiveness checker rewritten
10432       * Region pointers and borrow checking supersede alias
10433         analysis
10434       * Init-ness checking is now provided by a region-based liveness
10435         pass instead of the typestate pass; same for last-use analysis
10436       * Extensive work on region pointers
10437
10438    * Experimental new language features
10439       * Slices and fixed-size, interior-allocated vectors
10440       * #!-comments for lang versioning, shell execution
10441       * Destructors and iface implementation for classes;
10442         type-parameterized classes and class methods
10443       * 'const' type kind for types that can be used to implement
10444         shared-memory concurrency patterns
10445
10446    * Type reflection
10447
10448    * Removal of various obsolete features
10449       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10450                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10451
10452       * Constructs: do-while loops ('do' repurposed), fn binding,
10453                     resources (replaced by destructors)
10454
10455    * Compiler reorganization
10456       * Syntax-layer of compiler split into separate crate
10457       * Clang (from LLVM project) integrated into build
10458       * Typechecker split into sub-modules
10459
10460    * New library code
10461       * New time functions
10462       * Extension methods for many built-in types
10463       * Arc: atomic-refcount read-only / exclusive-use shared cells
10464       * Par: parallel map and search routines
10465       * Extensive work on libuv interface
10466       * Much vector code moved to libraries
10467       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10468         #include, #include_str, #include_bin
10469
10470    * Tool improvements
10471       * Cargo automatically resolves dependencies
10472
10473
10474 Version 0.2  (2012-03-29)
10475 =========================
10476
10477    * >1500 changes, numerous bugfixes
10478
10479    * New docs and doc tooling
10480
10481    * New port: FreeBSD x86_64
10482
10483    * Compilation model enhancements
10484       * Generics now specialized, multiply instantiated
10485       * Functions now inlined across separate crates
10486
10487    * Scheduling, stack and threading fixes
10488       * Noticeably improved message-passing performance
10489       * Explicit schedulers
10490       * Callbacks from C
10491       * Helgrind clean
10492
10493    * Experimental new language features
10494       * Operator overloading
10495       * Region pointers
10496       * Classes
10497
10498    * Various language extensions
10499       * C-callback function types: 'crust fn ...'
10500       * Infinite-loop construct: 'loop { ... }'
10501       * Shorten 'mutable' to 'mut'
10502       * Required mutable-local qualifier: 'let mut ...'
10503       * Basic glob-exporting: 'export foo::*;'
10504       * Alt now exhaustive, 'alt check' for runtime-checked
10505       * Block-function form of 'for' loop, with 'break' and 'ret'.
10506
10507    * New library code
10508       * AST quasi-quote syntax extension
10509       * Revived libuv interface
10510       * New modules: core::{future, iter}, std::arena
10511       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10512       * Extensive cleanup, regularization in libstd, libcore
10513
10514
10515 Version 0.1  (2012-01-20)
10516 ===============================
10517
10518    * Most language features work, including:
10519       * Unique pointers, unique closures, move semantics
10520       * Interface-constrained generics
10521       * Static interface dispatch
10522       * Stack growth
10523       * Multithread task scheduling
10524       * Typestate predicates
10525       * Failure unwinding, destructors
10526       * Pattern matching and destructuring assignment
10527       * Lightweight block-lambda syntax
10528       * Preliminary macro-by-example
10529
10530    * Compiler works with the following configurations:
10531       * Linux: x86 and x86_64 hosts and targets
10532       * macOS: x86 and x86_64 hosts and targets
10533       * Windows: x86 hosts and targets
10534
10535    * Cross compilation / multi-target configuration supported.
10536
10537    * Preliminary API-documentation and package-management tools included.
10538
10539 Known issues:
10540
10541    * Documentation is incomplete.
10542
10543    * Performance is below intended target.
10544
10545    * Standard library APIs are subject to extensive change, reorganization.
10546
10547    * Language-level versioning is not yet operational - future code will
10548      break unexpectedly.