]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Auto merge of #87686 - matthiaskrgr:clippy_august_21_perf, r=jackh726
[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
74 Rustdoc
75 -------
76 - [Added "Go to item on exact match" search option.][85876]
77 - [The "Implementors" section on traits no longer shows redundant
78   method definitions.][85970]
79 - [Trait implementations are toggled open by default.][86260] This should make the
80   implementations more searchable by tools like `CTRL+F` in your browser.
81 - [Intra-doc links should now correctly resolve associated items (e.g. methods)
82   through type aliases.][86334]
83 - [Traits which are marked with `#[doc(hidden)]` will no longer appear in the
84   "Trait Implementations" section.][86513]
85
86
87 Compatibility Notes
88 -------------------
89 - [std functions that return an `io::Error` will no longer use the
90   `ErrorKind::Other` variant.][85746] This is to better reflect that these
91   kinds of errors could be categorised [into newer more specific `ErrorKind`
92   variants][79965], and that they do not represent a user error.
93 - [Using environment variable names with `process::Command` on Windows now
94   behaves as expected.][85270] Previously using envionment variables with
95   `Command` would cause them to be ASCII-uppercased.
96 - [Rustdoc will now warn on using rustdoc lints that aren't prefixed
97   with `rustdoc::`][86849]
98
99 [86849]: https://github.com/rust-lang/rust/pull/86849
100 [86513]: https://github.com/rust-lang/rust/pull/86513
101 [86334]: https://github.com/rust-lang/rust/pull/86334
102 [86260]: https://github.com/rust-lang/rust/pull/86260
103 [85970]: https://github.com/rust-lang/rust/pull/85970
104 [85876]: https://github.com/rust-lang/rust/pull/85876
105 [83572]: https://github.com/rust-lang/rust/pull/83572
106 [86294]: https://github.com/rust-lang/rust/pull/86294
107 [86858]: https://github.com/rust-lang/rust/pull/86858
108 [86761]: https://github.com/rust-lang/rust/pull/86761
109 [85769]: https://github.com/rust-lang/rust/pull/85769
110 [85746]: https://github.com/rust-lang/rust/pull/85746
111 [85305]: https://github.com/rust-lang/rust/pull/85305
112 [85270]: https://github.com/rust-lang/rust/pull/85270
113 [84111]: https://github.com/rust-lang/rust/pull/84111
114 [83918]: https://github.com/rust-lang/rust/pull/83918
115 [79965]: https://github.com/rust-lang/rust/pull/79965
116 [87370]: https://github.com/rust-lang/rust/pull/87370
117 [87298]: https://github.com/rust-lang/rust/pull/87298
118 [cargo/9675]: https://github.com/rust-lang/cargo/pull/9675
119 [cargo/9550]: https://github.com/rust-lang/cargo/pull/9550
120 [cargo/9680]: https://github.com/rust-lang/cargo/pull/9680
121 [`array::map`]: https://doc.rust-lang.org/stable/std/primitive.array.html#method.map
122 [`Bound::cloned`]: https://doc.rust-lang.org/stable/std/ops/enum.Bound.html#method.cloned
123 [`Drain::as_str`]: https://doc.rust-lang.org/stable/std/string/struct.Drain.html#method.as_str
124 [`IntoInnerError::into_error`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_error
125 [`IntoInnerError::into_parts`]: https://doc.rust-lang.org/stable/std/io/struct.IntoInnerError.html#method.into_parts
126 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_mut
127 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.assume_init_ref
128 [`MaybeUninit::write`]: https://doc.rust-lang.org/stable/std/mem/union.MaybeUninit.html#method.write
129 [`Seek::rewind`]: https://doc.rust-lang.org/stable/std/io/trait.Seek.html#method.rewind
130 [`mem::transmute`]: https://doc.rust-lang.org/stable/std/mem/fn.transmute.html
131 [`ops::ControlFlow`]: https://doc.rust-lang.org/stable/std/ops/enum.ControlFlow.html
132 [`str::from_utf8_unchecked`]: https://doc.rust-lang.org/stable/std/str/fn.from_utf8_unchecked.html
133 [`x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
134 [`x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
135 [`x86::_bittestandreset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandreset.html
136 [`x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
137 [`x86_64::_bittest64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest64.html
138 [`x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
139 [`x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
140 [`x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
141
142
143 Version 1.54.0 (2021-07-29)
144 ============================
145
146 Language
147 -----------------------
148
149 - [You can now use macros for values in built-in attribute macros.][83366]
150   While a seemingly minor addition on its own, this enables a lot of
151   powerful functionality when combined correctly. Most notably you can
152   now include external documentation in your crate by writing the following.
153   ```rust
154   #![doc = include_str!("README.md")]
155   ```
156   You can also use this to include auto-generated modules:
157   ```rust
158   #[path = concat!(env!("OUT_DIR"), "/generated.rs")]
159   mod generated;
160   ```
161
162 - [You can now cast between unsized slice types (and types which contain
163   unsized slices) in `const fn`.][85078]
164 - [You can now use multiple generic lifetimes with `impl Trait` where the
165    lifetimes don't explicitly outlive another.][84701] In code this means
166    that you can now have `impl Trait<'a, 'b>` where as before you could
167    only have `impl Trait<'a, 'b> where 'b: 'a`.
168
169 Compiler
170 -----------------------
171
172 - [Rustc will now search for custom JSON targets in
173   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
174   directory.][83800] You can find your sysroot directory by running
175   `rustc --print sysroot`.
176 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
177 - [You can now use `#[target_feature]` on safe functions when targeting
178   WebAssembly platforms.][84988]
179 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
180 - [Added tier 3\* support for `bpfel-unknown-none`
181    and `bpfeb-unknown-none`.][79608]
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 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
252 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
253 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
254 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
255 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
256 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
257 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
258 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
259 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
260 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
261 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
262
263 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
264
265 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
266
267 Version 1.53.0 (2021-06-17)
268 ============================
269
270 Language
271 -----------------------
272 - [You can now use unicode for identifiers.][83799] This allows multilingual
273   identifiers but still doesn't allow glyphs that are not considered characters
274   such as `◆` or `🦀`. More specifically you can now use any identifier that
275   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
276   is the same standard as languages like Python, however Rust uses NFC
277   normalization which may be different from other languages.
278 - [You can now specify "or patterns" inside pattern matches.][79278]
279   Previously you could only use `|` (OR) on complete patterns. E.g.
280   ```rust
281   let x = Some(2u8);
282   // Before
283   matches!(x, Some(1) | Some(2));
284   // Now
285   matches!(x, Some(1 | 2));
286   ```
287 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
288   has the same semantics as the `:pat` matcher. This is to allow `:pat`
289   to change semantics to being a pattern fragment in a future edition.
290
291 Compiler
292 -----------------------
293 - [Updated the minimum external LLVM version to LLVM 10.][83387]
294 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
295 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
296
297 \* Refer to Rust's [platform support page][platform-support-doc] for more
298 information on Rust's tiered platform support.
299
300 Libraries
301 -----------------------
302 - [Abort messages will now forward to `android_set_abort_message` on
303   Android platforms when available.][81469]
304 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
305 - [Arrays of any length now implement `IntoIterator`.][84147]
306   Currently calling `.into_iter()` as a method on an array will
307   return `impl Iterator<Item=&T>`, but this may change in a
308   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
309   directly on arrays will provide `impl Iterator<Item=T>` as expected.
310 - [`leading_zeros`, and `trailing_zeros` are now available on all
311   `NonZero` integer types.][84082]
312 - [`{f32, f64}::from_str` now parse and print special values
313   (`NaN`, `-0`) according to IEEE 754.][78618]
314 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
315 - [Add the `BITS` associated constant to all numeric types.][82565]
316
317 Stabilised APIs
318 ---------------
319 - [`AtomicBool::fetch_update`]
320 - [`AtomicPtr::fetch_update`]
321 - [`BTreeMap::retain`]
322 - [`BTreeSet::retain`]
323 - [`BufReader::seek_relative`]
324 - [`DebugStruct::non_exhaustive`]
325 - [`Duration::MAX`]
326 - [`Duration::ZERO`]
327 - [`Duration::is_zero`]
328 - [`Duration::saturating_add`]
329 - [`Duration::saturating_mul`]
330 - [`Duration::saturating_sub`]
331 - [`ErrorKind::Unsupported`]
332 - [`Option::insert`]
333 - [`Ordering::is_eq`]
334 - [`Ordering::is_ge`]
335 - [`Ordering::is_gt`]
336 - [`Ordering::is_le`]
337 - [`Ordering::is_lt`]
338 - [`Ordering::is_ne`]
339 - [`OsStr::is_ascii`]
340 - [`OsStr::make_ascii_lowercase`]
341 - [`OsStr::make_ascii_uppercase`]
342 - [`OsStr::to_ascii_lowercase`]
343 - [`OsStr::to_ascii_uppercase`]
344 - [`Peekable::peek_mut`]
345 - [`Rc::decrement_strong_count`]
346 - [`Rc::increment_strong_count`]
347 - [`Vec::extend_from_within`]
348 - [`array::from_mut`]
349 - [`array::from_ref`]
350 - [`cmp::max_by_key`]
351 - [`cmp::max_by`]
352 - [`cmp::min_by_key`]
353 - [`cmp::min_by`]
354 - [`f32::is_subnormal`]
355 - [`f64::is_subnormal`]
356
357 Cargo
358 -----------------------
359 - [Cargo now supports git repositories where the default `HEAD` branch is not
360   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
361   which can handle default branches correctly.
362 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
363 - [The `authors` field is no longer included in `Cargo.toml` for new
364   projects.][cargo/9282]
365
366 Rustdoc
367 -----------------------
368 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
369   without hyperlinks.][81764]
370
371 Compatibility Notes
372 -------------------
373 - [Implement token-based handling of attributes during expansion][82608]
374 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
375   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
376   to confusion and potential security vulnerabilities and [is no
377   longer recommended][ietf6943].
378 - [The added `BITS` constant may conflict with external definitions.][85667]
379   In particular, this was known to be a problem in the `lexical-core` crate,
380   but they have published fixes for semantic versions 0.4 through 0.7. To
381   update this dependency alone, use `cargo update -p lexical-core`.
382 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
383
384 Internal Only
385 -------------
386 These changes provide no direct user facing benefits, but represent significant
387 improvements to the internals and overall performance of rustc and
388 related tools.
389
390 - [Rework the `std::sys::windows::alloc` implementation.][83065]
391 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
392 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
393 - [Rework rustdoc const type][82873]
394
395 [85667]: https://github.com/rust-lang/rust/pull/85667
396 [83386]: https://github.com/rust-lang/rust/pull/83386
397 [82771]: https://github.com/rust-lang/rust/pull/82771
398 [84147]: https://github.com/rust-lang/rust/pull/84147
399 [84082]: https://github.com/rust-lang/rust/pull/84082
400 [83799]: https://github.com/rust-lang/rust/pull/83799
401 [83681]: https://github.com/rust-lang/rust/pull/83681
402 [83652]: https://github.com/rust-lang/rust/pull/83652
403 [83387]: https://github.com/rust-lang/rust/pull/83387
404 [82873]: https://github.com/rust-lang/rust/pull/82873
405 [82864]: https://github.com/rust-lang/rust/pull/82864
406 [82608]: https://github.com/rust-lang/rust/pull/82608
407 [82565]: https://github.com/rust-lang/rust/pull/82565
408 [80525]: https://github.com/rust-lang/rust/pull/80525
409 [79278]: https://github.com/rust-lang/rust/pull/79278
410 [78618]: https://github.com/rust-lang/rust/pull/78618
411 [77704]: https://github.com/rust-lang/rust/pull/77704
412 [83941]: https://github.com/rust-lang/rust/pull/83941
413 [83065]: https://github.com/rust-lang/rust/pull/83065
414 [81764]: https://github.com/rust-lang/rust/pull/81764
415 [81469]: https://github.com/rust-lang/rust/pull/81469
416 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
417 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
418 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
419 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
420 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
421 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
422 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
423 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
424 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
425 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
426 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
427 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
428 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
429 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
430 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
431 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
432 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
433 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
434 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
435 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
436 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
437 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
438 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
439 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
440 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
441 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
442 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
443 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
444 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
445 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
446 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
447 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
448 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
449 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
450 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
451 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
452 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
453 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
454 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
455 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
456 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
457 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
458
459
460 Version 1.52.1 (2021-05-10)
461 ============================
462
463 This release disables incremental compilation, unless the user has explicitly
464 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
465
466 This is due to the widespread, and frequently occuring, breakage encountered by
467 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
468 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
469 newly added incremental verification are still present in past stable versions,
470 and are not yet fixed on any channel. These bugs can lead to miscompilation of
471 Rust binaries.
472
473 These problems only affect incremental builds, so release builds with Cargo
474 should not be affected unless the user has explicitly opted into incremental.
475 Debug and check builds are affected.
476
477 See [84970] for more details.
478
479 [84970]: https://github.com/rust-lang/rust/issues/84970
480
481 Version 1.52.0 (2021-05-06)
482 ============================
483
484 Language
485 --------
486 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
487   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
488   is allowed by default, and may become a warning or hard error in a
489   future edition.
490 - [You can now cast mutable references to arrays to a pointer of the same type as
491   the element.][81479]
492
493 Compiler
494 --------
495 - [Upgraded the default LLVM to LLVM 12.][81451]
496
497 Added tier 3\* support for the following targets.
498
499 - [`s390x-unknown-linux-musl`][82166]
500 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
501 - [`powerpc-unknown-openbsd`][82733]
502
503 \* Refer to Rust's [platform support page][platform-support-doc] for more
504 information on Rust's tiered platform support.
505
506 Libraries
507 ---------
508 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
509 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
510 - [`Arc<impl Error>` now implements `error::Error`.][80553]
511 - [All integer division and remainder operations are now `const`.][80962]
512
513 Stabilised APIs
514 -------------
515 - [`Arguments::as_str`]
516 - [`char::MAX`]
517 - [`char::REPLACEMENT_CHARACTER`]
518 - [`char::UNICODE_VERSION`]
519 - [`char::decode_utf16`]
520 - [`char::from_digit`]
521 - [`char::from_u32_unchecked`]
522 - [`char::from_u32`]
523 - [`slice::partition_point`]
524 - [`str::rsplit_once`]
525 - [`str::split_once`]
526
527 The following previously stable APIs are now `const`.
528
529 - [`char::len_utf8`]
530 - [`char::len_utf16`]
531 - [`char::to_ascii_uppercase`]
532 - [`char::to_ascii_lowercase`]
533 - [`char::eq_ignore_ascii_case`]
534 - [`u8::to_ascii_uppercase`]
535 - [`u8::to_ascii_lowercase`]
536 - [`u8::eq_ignore_ascii_case`]
537
538 Rustdoc
539 -------
540 - [Rustdoc lints are now treated as a tool lint, meaning that
541   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
542   Using the old style is still allowed, and will become a warning in
543   a future release.
544 - [Rustdoc now supports argument files.][82261]
545 - [Rustdoc now generates smart punctuation for documentation.][79423]
546 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
547   ```markdown
548   - [x] Complete
549   - [ ] Todo
550   ```
551
552 Misc
553 ----
554 - [You can now pass multiple filters to tests.][81356] E.g.
555   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
556 - [Rustup now distributes PDB symbols for the `std` library on Windows,
557   allowing you to see `std` symbols when debugging.][82218]
558
559 Internal Only
560 -------------
561 These changes provide no direct user facing benefits, but represent significant
562 improvements to the internals and overall performance of rustc and
563 related tools.
564
565 - [Check the result cache before the DepGraph when ensuring queries][81855]
566 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
567 - [Only store a LocalDefId in some HIR nodes][81611]
568 - [Store HIR attributes in a side table][79519]
569
570 Compatibility Notes
571 -------------------
572 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
573 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
574 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
575 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
576   languages in code blocks.][78429]
577 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
578 - [Changes in how proc macros handle whitespace may lead to panics when used
579   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
580 - [Turn `#[derive]` into a regular macro attribute][79078]
581
582 [84136]: https://github.com/rust-lang/rust/issues/84136
583 [80763]: https://github.com/rust-lang/rust/pull/80763
584 [82166]: https://github.com/rust-lang/rust/pull/82166
585 [82121]: https://github.com/rust-lang/rust/pull/82121
586 [81879]: https://github.com/rust-lang/rust/pull/81879
587 [82261]: https://github.com/rust-lang/rust/pull/82261
588 [82218]: https://github.com/rust-lang/rust/pull/82218
589 [82216]: https://github.com/rust-lang/rust/pull/82216
590 [82202]: https://github.com/rust-lang/rust/pull/82202
591 [81855]: https://github.com/rust-lang/rust/pull/81855
592 [81766]: https://github.com/rust-lang/rust/pull/81766
593 [81744]: https://github.com/rust-lang/rust/pull/81744
594 [81611]: https://github.com/rust-lang/rust/pull/81611
595 [81479]: https://github.com/rust-lang/rust/pull/81479
596 [81451]: https://github.com/rust-lang/rust/pull/81451
597 [81356]: https://github.com/rust-lang/rust/pull/81356
598 [80962]: https://github.com/rust-lang/rust/pull/80962
599 [80553]: https://github.com/rust-lang/rust/pull/80553
600 [80527]: https://github.com/rust-lang/rust/pull/80527
601 [79519]: https://github.com/rust-lang/rust/pull/79519
602 [79423]: https://github.com/rust-lang/rust/pull/79423
603 [79208]: https://github.com/rust-lang/rust/pull/79208
604 [78429]: https://github.com/rust-lang/rust/pull/78429
605 [82733]: https://github.com/rust-lang/rust/pull/82733
606 [82594]: https://github.com/rust-lang/rust/pull/82594
607 [79078]: https://github.com/rust-lang/rust/pull/79078
608 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
609 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
610 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
611 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
612 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
613 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
614 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
615 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
616 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
617 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
618 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
619 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
620 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
621 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
622 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
623 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
624 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
625 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
626 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
627 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
628 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
629 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
630
631 Version 1.51.0 (2021-03-25)
632 ============================
633
634 Language
635 --------
636 - [You can now parameterize items such as functions, traits, and `struct`s by constant
637   values in addition to by types and lifetimes.][79135] Also known as "const generics"
638   E.g. you can now write the following. Note: Only values of primitive integers,
639   `bool`, or `char` types are currently permitted.
640   ```rust
641   struct GenericArray<T, const LENGTH: usize> {
642       inner: [T; LENGTH]
643   }
644
645   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
646       const fn last(&self) -> Option<&T> {
647           if LENGTH == 0 {
648               None
649           } else {
650               Some(&self.inner[LENGTH - 1])
651           }
652       }
653   }
654   ```
655
656
657 Compiler
658 --------
659
660 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
661   This option controls whether debug information is split across multiple files
662   or packed into a single file. **Note** This option is unstable on other platforms.
663 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
664   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
665 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
666 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
667
668 \* Refer to Rust's [platform support page][platform-support-doc] for more
669 information on Rust's tiered platform support.
670
671 Libraries
672 ---------
673
674 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
675 - [`str` now implements `AsMut<str>`.][80279]
676 - [`u64` and `u128` now implement `From<char>`.][79502]
677 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
678 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
679 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
680 - [`io::Empty` now implements `io::Seek`.][78044]
681 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
682   `T: ?Sized` types.][80764]
683 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
684
685
686 Stabilized APIs
687 ---------------
688
689 - [`Arc::decrement_strong_count`]
690 - [`Arc::increment_strong_count`]
691 - [`Once::call_once_force`]
692 - [`Peekable::next_if_eq`]
693 - [`Peekable::next_if`]
694 - [`Seek::stream_position`]
695 - [`array::IntoIter`]
696 - [`panic::panic_any`]
697 - [`ptr::addr_of!`]
698 - [`ptr::addr_of_mut!`]
699 - [`slice::fill_with`]
700 - [`slice::split_inclusive_mut`]
701 - [`slice::split_inclusive`]
702 - [`slice::strip_prefix`]
703 - [`slice::strip_suffix`]
704 - [`str::split_inclusive`]
705 - [`sync::OnceState`]
706 - [`task::Wake`]
707 - [`VecDeque::range`]
708 - [`VecDeque::range_mut`]
709
710 Cargo
711 -----
712 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
713   codegen option.][cargo/9112]
714 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
715   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
716   to avoid unifying features of dependencies where that unification could be unwanted.
717   Such as using the same dependency with a `std` feature in a build scripts and
718   proc-macros, while using the `no-std` feature in the final binary. See the
719   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
720
721 Rustdoc
722 -------
723
724 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
725 - [You can now provide a `--default-theme` flag which sets the default theme to use for
726   documentation.][79642]
727
728 Various improvements to intra-doc links:
729
730 - [You can link to non-path primitives such as `slice`.][80181]
731 - [You can link to associated items.][74489]
732 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
733
734 Misc
735 ----
736 - [You can now pass `--include-ignored` to tests (e.g. with
737   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
738
739 Compatibility Notes
740 -------------------
741
742 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
743 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
744   could fail.][80579]
745 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
746   for the distributed artifacts.][81521]
747     - `armv5te-unknown-linux-gnueabi`
748     - `sparc64-unknown-linux-gnu`
749     - `thumbv7neon-unknown-linux-gnueabihf`
750     - `armv7-unknown-linux-gnueabi`
751     - `x86_64-unknown-linux-gnux32`
752 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
753
754 Internal Only
755 -------------
756
757 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
758
759 [79135]: https://github.com/rust-lang/rust/pull/79135
760 [74489]: https://github.com/rust-lang/rust/pull/74489
761 [76934]: https://github.com/rust-lang/rust/pull/76934
762 [79570]: https://github.com/rust-lang/rust/pull/79570
763 [80181]: https://github.com/rust-lang/rust/pull/80181
764 [79642]: https://github.com/rust-lang/rust/pull/79642
765 [80945]: https://github.com/rust-lang/rust/pull/80945
766 [80279]: https://github.com/rust-lang/rust/pull/80279
767 [80053]: https://github.com/rust-lang/rust/pull/80053
768 [79502]: https://github.com/rust-lang/rust/pull/79502
769 [75180]: https://github.com/rust-lang/rust/pull/75180
770 [79135]: https://github.com/rust-lang/rust/pull/79135
771 [81521]: https://github.com/rust-lang/rust/pull/81521
772 [80968]: https://github.com/rust-lang/rust/pull/80968
773 [80959]: https://github.com/rust-lang/rust/pull/80959
774 [80718]: https://github.com/rust-lang/rust/pull/80718
775 [80653]: https://github.com/rust-lang/rust/pull/80653
776 [80579]: https://github.com/rust-lang/rust/pull/80579
777 [79998]: https://github.com/rust-lang/rust/pull/79998
778 [78044]: https://github.com/rust-lang/rust/pull/78044
779 [81455]: https://github.com/rust-lang/rust/pull/81455
780 [80764]: https://github.com/rust-lang/rust/pull/80764
781 [80749]: https://github.com/rust-lang/rust/pull/80749
782 [80662]: https://github.com/rust-lang/rust/pull/80662
783 [79134]: https://github.com/rust-lang/rust/pull/79134
784 [80966]: https://github.com/rust-lang/rust/pull/80966
785 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
786 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
787 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
788 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
789 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
790 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
791 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
792 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
793 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
794 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
795 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
796 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
797 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
798 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
799 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
800 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
801 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
802 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
803 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
804 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
805 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
806 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
807 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
808
809 Version 1.50.0 (2021-02-11)
810 ============================
811
812 Language
813 -----------------------
814 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
815   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
816 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
817
818 Compiler
819 -----------------------
820 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
821 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
822 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
823 - [Dropped support for all cloudabi targets.][78439]
824
825 \* Refer to Rust's [platform support page][platform-support-doc] for more
826 information on Rust's tiered platform support.
827
828 Libraries
829 -----------------------
830
831 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
832 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
833 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
834   This value cannot be a valid file descriptor, and now means `Option<File>` takes
835   up the same amount of space as `File`.
836
837 Stabilized APIs
838 ---------------
839
840 - [`bool::then`]
841 - [`btree_map::Entry::or_insert_with_key`]
842 - [`f32::clamp`]
843 - [`f64::clamp`]
844 - [`hash_map::Entry::or_insert_with_key`]
845 - [`Ord::clamp`]
846 - [`RefCell::take`]
847 - [`slice::fill`]
848 - [`UnsafeCell::get_mut`]
849
850 The following previously stable methods are now `const`.
851
852 - [`IpAddr::is_ipv4`]
853 - [`IpAddr::is_ipv6`]
854 - [`IpAddr::is_unspecified`]
855 - [`IpAddr::is_loopback`]
856 - [`IpAddr::is_multicast`]
857 - [`Ipv4Addr::octets`]
858 - [`Ipv4Addr::is_loopback`]
859 - [`Ipv4Addr::is_private`]
860 - [`Ipv4Addr::is_link_local`]
861 - [`Ipv4Addr::is_multicast`]
862 - [`Ipv4Addr::is_broadcast`]
863 - [`Ipv4Addr::is_documentation`]
864 - [`Ipv4Addr::to_ipv6_compatible`]
865 - [`Ipv4Addr::to_ipv6_mapped`]
866 - [`Ipv6Addr::segments`]
867 - [`Ipv6Addr::is_unspecified`]
868 - [`Ipv6Addr::is_loopback`]
869 - [`Ipv6Addr::is_multicast`]
870 - [`Ipv6Addr::to_ipv4`]
871 - [`Layout::size`]
872 - [`Layout::align`]
873 - [`Layout::from_size_align`]
874 - `pow` for all integer types.
875 - `checked_pow` for all integer types.
876 - `saturating_pow` for all integer types.
877 - `wrapping_pow` for all integer types.
878 - `next_power_of_two` for all unsigned integer types.
879 - `checked_next_power_of_two` for all unsigned integer types.
880
881 Cargo
882 -----------------------
883
884 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
885   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
886 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
887   contents of that directory for changes.][cargo/8973]
888 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
889
890 Misc
891 ----
892
893 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
894 - [Running tests will now print the total time taken to execute.][75752]
895
896 Compatibility Notes
897 -------------------
898
899 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
900   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
901 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
902   unhygenic `macro_rules!` macros.][79472]
903 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
904   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
905 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
906 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
907   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
908 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
909
910 [74989]: https://github.com/rust-lang/rust/pull/74989
911 [79261]: https://github.com/rust-lang/rust/pull/79261
912 [79896]: https://github.com/rust-lang/rust/pull/79896
913 [79484]: https://github.com/rust-lang/rust/pull/79484
914 [79472]: https://github.com/rust-lang/rust/pull/79472
915 [79270]: https://github.com/rust-lang/rust/pull/79270
916 [79003]: https://github.com/rust-lang/rust/pull/79003
917 [78864]: https://github.com/rust-lang/rust/pull/78864
918 [78636]: https://github.com/rust-lang/rust/pull/78636
919 [78439]: https://github.com/rust-lang/rust/pull/78439
920 [78343]: https://github.com/rust-lang/rust/pull/78343
921 [78296]: https://github.com/rust-lang/rust/pull/78296
922 [78068]: https://github.com/rust-lang/rust/pull/78068
923 [75752]: https://github.com/rust-lang/rust/pull/75752
924 [74699]: https://github.com/rust-lang/rust/pull/74699
925 [78142]: https://github.com/rust-lang/rust/pull/78142
926 [77484]: https://github.com/rust-lang/rust/pull/77484
927 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
928 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
929 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
930 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
931 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
932 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
933 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
934 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
935 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
936 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
937 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
938 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
939 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
940 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
941 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
942 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
943 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
944 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
945 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
946 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
947 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
948 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
949 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
950 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
951 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
952 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
953 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
954 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
955 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
956 [`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
957 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
958 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
959 [`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
960 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
961
962
963 Version 1.49.0 (2020-12-31)
964 ============================
965
966 Language
967 -----------------------
968
969 - [Unions can now implement `Drop`, and you can now have a field in a union
970   with `ManuallyDrop<T>`.][77547]
971 - [You can now cast uninhabited enums to integers.][76199]
972 - [You can now bind by reference and by move in patterns.][76119] This
973   allows you to selectively borrow individual components of a type. E.g.
974   ```rust
975   #[derive(Debug)]
976   struct Person {
977       name: String,
978       age: u8,
979   }
980
981   let person = Person {
982       name: String::from("Alice"),
983       age: 20,
984   };
985
986   // `name` is moved out of person, but `age` is referenced.
987   let Person { name, ref age } = person;
988   println!("{} {}", name, age);
989   ```
990
991 Compiler
992 -----------------------
993
994 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
995 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
996 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
997 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
998 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
999 - [Output from threads spawned in tests is now captured.][78227]
1000 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
1001
1002 \* Refer to Rust's [platform support page][platform-support-doc] for more
1003 information on Rust's tiered platform support.
1004
1005 Libraries
1006 -----------------------
1007
1008 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
1009 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
1010
1011 Stabilized APIs
1012 ---------------
1013
1014 - [`slice::select_nth_unstable`]
1015 - [`slice::select_nth_unstable_by`]
1016 - [`slice::select_nth_unstable_by_key`]
1017
1018 The following previously stable methods are now `const`.
1019
1020 - [`Poll::is_ready`]
1021 - [`Poll::is_pending`]
1022
1023 Cargo
1024 -----------------------
1025 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
1026 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
1027 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
1028   variable will be set if the crate being built is one the user selected to build, either
1029   with `-p` or through defaults.
1030 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
1031
1032
1033 Compatibility Notes
1034 -------------------
1035
1036 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
1037 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
1038 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
1039   Previously such invalid or unused attributes could be ignored.
1040 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
1041   read [this post about the changes][rustdoc-ws-post] for more details.
1042 - [Trait bounds are no longer inferred for associated types.][79904]
1043
1044 Internal Only
1045 -------------
1046 These changes provide no direct user facing benefits, but represent significant
1047 improvements to the internals and overall performance of rustc and
1048 related tools.
1049
1050 - [rustc's internal crates are now compiled using the `initial-exec` Thread
1051   Local Storage model.][78201]
1052 - [Calculate visibilities once in resolve.][78077]
1053 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
1054 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
1055
1056
1057 [75991]: https://github.com/rust-lang/rust/pull/75991
1058 [78951]: https://github.com/rust-lang/rust/pull/78951
1059 [78848]: https://github.com/rust-lang/rust/pull/78848
1060 [78746]: https://github.com/rust-lang/rust/pull/78746
1061 [78376]: https://github.com/rust-lang/rust/pull/78376
1062 [78228]: https://github.com/rust-lang/rust/pull/78228
1063 [78227]: https://github.com/rust-lang/rust/pull/78227
1064 [78201]: https://github.com/rust-lang/rust/pull/78201
1065 [78109]: https://github.com/rust-lang/rust/pull/78109
1066 [78077]: https://github.com/rust-lang/rust/pull/78077
1067 [77997]: https://github.com/rust-lang/rust/pull/77997
1068 [77703]: https://github.com/rust-lang/rust/pull/77703
1069 [77547]: https://github.com/rust-lang/rust/pull/77547
1070 [77015]: https://github.com/rust-lang/rust/pull/77015
1071 [76199]: https://github.com/rust-lang/rust/pull/76199
1072 [76119]: https://github.com/rust-lang/rust/pull/76119
1073 [75914]: https://github.com/rust-lang/rust/pull/75914
1074 [79004]: https://github.com/rust-lang/rust/pull/79004
1075 [78676]: https://github.com/rust-lang/rust/pull/78676
1076 [79904]: https://github.com/rust-lang/rust/issues/79904
1077 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
1078 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
1079 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
1080 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
1081 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
1082 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
1083 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
1084 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
1085 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
1086 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
1087 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
1088
1089 Version 1.48.0 (2020-11-19)
1090 ==========================
1091
1092 Language
1093 --------
1094
1095 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
1096   is still rejected *semantically*, but can now be parsed by procedural macros.
1097
1098 Compiler
1099 --------
1100 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
1101   `rustc` whether to link its own C runtime and libraries or to rely on a external
1102   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
1103 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
1104   Note: If you're using cargo you must explicitly pass the `--target` flag.
1105 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
1106
1107 \* Refer to Rust's [platform support page][platform-support-doc] for more
1108 information on Rust's tiered platform support.
1109
1110 Libraries
1111 ---------
1112 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
1113   and `&Stderr`.][76275]
1114 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
1115 - [The `matches!` macro now supports having a trailing comma.][74880]
1116 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
1117 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
1118
1119 Stabilized APIs
1120 ---------------
1121 - [`slice::as_ptr_range`]
1122 - [`slice::as_mut_ptr_range`]
1123 - [`VecDeque::make_contiguous`]
1124 - [`future::pending`]
1125 - [`future::ready`]
1126
1127 The following previously stable methods are now `const fn`'s:
1128
1129 - [`Option::is_some`]
1130 - [`Option::is_none`]
1131 - [`Option::as_ref`]
1132 - [`Result::is_ok`]
1133 - [`Result::is_err`]
1134 - [`Result::as_ref`]
1135 - [`Ordering::reverse`]
1136 - [`Ordering::then`]
1137
1138 Cargo
1139 -----
1140
1141 Rustdoc
1142 -------
1143 - [You can now link to items in `rustdoc` using the intra-doc link
1144   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1145   a link to `std::future`'s documentation. See ["Linking to items by
1146   name"][intradoc-links] for more information.
1147 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1148   when searching through `rustdoc`'s UI.][75740]
1149
1150 Compatibility Notes
1151 -------------------
1152 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1153   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1154   promoted to `'static` lifetime any more inside `const fn`s.
1155 - [Associated type bindings on trait objects are now verified to meet the bounds
1156   declared on the trait when checking that they implement the trait.][27675]
1157 - [When trait bounds on associated types or opaque types are ambiguous, the
1158   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1159 - [Fixed recursive nonterminals not being expanded in macros during
1160   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1161   correctly handling recursive nonterminal tokens.
1162 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1163 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1164   in places where they have no effect.][73461]
1165 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1166   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1167 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1168   disallow zero-initialization.][71274]
1169 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1170 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1171   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1172   see the [`catch_unwind`] documentation for further information.
1173
1174
1175
1176 Internal Only
1177 -------------
1178 These changes provide no direct user facing benefits, but represent significant
1179 improvements to the internals and overall performance of rustc and
1180 related tools.
1181
1182 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1183   You can continue building with `make` by setting `ninja=false` in
1184   your `config.toml`.
1185 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1186 - [Made `ensure_sufficient_stack()` non-generic][76680]
1187
1188 [78143]: https://github.com/rust-lang/rust/issues/78143
1189 [76680]: https://github.com/rust-lang/rust/pull/76680/
1190 [76030]: https://github.com/rust-lang/rust/pull/76030/
1191 [70212]: https://github.com/rust-lang/rust/pull/70212/
1192 [27675]: https://github.com/rust-lang/rust/issues/27675/
1193 [54121]: https://github.com/rust-lang/rust/issues/54121/
1194 [71274]: https://github.com/rust-lang/rust/pull/71274/
1195 [77386]: https://github.com/rust-lang/rust/pull/77386/
1196 [77153]: https://github.com/rust-lang/rust/pull/77153/
1197 [77055]: https://github.com/rust-lang/rust/pull/77055/
1198 [76275]: https://github.com/rust-lang/rust/pull/76275/
1199 [76310]: https://github.com/rust-lang/rust/pull/76310/
1200 [76420]: https://github.com/rust-lang/rust/pull/76420/
1201 [76158]: https://github.com/rust-lang/rust/pull/76158/
1202 [75857]: https://github.com/rust-lang/rust/pull/75857/
1203 [75585]: https://github.com/rust-lang/rust/pull/75585/
1204 [75740]: https://github.com/rust-lang/rust/pull/75740/
1205 [75502]: https://github.com/rust-lang/rust/pull/75502/
1206 [74880]: https://github.com/rust-lang/rust/pull/74880/
1207 [74922]: https://github.com/rust-lang/rust/pull/74922/
1208 [74430]: https://github.com/rust-lang/rust/pull/74430/
1209 [74194]: https://github.com/rust-lang/rust/pull/74194/
1210 [73461]: https://github.com/rust-lang/rust/pull/73461/
1211 [73166]: https://github.com/rust-lang/rust/pull/73166/
1212 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1213 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1214 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1215 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1216 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1217 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1218 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1219 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1220 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1221 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1222 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1223 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1224 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1225 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1226 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1227
1228
1229 Version 1.47.0 (2020-10-08)
1230 ==========================
1231
1232 Language
1233 --------
1234 - [Closures will now warn when not used.][74869]
1235
1236 Compiler
1237 --------
1238 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1239   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1240   platforms.
1241 - [Upgraded to LLVM 11.][73526]
1242 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1243 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1244 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1245
1246 \* Refer to Rust's [platform support page][platform-support-doc] for more
1247 information on Rust's tiered platform support.
1248
1249 Libraries
1250 ---------
1251 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1252 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1253   those of length less than 33.][74060]
1254 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1255 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1256   `PartialEq`, and `PartialOrd`.][73583]
1257
1258 Stabilized APIs
1259 ---------------
1260 - [`Ident::new_raw`]
1261 - [`Range::is_empty`]
1262 - [`RangeInclusive::is_empty`]
1263 - [`Result::as_deref`]
1264 - [`Result::as_deref_mut`]
1265 - [`Vec::leak`]
1266 - [`pointer::offset_from`]
1267 - [`f32::TAU`]
1268 - [`f64::TAU`]
1269
1270 The following previously stable APIs have now been made const.
1271
1272 - [The `new` method for all `NonZero` integers.][73858]
1273 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1274   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1275   methods for all integers.][73858]
1276 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1277   signed integers.][73858]
1278 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1279   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1280   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1281   `is_ascii_control` methods for `char` and `u8`.][73858]
1282
1283 Cargo
1284 -----
1285 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1286   You can override this by setting the following in your `Cargo.toml`.
1287   ```toml
1288   [profile.release.build-override]
1289   opt-level = 3
1290   ```
1291 - [`cargo-help` will now display man pages for commands rather just the
1292   `--help` text.][cargo/8456]
1293 - [`cargo-metadata` now emits a `test` field indicating if a target has
1294   tests enabled.][cargo/8478]
1295 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1296 - [`cargo-publish` will now use an alternative registry by default if it's the
1297   only registry specified in `package.publish`.][cargo/8571]
1298
1299 Misc
1300 ----
1301 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1302   type based search.][75366]
1303 - [Added the Ayu theme to rustdoc.][71237]
1304
1305 Compatibility Notes
1306 -------------------
1307 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1308 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1309 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1310   help to preserve more span information.][73084] These changes may cause
1311   compiliation errors if your macro was unhygenic or didn't correctly handle
1312   `Delimiter::None`.
1313 - [Moved support for the CloudABI target to tier 3.][75568]
1314 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1315 - [Added the `rustc-docs` component.][75560] This allows you to install
1316   and read the documentation for the compiler internal APIs. (Currently only
1317   available for `x86_64-unknown-linux-gnu`.)
1318
1319 Internal Only
1320 --------
1321
1322 - [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.
1323
1324 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1325 [75048]: https://github.com/rust-lang/rust/pull/75048/
1326 [74163]: https://github.com/rust-lang/rust/pull/74163/
1327 [71237]: https://github.com/rust-lang/rust/pull/71237/
1328 [74869]: https://github.com/rust-lang/rust/pull/74869/
1329 [73858]: https://github.com/rust-lang/rust/pull/73858/
1330 [75716]: https://github.com/rust-lang/rust/pull/75716/
1331 [75908]: https://github.com/rust-lang/rust/pull/75908/
1332 [75516]: https://github.com/rust-lang/rust/pull/75516/
1333 [75560]: https://github.com/rust-lang/rust/pull/75560/
1334 [75568]: https://github.com/rust-lang/rust/pull/75568/
1335 [75366]: https://github.com/rust-lang/rust/pull/75366/
1336 [75204]: https://github.com/rust-lang/rust/pull/75204/
1337 [74650]: https://github.com/rust-lang/rust/pull/74650/
1338 [74419]: https://github.com/rust-lang/rust/pull/74419/
1339 [73964]: https://github.com/rust-lang/rust/pull/73964/
1340 [74021]: https://github.com/rust-lang/rust/pull/74021/
1341 [74060]: https://github.com/rust-lang/rust/pull/74060/
1342 [73893]: https://github.com/rust-lang/rust/pull/73893/
1343 [73526]: https://github.com/rust-lang/rust/pull/73526/
1344 [73583]: https://github.com/rust-lang/rust/pull/73583/
1345 [73084]: https://github.com/rust-lang/rust/pull/73084/
1346 [73197]: https://github.com/rust-lang/rust/pull/73197/
1347 [72488]: https://github.com/rust-lang/rust/pull/72488/
1348 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1349 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1350 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1351 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1352 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1353 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1354 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1355 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1356 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1357 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1358 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1359 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1360 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1361 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1362 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1363
1364
1365 Version 1.46.0 (2020-08-27)
1366 ==========================
1367
1368 Language
1369 --------
1370 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1371 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1372   const functions.][73862]
1373 - [The `#[track_caller]` attribute can now be added to functions to use the
1374   function's caller's location information for panic messages.][72445]
1375 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1376   `x.0.0` over `(x.0).0`.
1377 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1378   You currently can't use `mem::transmute` in constant functions.
1379
1380 Compiler
1381 --------
1382 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1383 - [Enabled static "Position Independent Executables" by default
1384   for `x86_64-unknown-linux-musl`.][70740]
1385
1386 Libraries
1387 ---------
1388 - [`mem::forget` is now a `const fn`.][73887]
1389 - [`String` now implements `From<char>`.][73466]
1390 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1391   integer types.][73032]
1392 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1393 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1394   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1395 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1396 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1397 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1398
1399 Stabilized APIs
1400 ---------------
1401 - [`Option::zip`]
1402 - [`vec::Drain::as_slice`]
1403
1404 Cargo
1405 -----
1406 Added a number of new environment variables that are now available when
1407 compiling your crate.
1408
1409 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1410   the specific binary being compiled and the name of the crate.
1411 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1412 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1413
1414 Compatibility Notes
1415 -------------------
1416 - [The target configuration option `abi_blacklist` has been renamed
1417   to `unsupported_abis`.][74150] The old name will still continue to work.
1418 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1419   This was previously accepted but will become a hard error in a future release.
1420 - [Rustc will fail to compile if you have a struct with
1421   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1422   allowed on `enum`s.
1423 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1424   ensure that spans have the correct information, and may cause breakage if you
1425   were relying on receiving spans with dummy information.
1426 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1427   a legacy installer that was replaced by a MSI installer a few years ago but
1428   was still being built.
1429 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1430 - [Rustc will no longer accept overlapping trait implementations that only
1431   differ in how the lifetime was bound.][72493]
1432 - [Rustc now correctly relates the lifetime of an existential associated
1433   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1434   you to pass a shorter lifetime than expected.
1435 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1436   The library will need to be installed for `rustc` to work, even though we
1437   expect it to be already available on most systems.
1438 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1439   under QEMU.][74820]
1440 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1441   exact output returned by rustc's pretty printing is an unstable
1442   implementation detail: we recommend any macro relying on it to switch to a
1443   more robust parsing system.
1444
1445 [75453]: https://github.com/rust-lang/rust/issues/75453/
1446 [74820]: https://github.com/rust-lang/rust/issues/74820/
1447 [74420]: https://github.com/rust-lang/rust/issues/74420/
1448 [74109]: https://github.com/rust-lang/rust/pull/74109/
1449 [74150]: https://github.com/rust-lang/rust/pull/74150/
1450 [73862]: https://github.com/rust-lang/rust/pull/73862/
1451 [73887]: https://github.com/rust-lang/rust/pull/73887/
1452 [73466]: https://github.com/rust-lang/rust/pull/73466/
1453 [73516]: https://github.com/rust-lang/rust/pull/73516/
1454 [73293]: https://github.com/rust-lang/rust/pull/73293/
1455 [73007]: https://github.com/rust-lang/rust/pull/73007/
1456 [73032]: https://github.com/rust-lang/rust/pull/73032/
1457 [72920]: https://github.com/rust-lang/rust/pull/72920/
1458 [72569]: https://github.com/rust-lang/rust/pull/72569/
1459 [72583]: https://github.com/rust-lang/rust/pull/72583/
1460 [72584]: https://github.com/rust-lang/rust/pull/72584/
1461 [72717]: https://github.com/rust-lang/rust/pull/72717/
1462 [72437]: https://github.com/rust-lang/rust/pull/72437/
1463 [72445]: https://github.com/rust-lang/rust/pull/72445/
1464 [72486]: https://github.com/rust-lang/rust/pull/72486/
1465 [72493]: https://github.com/rust-lang/rust/pull/72493/
1466 [72331]: https://github.com/rust-lang/rust/pull/72331/
1467 [71896]: https://github.com/rust-lang/rust/pull/71896/
1468 [71660]: https://github.com/rust-lang/rust/pull/71660/
1469 [71322]: https://github.com/rust-lang/rust/pull/71322/
1470 [70740]: https://github.com/rust-lang/rust/pull/70740/
1471 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1472 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1473 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1474 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1475 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1476
1477
1478 Version 1.45.2 (2020-08-03)
1479 ==========================
1480
1481 * [Fix bindings in tuple struct patterns][74954]
1482 * [Fix track_caller integration with trait objects][74784]
1483
1484 [74954]: https://github.com/rust-lang/rust/issues/74954
1485 [74784]: https://github.com/rust-lang/rust/issues/74784
1486
1487
1488 Version 1.45.1 (2020-07-30)
1489 ==========================
1490
1491 * [Fix const propagation with references.][73613]
1492 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1493 * [Avoid spurious implicit region bound.][74509]
1494 * [Install clippy on x.py install][74457]
1495
1496 [73613]: https://github.com/rust-lang/rust/pull/73613
1497 [73078]: https://github.com/rust-lang/rust/issues/73078
1498 [74509]: https://github.com/rust-lang/rust/pull/74509
1499 [74457]: https://github.com/rust-lang/rust/pull/74457
1500
1501
1502 Version 1.45.0 (2020-07-16)
1503 ==========================
1504
1505 Language
1506 --------
1507 - [Out of range float to int conversions using `as` has been defined as a saturating
1508   conversion.][71269] This was previously undefined behaviour, but you can use the
1509    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1510    may be desirable in rare performance sensitive situations.
1511 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1512   using `u64`.][70705]
1513 - [Function like procedural macros can now be used in expression, pattern, and  statement
1514   positions.][68717] This means you can now use a function-like procedural macro
1515   anywhere you can use a declarative (`macro_rules!`) macro.
1516
1517 Compiler
1518 --------
1519 - [You can now override individual target features through the `target-feature`
1520   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1521   equivalent to `-C target-feature=+avx2,+fma`.
1522 - [Added the `force-unwind-tables` flag.][69984] This option allows
1523   rustc to always generate unwind tables regardless of panic strategy.
1524 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1525   to include LLVM bitcode into generated `rlib`s (this is on by default).
1526 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1527 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1528 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1529 - [Upgraded to LLVM 10.][67759]
1530
1531 \* Refer to Rust's [platform support page][platform-support-doc] for more
1532 information on Rust's tiered platform support.
1533
1534
1535 Libraries
1536 ---------
1537 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1538   and `Ord`.][72239]
1539 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1540 - [You can now use `char` with
1541   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1542   a range of codepoints.][72413] E.g.
1543   you can now write the following;
1544   ```rust
1545   for ch in 'a'..='z' {
1546       print!("{}", ch);
1547   }
1548   println!();
1549   // Prints "abcdefghijklmnopqrstuvwxyz"
1550   ```
1551 - [`OsString` now implements `FromStr`.][71662]
1552 - [The `saturating_neg` method has been added to all signed integer primitive
1553   types, and the `saturating_abs` method has been added for all integer
1554   primitive types.][71886]
1555 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1556   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1557   or `Path`.][71447]
1558 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1559 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1560   integer types.][69813]
1561 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1562   integer types.][72324]
1563 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1564
1565 Stabilized APIs
1566 ---------------
1567 - [`Arc::as_ptr`]
1568 - [`BTreeMap::remove_entry`]
1569 - [`Rc::as_ptr`]
1570 - [`rc::Weak::as_ptr`]
1571 - [`rc::Weak::from_raw`]
1572 - [`rc::Weak::into_raw`]
1573 - [`str::strip_prefix`]
1574 - [`str::strip_suffix`]
1575 - [`sync::Weak::as_ptr`]
1576 - [`sync::Weak::from_raw`]
1577 - [`sync::Weak::into_raw`]
1578 - [`char::UNICODE_VERSION`]
1579 - [`Span::resolved_at`]
1580 - [`Span::located_at`]
1581 - [`Span::mixed_site`]
1582 - [`unix::process::CommandExt::arg0`]
1583
1584 Cargo
1585 -----
1586
1587 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1588   time.][cargo/8066]
1589
1590 Misc
1591 ----
1592 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1593   `~~outdated information~~` becomes "~~outdated information~~".
1594 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1595
1596 Compatibility Notes
1597 -------------------
1598 - [Trying to self initialize a static value (that is creating a value using
1599   itself) is unsound and now causes a compile error.][71140]
1600 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1601   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1602 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1603   previously undocumented and not intended for public use. Rustdoc still provides
1604   a non-zero exit code on errors.
1605 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1606   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1607   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1608   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1609   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1610
1611 Internals Only
1612 --------------
1613 - [Make clippy a git subtree instead of a git submodule][70655]
1614 - [Unify the undo log of all snapshot types][69464]
1615
1616 [71848]: https://github.com/rust-lang/rust/issues/71848/
1617 [73420]: https://github.com/rust-lang/rust/issues/73420/
1618 [72324]: https://github.com/rust-lang/rust/pull/72324/
1619 [71843]: https://github.com/rust-lang/rust/pull/71843/
1620 [71886]: https://github.com/rust-lang/rust/pull/71886/
1621 [72234]: https://github.com/rust-lang/rust/pull/72234/
1622 [72239]: https://github.com/rust-lang/rust/pull/72239/
1623 [72397]: https://github.com/rust-lang/rust/pull/72397/
1624 [72413]: https://github.com/rust-lang/rust/pull/72413/
1625 [72014]: https://github.com/rust-lang/rust/pull/72014/
1626 [72062]: https://github.com/rust-lang/rust/pull/72062/
1627 [72094]: https://github.com/rust-lang/rust/pull/72094/
1628 [72133]: https://github.com/rust-lang/rust/pull/72133/
1629 [67759]: https://github.com/rust-lang/rust/pull/67759/
1630 [71900]: https://github.com/rust-lang/rust/pull/71900/
1631 [71928]: https://github.com/rust-lang/rust/pull/71928/
1632 [71662]: https://github.com/rust-lang/rust/pull/71662/
1633 [71716]: https://github.com/rust-lang/rust/pull/71716/
1634 [71447]: https://github.com/rust-lang/rust/pull/71447/
1635 [71269]: https://github.com/rust-lang/rust/pull/71269/
1636 [71095]: https://github.com/rust-lang/rust/pull/71095/
1637 [71140]: https://github.com/rust-lang/rust/pull/71140/
1638 [70655]: https://github.com/rust-lang/rust/pull/70655/
1639 [70705]: https://github.com/rust-lang/rust/pull/70705/
1640 [69984]: https://github.com/rust-lang/rust/pull/69984/
1641 [69813]: https://github.com/rust-lang/rust/pull/69813/
1642 [69464]: https://github.com/rust-lang/rust/pull/69464/
1643 [68717]: https://github.com/rust-lang/rust/pull/68717/
1644 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1645 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1646 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1647 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1648 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1649 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1650 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1651 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1652 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1653 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1654 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1655 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1656 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1657 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1658 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1659 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1660 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1661
1662
1663 Version 1.44.1 (2020-06-18)
1664 ===========================
1665
1666 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1667 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1668 * [Fix crashes when finding backtrace on macOS.][71397]
1669 * [Clippy applies lint levels into different files.][clippy/5356]
1670
1671 [71397]: https://github.com/rust-lang/rust/issues/71397
1672 [73078]: https://github.com/rust-lang/rust/issues/73078
1673 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1674 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1675
1676
1677 Version 1.44.0 (2020-06-04)
1678 ==========================
1679
1680 Language
1681 --------
1682 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1683 - [Added the `unused_braces` lint.][70081]
1684
1685 **Syntax-only changes**
1686
1687 - [Expansion-driven outline module parsing][69838]
1688 ```rust
1689 #[cfg(FALSE)]
1690 mod foo {
1691     mod bar {
1692         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1693     }
1694 }
1695 ```
1696
1697 These are still rejected semantically, so you will likely receive an error but
1698 these changes can be seen and parsed by macros and conditional compilation.
1699
1700 Compiler
1701 --------
1702 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1703   Additionally when in incremental mode rustc defaults to 256 codegen units.
1704 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1705   a panic is thrown.][67502]
1706 - [Added tier 3\* support for the `aarch64-unknown-none` and
1707   `aarch64-unknown-none-softfloat` targets.][68334]
1708 - [Added tier 3 support for `arm64-apple-tvos` and
1709   `x86_64-apple-tvos` targets.][68191]
1710
1711
1712 Libraries
1713 ---------
1714 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1715   `vec![]` to be able to be used in `const` contexts.
1716 - [`convert::Infallible` now implements `Hash`.][70281]
1717 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1718   a `&mut OsStr`.][70048]
1719 - [Unicode 13 is now supported.][69929]
1720 - [`String` now implements `From<&mut str>`.][69661]
1721 - [`IoSlice` now implements `Copy`.][69403]
1722 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1723 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1724 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1725   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1726   integer types.][69373]
1727
1728 Stabilized APIs
1729 ---------------
1730 - [`PathBuf::with_capacity`]
1731 - [`PathBuf::capacity`]
1732 - [`PathBuf::clear`]
1733 - [`PathBuf::reserve`]
1734 - [`PathBuf::reserve_exact`]
1735 - [`PathBuf::shrink_to_fit`]
1736 - [`f32::to_int_unchecked`]
1737 - [`f64::to_int_unchecked`]
1738 - [`Layout::align_to`]
1739 - [`Layout::pad_to_align`]
1740 - [`Layout::array`]
1741 - [`Layout::extend`]
1742
1743 Cargo
1744 -----
1745 - [Added the `cargo tree` command which will print a tree graph of
1746   your dependencies.][cargo/8062] E.g.
1747   ```
1748     mdbook v0.3.2 (/Users/src/rust/mdbook)
1749   ├── ammonia v3.0.0
1750   │   ├── html5ever v0.24.0
1751   │   │   ├── log v0.4.8
1752   │   │   │   └── cfg-if v0.1.9
1753   │   │   ├── mac v0.1.1
1754   │   │   └── markup5ever v0.9.0
1755   │   │       ├── log v0.4.8 (*)
1756   │   │       ├── phf v0.7.24
1757   │   │       │   └── phf_shared v0.7.24
1758   │   │       │       ├── siphasher v0.2.3
1759   │   │       │       └── unicase v1.4.2
1760   │   │       │           [build-dependencies]
1761   │   │       │           └── version_check v0.1.5
1762   ...
1763   ```
1764   You can also display dependencies on multiple versions of the same crate with
1765   `cargo tree -d` (short for `cargo tree --duplicates`).
1766
1767 Misc
1768 ----
1769 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1770   the version in the sidebar.][69494]
1771
1772 Compatibility Notes
1773 -------------------
1774 - [Rustc now correctly generates static libraries on Windows GNU targets with
1775   the `.a` extension, rather than the previous `.lib`.][70937]
1776 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1777 - [The `file_name` property in JSON output of macro errors now points the actual
1778   source file rather than the previous format of `<NAME macros>`.][70969]
1779   **Note:** this may not point to a file that actually exists on the user's system.
1780 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1781 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1782   not allow zero initialization such as `NonZeroU8`.][66059] This was
1783   previously a warning.
1784 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1785   operator has been defined as a saturating operation.][71269] This was previously
1786   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1787   continue using the current behaviour, which may be desirable in rare performance
1788   sensitive situations.
1789
1790 Internal Only
1791 -------------
1792 These changes provide no direct user facing benefits, but represent significant
1793 improvements to the internals and overall performance of rustc and
1794 related tools.
1795
1796 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1797 - [Replace big JS dict with JSON parsing.][71250]
1798
1799 [69373]: https://github.com/rust-lang/rust/pull/69373/
1800 [66059]: https://github.com/rust-lang/rust/pull/66059/
1801 [68191]: https://github.com/rust-lang/rust/pull/68191/
1802 [68899]: https://github.com/rust-lang/rust/pull/68899/
1803 [71147]: https://github.com/rust-lang/rust/pull/71147/
1804 [71250]: https://github.com/rust-lang/rust/pull/71250/
1805 [70937]: https://github.com/rust-lang/rust/pull/70937/
1806 [70969]: https://github.com/rust-lang/rust/pull/70969/
1807 [70632]: https://github.com/rust-lang/rust/pull/70632/
1808 [70281]: https://github.com/rust-lang/rust/pull/70281/
1809 [70345]: https://github.com/rust-lang/rust/pull/70345/
1810 [70048]: https://github.com/rust-lang/rust/pull/70048/
1811 [70081]: https://github.com/rust-lang/rust/pull/70081/
1812 [70156]: https://github.com/rust-lang/rust/pull/70156/
1813 [71269]: https://github.com/rust-lang/rust/pull/71269/
1814 [69838]: https://github.com/rust-lang/rust/pull/69838/
1815 [69929]: https://github.com/rust-lang/rust/pull/69929/
1816 [69661]: https://github.com/rust-lang/rust/pull/69661/
1817 [69778]: https://github.com/rust-lang/rust/pull/69778/
1818 [69494]: https://github.com/rust-lang/rust/pull/69494/
1819 [69403]: https://github.com/rust-lang/rust/pull/69403/
1820 [69033]: https://github.com/rust-lang/rust/pull/69033/
1821 [68692]: https://github.com/rust-lang/rust/pull/68692/
1822 [68334]: https://github.com/rust-lang/rust/pull/68334/
1823 [67502]: https://github.com/rust-lang/rust/pull/67502/
1824 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1825 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1826 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1827 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1828 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1829 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1830 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1831 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1832 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1833 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1834 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1835 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1836 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1837
1838
1839 Version 1.43.1 (2020-05-07)
1840 ===========================
1841
1842 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1843 * [Fixed the stabilization of AVX-512 features.][71473]
1844 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1845
1846 [71430]: https://github.com/rust-lang/rust/pull/71430
1847 [71473]: https://github.com/rust-lang/rust/issues/71473
1848 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1849
1850
1851 Version 1.43.0 (2020-04-23)
1852 ==========================
1853
1854 Language
1855 --------
1856 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1857   the type inferred correctly.][68129]
1858 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1859
1860 **Syntax only changes**
1861 - [Allow `type Foo: Ord` syntactically.][69361]
1862 - [Fuse associated and extern items up to defaultness.][69194]
1863 - [Syntactically allow `self` in all `fn` contexts.][68764]
1864 - [Merge `fn` syntax + cleanup item parsing.][68728]
1865 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1866   For example, you may now write:
1867   ```rust
1868   macro_rules! mac_trait {
1869       ($i:item) => {
1870           trait T { $i }
1871       }
1872   }
1873   mac_trait! {
1874       fn foo() {}
1875   }
1876   ```
1877
1878 These are still rejected *semantically*, so you will likely receive an error but
1879 these changes can be seen and parsed by macros and
1880 conditional compilation.
1881
1882
1883 Compiler
1884 --------
1885 - [You can now pass multiple lint flags to rustc to override the previous
1886   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1887   everything in the `unused` lint group except `unused-variables` which
1888   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1889   everything in the `unused` lint group **including** `unused-variables` since
1890   the allow flag is specified before the deny flag (and therefore overridden).
1891 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1892   if they are available on `windows-gnu`.][67429]
1893 - [rustc now buffers errors/warnings printed in JSON.][69227]
1894
1895 Libraries
1896 ---------
1897 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1898   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1899   respectively.][69538] **Note** These conversions are only available when `N`
1900   is `0..=32`.
1901 - [You can now use associated constants on floats and integers directly, rather
1902   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1903   `f32::NAN` with no imports.
1904 - [`u8::is_ascii` is now `const`.][68984]
1905 - [`String` now implements `AsMut<str>`.][68742]
1906 - [Added the `primitive` module to `std` and `core`.][67637] This module
1907   reexports Rust's primitive types. This is mainly useful in macros
1908   where you want avoid these types being shadowed.
1909 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1910 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1911
1912 Stabilized APIs
1913 ---------------
1914 - [`Once::is_completed`]
1915 - [`f32::LOG10_2`]
1916 - [`f32::LOG2_10`]
1917 - [`f64::LOG10_2`]
1918 - [`f64::LOG2_10`]
1919 - [`iter::once_with`]
1920
1921 Cargo
1922 -----
1923 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1924   your environment.][cargo/7823]
1925 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1926   executable path when running integration tests or benchmarks.][cargo/7697]
1927   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1928   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1929
1930 Misc
1931 ----
1932 - [Certain checks in the `const_err` lint were deemed unrelated to const
1933   evaluation][69185], and have been moved to the `unconditional_panic` and
1934   `arithmetic_overflow` lints.
1935
1936 Compatibility Notes
1937 -------------------
1938
1939 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1940   has been a warning since 1.36.0.
1941 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1942   led to some instances being accepted, and now correctly emits a hard error.
1943
1944 [69340]: https://github.com/rust-lang/rust/pull/69340
1945
1946 Internal Only
1947 -------------
1948 These changes provide no direct user facing benefits, but represent significant
1949 improvements to the internals and overall performance of `rustc` and
1950 related tools.
1951
1952 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1953 - [Improved how rustc generates drop code.][67332]
1954 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1955 - [traits: preallocate 2 Vecs of known initial size][69022]
1956 - [Avoid exponential behaviour when relating types][68772]
1957 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1958 - [Improve performance of coherence checks][68966]
1959 - [Deduplicate types in the generator witness][68672]
1960 - [Invert control in struct_lint_level.][68725]
1961
1962 [67332]: https://github.com/rust-lang/rust/pull/67332/
1963 [67429]: https://github.com/rust-lang/rust/pull/67429/
1964 [67637]: https://github.com/rust-lang/rust/pull/67637/
1965 [67642]: https://github.com/rust-lang/rust/pull/67642/
1966 [67878]: https://github.com/rust-lang/rust/pull/67878/
1967 [67885]: https://github.com/rust-lang/rust/pull/67885/
1968 [68129]: https://github.com/rust-lang/rust/pull/68129/
1969 [68672]: https://github.com/rust-lang/rust/pull/68672/
1970 [68725]: https://github.com/rust-lang/rust/pull/68725/
1971 [68728]: https://github.com/rust-lang/rust/pull/68728/
1972 [68738]: https://github.com/rust-lang/rust/pull/68738/
1973 [68742]: https://github.com/rust-lang/rust/pull/68742/
1974 [68764]: https://github.com/rust-lang/rust/pull/68764/
1975 [68772]: https://github.com/rust-lang/rust/pull/68772/
1976 [68943]: https://github.com/rust-lang/rust/pull/68943/
1977 [68952]: https://github.com/rust-lang/rust/pull/68952/
1978 [68966]: https://github.com/rust-lang/rust/pull/68966/
1979 [68984]: https://github.com/rust-lang/rust/pull/68984/
1980 [69022]: https://github.com/rust-lang/rust/pull/69022/
1981 [69185]: https://github.com/rust-lang/rust/pull/69185/
1982 [69194]: https://github.com/rust-lang/rust/pull/69194/
1983 [69201]: https://github.com/rust-lang/rust/pull/69201/
1984 [69227]: https://github.com/rust-lang/rust/pull/69227/
1985 [69548]: https://github.com/rust-lang/rust/pull/69548/
1986 [69256]: https://github.com/rust-lang/rust/pull/69256/
1987 [69361]: https://github.com/rust-lang/rust/pull/69361/
1988 [69366]: https://github.com/rust-lang/rust/pull/69366/
1989 [69538]: https://github.com/rust-lang/rust/pull/69538/
1990 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1991 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1992 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1993 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1994 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1995 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1996 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1997 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1998
1999
2000 Version 1.42.0 (2020-03-12)
2001 ==========================
2002
2003 Language
2004 --------
2005 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
2006   ```rust
2007   fn foo(words: &[&str]) {
2008       match words {
2009           ["Hello", "World", "!", ..] => println!("Hello World!"),
2010           ["Foo", "Bar", ..] => println!("Baz"),
2011           rest => println!("{:?}", rest),
2012       }
2013   }
2014   ```
2015 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
2016   that you can create an enum that has the exact layout and ABI of the type
2017   it contains.
2018 - [You can now use outer attribute procedural macros on inline modules.][64273]
2019 - [There are some *syntax-only* changes:][67131]
2020    - `default` is syntactically allowed before items in `trait` definitions.
2021    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
2022      leave out their bodies in favor of `;`.
2023    - Bounds on associated types in `impl`s are now syntactically allowed
2024      (e.g. `type Foo: Ord;`).
2025    - `...` (the C-variadic type) may occur syntactically directly as the type of
2026       any function parameter.
2027
2028   These are still rejected *semantically*, so you will likely receive an error
2029   but these changes can be seen and parsed by procedural macros and
2030   conditional compilation.
2031
2032 Compiler
2033 --------
2034 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
2035 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
2036 - [`Option::{expect,unwrap}` and
2037    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
2038    pointing to the location where they were called, rather than
2039    `core`'s internals. ][67887]
2040
2041 \* Refer to Rust's [platform support page][platform-support-doc] for more
2042 information on Rust's tiered platform support.
2043
2044 Libraries
2045 ---------
2046 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
2047 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
2048    to implement `Sized`.][67935]
2049 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
2050 - [`Layout::new` is now `const`.][66254]
2051 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
2052
2053
2054 Stabilized APIs
2055 ---------------
2056 - [`CondVar::wait_while`]
2057 - [`CondVar::wait_timeout_while`]
2058 - [`DebugMap::key`]
2059 - [`DebugMap::value`]
2060 - [`ManuallyDrop::take`]
2061 - [`matches!`]
2062 - [`ptr::slice_from_raw_parts_mut`]
2063 - [`ptr::slice_from_raw_parts`]
2064
2065 Cargo
2066 -----
2067 - [You no longer need to include `extern crate proc_macro;` to be able to
2068   `use proc_macro;` in the `2018` edition.][cargo/7700]
2069
2070 Compatibility Notes
2071 -------------------
2072 - [`Error::description` has been deprecated, and its use will now produce a
2073   warning.][66919] It's recommended to use `Display`/`to_string` instead.
2074
2075 [68253]: https://github.com/rust-lang/rust/pull/68253/
2076 [68348]: https://github.com/rust-lang/rust/pull/68348/
2077 [67935]: https://github.com/rust-lang/rust/pull/67935/
2078 [68339]: https://github.com/rust-lang/rust/pull/68339/
2079 [68122]: https://github.com/rust-lang/rust/pull/68122/
2080 [64273]: https://github.com/rust-lang/rust/pull/64273/
2081 [67712]: https://github.com/rust-lang/rust/pull/67712/
2082 [67887]: https://github.com/rust-lang/rust/pull/67887/
2083 [67131]: https://github.com/rust-lang/rust/pull/67131/
2084 [67233]: https://github.com/rust-lang/rust/pull/67233/
2085 [66899]: https://github.com/rust-lang/rust/pull/66899/
2086 [66919]: https://github.com/rust-lang/rust/pull/66919/
2087 [66254]: https://github.com/rust-lang/rust/pull/66254/
2088 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
2089 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
2090 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
2091 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
2092 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
2093 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
2094 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
2095 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
2096 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
2097
2098
2099 Version 1.41.1 (2020-02-27)
2100 ===========================
2101
2102 * [Always check types of static items][69145]
2103 * [Always check lifetime bounds of `Copy` impls][69145]
2104 * [Fix miscompilation in callers of `Layout::repeat`][69225]
2105
2106 [69225]: https://github.com/rust-lang/rust/issues/69225
2107 [69145]: https://github.com/rust-lang/rust/pull/69145
2108
2109
2110 Version 1.41.0 (2020-01-30)
2111 ===========================
2112
2113 Language
2114 --------
2115
2116 - [You can now pass type parameters to foreign items when implementing
2117   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
2118 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
2119   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
2120   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
2121 - [You can now use any valid identifier in a `format_args` macro.][66847]
2122   Previously identifiers starting with an underscore were not allowed.
2123 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
2124   enum variants.][66183] These are still rejected semantically, but
2125   can be seen and parsed by procedural macros and conditional compilation.
2126
2127 Compiler
2128 --------
2129
2130 - [Rustc will now warn if you have unused loop `'label`s.][66325]
2131 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
2132 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
2133 - [You can now pass an arguments file passing the `@path` syntax
2134   to rustc.][66172] Note that the format differs somewhat from what is
2135   found in other tooling; please see [the documentation][argfile-docs] for
2136   more information.
2137 - [You can now provide `--extern` flag without a path, indicating that it is
2138   available from the search path or specified with an `-L` flag.][64882]
2139
2140 \* Refer to Rust's [platform support page][platform-support-doc] for more
2141 information on Rust's tiered platform support.
2142
2143 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2144
2145 Libraries
2146 ---------
2147
2148 - [The `core::panic` module is now stable.][66771] It was already stable
2149   through `std`.
2150 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2151   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2152 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2153
2154 Stabilized APIs
2155 ---------------
2156
2157 - [`Result::map_or`]
2158 - [`Result::map_or_else`]
2159 - [`std::rc::Weak::weak_count`]
2160 - [`std::rc::Weak::strong_count`]
2161 - [`std::sync::Weak::weak_count`]
2162 - [`std::sync::Weak::strong_count`]
2163
2164 Cargo
2165 -----
2166
2167 - [Cargo will now document all the private items for binary crates
2168   by default.][cargo/7593]
2169 - [`cargo-install` will now reinstall the package if it detects that it is out
2170   of date.][cargo/7560]
2171 - [Cargo.lock now uses a more git friendly format that should help to reduce
2172   merge conflicts.][cargo/7579]
2173 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2174   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2175   optimisation level to `2` for debug builds. You can also use
2176   `[profile.<profile>.build-override]` to override build scripts and
2177   their dependencies.
2178
2179 Misc
2180 ----
2181
2182 - [You can now specify `edition` in documentation code blocks to compile the block
2183   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2184   should be compiled the 2018 edition of Rust.
2185 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2186   current theme with `--check-theme`.][54733]
2187 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2188
2189 Compatibility Notes
2190 -------------------
2191
2192 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2193   Apple targets.][apple-32bit-drop] This means that the source code is still
2194   available to build, but the targets are no longer being tested and release
2195   binaries for those platforms will no longer be distributed by the Rust project.
2196   Please refer to the linked blog post for more information.
2197
2198 [54733]: https://github.com/rust-lang/rust/pull/54733/
2199 [61351]: https://github.com/rust-lang/rust/pull/61351/
2200 [67255]: https://github.com/rust-lang/rust/pull/67255/
2201 [66661]: https://github.com/rust-lang/rust/pull/66661/
2202 [66771]: https://github.com/rust-lang/rust/pull/66771/
2203 [66847]: https://github.com/rust-lang/rust/pull/66847/
2204 [66238]: https://github.com/rust-lang/rust/pull/66238/
2205 [66277]: https://github.com/rust-lang/rust/pull/66277/
2206 [66325]: https://github.com/rust-lang/rust/pull/66325/
2207 [66172]: https://github.com/rust-lang/rust/pull/66172/
2208 [66183]: https://github.com/rust-lang/rust/pull/66183/
2209 [65879]: https://github.com/rust-lang/rust/pull/65879/
2210 [65013]: https://github.com/rust-lang/rust/pull/65013/
2211 [64882]: https://github.com/rust-lang/rust/pull/64882/
2212 [64325]: https://github.com/rust-lang/rust/pull/64325/
2213 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2214 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2215 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2216 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2217 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2218 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2219 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2220 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2221 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2222 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2223 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2224
2225 Version 1.40.0 (2019-12-19)
2226 ===========================
2227
2228 Language
2229 --------
2230 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2231   `const` contexts.][65188] e.g.
2232
2233   ```rust
2234   pub struct Point(i32, i32);
2235
2236   const ORIGIN: Point = {
2237       let constructor = Point;
2238
2239       constructor(0, 0)
2240   };
2241   ```
2242
2243 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2244   indicate that there may be variants or fields added in the future.][64639]
2245   For example this requires adding a wild-card branch (`_ => {}`) to any match
2246   statements on a non-exhaustive `enum`. [(RFC 2008)]
2247 - [You can now use function-like procedural macros in `extern` blocks and in
2248   type positions.][63931] e.g. `type Generated = macro!();`
2249 - [Function-like and attribute procedural macros can now emit
2250   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2251 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2252   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2253   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2254
2255 Compiler
2256 --------
2257 - [Added tier 3 support\* for the
2258   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2259 - [Added tier 3 support for the
2260   `aarch64-unknown-none-softfloat` target.][64589]
2261 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2262   `mips64el-unknown-linux-muslabi64` targets.][65843]
2263
2264 \* Refer to Rust's [platform support page][platform-support-doc] for more
2265   information on Rust's tiered platform support.
2266
2267 Libraries
2268 ---------
2269 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2270
2271 Stabilized APIs
2272 ---------------
2273 - [`BTreeMap::get_key_value`]
2274 - [`HashMap::get_key_value`]
2275 - [`Option::as_deref_mut`]
2276 - [`Option::as_deref`]
2277 - [`Option::flatten`]
2278 - [`UdpSocket::peer_addr`]
2279 - [`f32::to_be_bytes`]
2280 - [`f32::to_le_bytes`]
2281 - [`f32::to_ne_bytes`]
2282 - [`f64::to_be_bytes`]
2283 - [`f64::to_le_bytes`]
2284 - [`f64::to_ne_bytes`]
2285 - [`f32::from_be_bytes`]
2286 - [`f32::from_le_bytes`]
2287 - [`f32::from_ne_bytes`]
2288 - [`f64::from_be_bytes`]
2289 - [`f64::from_le_bytes`]
2290 - [`f64::from_ne_bytes`]
2291 - [`mem::take`]
2292 - [`slice::repeat`]
2293 - [`todo!`]
2294
2295 Cargo
2296 -----
2297 - [Cargo will now always display warnings, rather than only on
2298   fresh builds.][cargo/7450]
2299 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2300   now produce an error.][cargo/7507] Previously these flags were ignored.
2301 - [You can now publish `dev-dependencies` without including
2302   a `version`.][cargo/7333]
2303
2304 Misc
2305 ----
2306 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2307   when running documentation tests with `rustdoc`.][63803]
2308
2309 Compatibility Notes
2310 -------------------
2311 - [As previously announced, any previous NLL warnings in the 2015 edition are
2312   now hard errors.][64221]
2313 - [The `include!` macro will now warn if it failed to include the
2314   entire file.][64284] The `include!` macro unintentionally only includes the
2315   first _expression_ in a file, and this can be unintuitive. This will become
2316   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2317 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2318   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2319   or `extern` blocks now correctly emits a hard error.
2320
2321 [65294]: https://github.com/rust-lang/rust/pull/65294/
2322 [66103]: https://github.com/rust-lang/rust/pull/66103/
2323 [65843]: https://github.com/rust-lang/rust/pull/65843/
2324 [65188]: https://github.com/rust-lang/rust/pull/65188/
2325 [65092]: https://github.com/rust-lang/rust/pull/65092/
2326 [64589]: https://github.com/rust-lang/rust/pull/64589/
2327 [64639]: https://github.com/rust-lang/rust/pull/64639/
2328 [64221]: https://github.com/rust-lang/rust/pull/64221/
2329 [64284]: https://github.com/rust-lang/rust/pull/64284/
2330 [63931]: https://github.com/rust-lang/rust/pull/63931/
2331 [64035]: https://github.com/rust-lang/rust/pull/64035/
2332 [63674]: https://github.com/rust-lang/rust/pull/63674/
2333 [63803]: https://github.com/rust-lang/rust/pull/63803/
2334 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2335 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2336 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2337 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2338 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2339 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2340 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2341 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2342 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2343 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2344 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2345 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2346 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2347 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2348 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2349 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2350 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2351 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2352 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2353 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2354 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2355 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2356 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2357 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2358 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2359 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2360
2361
2362 Version 1.39.0 (2019-11-07)
2363 ===========================
2364
2365 Language
2366 --------
2367 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2368   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2369 - [You can now use certain attributes on function, closure, and function pointer
2370   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2371   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2372   attributes applied to items. e.g.
2373   ```rust
2374   fn len(
2375       #[cfg(windows)] slice: &[u16],
2376       #[cfg(not(windows))] slice: &[u8],
2377   ) -> usize {
2378       slice.len()
2379   }
2380   ```
2381 - [You can now take shared references to bind-by-move patterns in the `if` guards
2382   of `match` arms.][63118] e.g.
2383   ```rust
2384   fn main() {
2385       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2386
2387       match array {
2388           nums
2389   //      ---- `nums` is bound by move.
2390               if nums.iter().sum::<u8>() == 10
2391   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2392           => {
2393               drop(nums);
2394   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2395           }
2396           _ => unreachable!(),
2397       }
2398   }
2399   ```
2400
2401
2402
2403 Compiler
2404 --------
2405 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2406 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2407 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2408   **Note** Cargo currently doesn't use this feature. Refer to
2409   [cargo#7315][cargo/7315] to track this feature's progress.
2410 - [You can now pass `--show-output` argument to test binaries to print the
2411   output of successful tests.][62600]
2412
2413
2414 \* Refer to Rust's [platform support page][platform-support-doc] for more
2415 information on Rust's tiered platform support.
2416
2417 Libraries
2418 ---------
2419 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2420 - [`LinkedList::new` is now a `const` function.][63684]
2421 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2422 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2423   now `const`.][63786]
2424
2425 Stabilized APIs
2426 ---------------
2427 - [`Pin::into_inner`]
2428 - [`Instant::checked_duration_since`]
2429 - [`Instant::saturating_duration_since`]
2430
2431 Cargo
2432 -----
2433 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2434 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2435   `--all` is now deprecated.
2436
2437 Misc
2438 ----
2439 - [You can now pass `-Clinker` to rustdoc to control the linker used
2440   for compiling doctests.][63834]
2441
2442 Compatibility Notes
2443 -------------------
2444 - [Code that was previously accepted by the old borrow checker, but rejected by
2445   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2446   previously a warning, and will also become a hard error in the Rust 2015
2447   edition in the 1.40.0 release.
2448 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2449   run tests.][63827] This should improve performance when running a large
2450   amount of doctests.
2451 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2452   recommended to use the `?` operator instead.
2453 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2454   returned `0.0`.
2455
2456 [62600]: https://github.com/rust-lang/rust/pull/62600/
2457 [62672]: https://github.com/rust-lang/rust/pull/62672/
2458 [63118]: https://github.com/rust-lang/rust/pull/63118/
2459 [63209]: https://github.com/rust-lang/rust/pull/63209/
2460 [63402]: https://github.com/rust-lang/rust/pull/63402/
2461 [63565]: https://github.com/rust-lang/rust/pull/63565/
2462 [63595]: https://github.com/rust-lang/rust/pull/63595/
2463 [63684]: https://github.com/rust-lang/rust/pull/63684/
2464 [63698]: https://github.com/rust-lang/rust/pull/63698/
2465 [63770]: https://github.com/rust-lang/rust/pull/63770/
2466 [63786]: https://github.com/rust-lang/rust/pull/63786/
2467 [63827]: https://github.com/rust-lang/rust/pull/63827/
2468 [63834]: https://github.com/rust-lang/rust/pull/63834/
2469 [63927]: https://github.com/rust-lang/rust/pull/63927/
2470 [63933]: https://github.com/rust-lang/rust/pull/63933/
2471 [63934]: https://github.com/rust-lang/rust/pull/63934/
2472 [63938]: https://github.com/rust-lang/rust/pull/63938/
2473 [63940]: https://github.com/rust-lang/rust/pull/63940/
2474 [63941]: https://github.com/rust-lang/rust/pull/63941/
2475 [63945]: https://github.com/rust-lang/rust/pull/63945/
2476 [64010]: https://github.com/rust-lang/rust/pull/64010/
2477 [64028]: https://github.com/rust-lang/rust/pull/64028/
2478 [64334]: https://github.com/rust-lang/rust/pull/64334/
2479 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2480 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2481 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2482 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2483 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2484 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2485
2486 Version 1.38.0 (2019-09-26)
2487 ==========================
2488
2489 Language
2490 --------
2491 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2492 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2493
2494 Compiler
2495 --------
2496 - [Added pipelined compilation support to `rustc`.][62766] This will
2497   improve compilation times in some cases. For further information please refer
2498   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2499 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2500   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2501   `x86_64-uwp-windows-msvc` targets.][60260]
2502 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2503   `armv7-unknown-linux-musleabi` targets.][63107]
2504 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2505 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2506 - [Upgraded to LLVM 9.][62592]
2507
2508 \* Refer to Rust's [platform support page][platform-support-doc] for more
2509 information on Rust's tiered platform support.
2510
2511 Libraries
2512 ---------
2513 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2514 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2515   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2516   is available at `std::clone::Clone`). This also makes all built-in macros
2517   available in `std`/`core` root. e.g. `std::include_bytes!`.
2518 - [`str::Chars` now implements `Debug`.][63000]
2519 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2520 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2521 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2522 - [Added euclidean remainder and division operations (`div_euclid`,
2523   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2524   `overflowing`, and `wrapping` versions are available for all
2525   integer primitives.
2526 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2527   `PartialEq`.][61491]
2528 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2529
2530 Stabilized APIs
2531 ---------------
2532 - [`<*const T>::cast`]
2533 - [`<*mut T>::cast`]
2534 - [`Duration::as_secs_f32`]
2535 - [`Duration::as_secs_f64`]
2536 - [`Duration::div_f32`]
2537 - [`Duration::div_f64`]
2538 - [`Duration::from_secs_f32`]
2539 - [`Duration::from_secs_f64`]
2540 - [`Duration::mul_f32`]
2541 - [`Duration::mul_f64`]
2542 - [`any::type_name`]
2543
2544 Cargo
2545 -----
2546 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2547 - [You can now pass the `--features` option multiple times to enable
2548   multiple features.][cargo/7084]
2549
2550 Rustdoc
2551 -------
2552
2553 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2554
2555 Misc
2556 ----
2557 - [`rustc` will now warn about some incorrect uses of
2558   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2559
2560 Compatibility Notes
2561 -------------------
2562 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2563   1.38.0.
2564 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2565   issues][62896] with certain crates such as libc.
2566
2567 [60260]: https://github.com/rust-lang/rust/pull/60260/
2568 [61457]: https://github.com/rust-lang/rust/pull/61457/
2569 [61491]: https://github.com/rust-lang/rust/pull/61491/
2570 [61884]: https://github.com/rust-lang/rust/pull/61884/
2571 [61953]: https://github.com/rust-lang/rust/pull/61953/
2572 [62042]: https://github.com/rust-lang/rust/pull/62042/
2573 [62528]: https://github.com/rust-lang/rust/pull/62528/
2574 [62583]: https://github.com/rust-lang/rust/pull/62583/
2575 [62735]: https://github.com/rust-lang/rust/pull/62735/
2576 [62766]: https://github.com/rust-lang/rust/pull/62766/
2577 [62784]: https://github.com/rust-lang/rust/pull/62784/
2578 [62592]: https://github.com/rust-lang/rust/pull/62592/
2579 [62785]: https://github.com/rust-lang/rust/issues/62785/
2580 [62814]: https://github.com/rust-lang/rust/pull/62814/
2581 [62896]: https://github.com/rust-lang/rust/issues/62896/
2582 [63000]: https://github.com/rust-lang/rust/pull/63000/
2583 [63056]: https://github.com/rust-lang/rust/pull/63056/
2584 [63107]: https://github.com/rust-lang/rust/pull/63107/
2585 [63346]: https://github.com/rust-lang/rust/pull/63346/
2586 [63421]: https://github.com/rust-lang/rust/pull/63421/
2587 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2588 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2589 [63048]: https://github.com/rust-lang/rust/pull/63048
2590 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2591 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2592 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2593 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2594 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2595 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2596 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2597 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2598 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2599 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2600 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2601 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2602 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2603
2604 Version 1.37.0 (2019-08-15)
2605 ==========================
2606
2607 Language
2608 --------
2609 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2610   [`Box`][62228], or an [array][62235] and unused.
2611 - [You can now use the `cfg` and `cfg_attr` attributes on
2612   generic parameters.][61547]
2613 - [You can now use enum variants through type alias.][61682] e.g. You can
2614   write the following:
2615   ```rust
2616   type MyOption = Option<u8>;
2617
2618   fn increment_or_zero(x: MyOption) -> u8 {
2619       match x {
2620           MyOption::Some(y) => y + 1,
2621           MyOption::None => 0,
2622       }
2623   }
2624   ```
2625 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2626   `const _: u32 = 5;`.
2627 - [You can now use `#[repr(align(X)]` on enums.][61229]
2628 - [The  `?` Kleene macro operator is now available in the
2629   2015 edition.][60932]
2630
2631 Compiler
2632 --------
2633 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2634   and `-C profile-use` flags.][61268] For more information on how to use profile
2635   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2636 - [The `rust-lldb` wrapper script should now work again.][61827]
2637
2638 Libraries
2639 ---------
2640 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2641
2642 Stabilized APIs
2643 ---------------
2644 - [`BufReader::buffer`]
2645 - [`BufWriter::buffer`]
2646 - [`Cell::from_mut`]
2647 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2648 - [`DoubleEndedIterator::nth_back`]
2649 - [`Option::xor`]
2650 - [`Wrapping::reverse_bits`]
2651 - [`i128::reverse_bits`]
2652 - [`i16::reverse_bits`]
2653 - [`i32::reverse_bits`]
2654 - [`i64::reverse_bits`]
2655 - [`i8::reverse_bits`]
2656 - [`isize::reverse_bits`]
2657 - [`slice::copy_within`]
2658 - [`u128::reverse_bits`]
2659 - [`u16::reverse_bits`]
2660 - [`u32::reverse_bits`]
2661 - [`u64::reverse_bits`]
2662 - [`u8::reverse_bits`]
2663 - [`usize::reverse_bits`]
2664
2665 Cargo
2666 -----
2667 - [`Cargo.lock` files are now included by default when publishing executable crates
2668   with executables.][cargo/7026]
2669 - [You can now specify `default-run="foo"` in `[package]` to specify the
2670   default executable to use for `cargo run`.][cargo/7056]
2671
2672 Misc
2673 ----
2674
2675 Compatibility Notes
2676 -------------------
2677 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2678   Please transition your code to using the `..=` syntax for inclusive
2679   ranges instead.
2680 - [Using a trait object without the `dyn` will now warn by default.][61203]
2681   Please transition your code to use `dyn Trait` for trait objects instead.
2682
2683 [62228]: https://github.com/rust-lang/rust/pull/62228/
2684 [62235]: https://github.com/rust-lang/rust/pull/62235/
2685 [61802]: https://github.com/rust-lang/rust/pull/61802/
2686 [61827]: https://github.com/rust-lang/rust/pull/61827/
2687 [61547]: https://github.com/rust-lang/rust/pull/61547/
2688 [61682]: https://github.com/rust-lang/rust/pull/61682/
2689 [61268]: https://github.com/rust-lang/rust/pull/61268/
2690 [61342]: https://github.com/rust-lang/rust/pull/61342/
2691 [61347]: https://github.com/rust-lang/rust/pull/61347/
2692 [61100]: https://github.com/rust-lang/rust/pull/61100/
2693 [61203]: https://github.com/rust-lang/rust/pull/61203/
2694 [61229]: https://github.com/rust-lang/rust/pull/61229/
2695 [60932]: https://github.com/rust-lang/rust/pull/60932/
2696 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2697 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2698 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2699 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2700 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2701 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2702 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2703 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2704 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2705 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2706 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2707 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2708 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2709 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2710 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2711 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2712 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2713 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2714 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2715 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2716 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2717 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2718 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2719 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2720
2721
2722 Version 1.36.0 (2019-07-04)
2723 ==========================
2724
2725 Language
2726 --------
2727 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2728 - [The order of traits in trait objects no longer affects the semantics of that
2729   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2730   `dyn fmt::Debug + Send`, where this was previously not the case.
2731
2732 Libraries
2733 ---------
2734 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2735 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2736 - [`mem::needs_drop` is now available as a const fn.][60364]
2737 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2738 - [`String` now implements `BorrowMut<str>`.][60404]
2739 - [`io::Cursor` now implements `Default`.][60234]
2740 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2741 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2742   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2743   environment has access to heap memory allocation.
2744 - [`String` now implements `From<&String>`.][59825]
2745 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2746   return a tuple of each argument when there is multiple arguments.
2747 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2748   not used.][59648]
2749
2750 Stabilized APIs
2751 ---------------
2752 - [`VecDeque::rotate_left`]
2753 - [`VecDeque::rotate_right`]
2754 - [`Iterator::copied`]
2755 - [`io::IoSlice`]
2756 - [`io::IoSliceMut`]
2757 - [`Read::read_vectored`]
2758 - [`Write::write_vectored`]
2759 - [`str::as_mut_ptr`]
2760 - [`mem::MaybeUninit`]
2761 - [`pointer::align_offset`]
2762 - [`future::Future`]
2763 - [`task::Context`]
2764 - [`task::RawWaker`]
2765 - [`task::RawWakerVTable`]
2766 - [`task::Waker`]
2767 - [`task::Poll`]
2768
2769 Cargo
2770 -----
2771 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2772 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2773
2774 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2775
2776 Clippy
2777 ------
2778 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2779
2780 Misc
2781 ----
2782
2783 Compatibility Notes
2784 -------------------
2785 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2786   longer recommended, and will be deprecated in 1.39.0.
2787
2788 [60318]: https://github.com/rust-lang/rust/pull/60318/
2789 [60364]: https://github.com/rust-lang/rust/pull/60364/
2790 [60370]: https://github.com/rust-lang/rust/pull/60370/
2791 [60404]: https://github.com/rust-lang/rust/pull/60404/
2792 [60234]: https://github.com/rust-lang/rust/pull/60234/
2793 [60244]: https://github.com/rust-lang/rust/pull/60244/
2794 [58623]: https://github.com/rust-lang/rust/pull/58623/
2795 [59648]: https://github.com/rust-lang/rust/pull/59648/
2796 [59675]: https://github.com/rust-lang/rust/pull/59675/
2797 [59825]: https://github.com/rust-lang/rust/pull/59825/
2798 [59826]: https://github.com/rust-lang/rust/pull/59826/
2799 [59445]: https://github.com/rust-lang/rust/pull/59445/
2800 [59114]: https://github.com/rust-lang/rust/pull/59114/
2801 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2802 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2803 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2804 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2805 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2806 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2807 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2808 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2809 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2810 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2811 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2812 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2813 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2814 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2815 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2816 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2817 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2818 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2819 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2820 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2821
2822
2823 Version 1.35.0 (2019-05-23)
2824 ==========================
2825
2826 Language
2827 --------
2828 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2829   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2830 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2831   ```rust
2832   unsafe fn call_unsafe(func: unsafe fn()) {
2833       func()
2834   }
2835
2836   pub fn main() {
2837       unsafe { call_unsafe(|| {}); }
2838   }
2839   ```
2840
2841
2842 Compiler
2843 --------
2844 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2845   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2846 - [Added the `wasm32-unknown-wasi` target.][59464]
2847
2848
2849 Libraries
2850 ---------
2851 - [`Thread` will now show its ID in `Debug` output.][59460]
2852 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2853 - [`alloc::System` now implements `Default`.][59451]
2854 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2855   last field.][59076]
2856 - [`char::{ToLowercase, ToUppercase}` now
2857   implement `ExactSizeIterator`.][58778]
2858 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2859 - [Removed the `Read` trait bounds
2860   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2861 - [You can now call the `dbg!` macro without any parameters to print the file
2862   and line where it is called.][57847]
2863 - [In place ASCII case conversions are now up to 4× faster.][59283]
2864   e.g. `str::make_ascii_lowercase`
2865 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2866   and `Send`.][58369]
2867
2868 Stabilized APIs
2869 ---------------
2870 - [`f32::copysign`]
2871 - [`f64::copysign`]
2872 - [`RefCell::replace_with`]
2873 - [`RefCell::map_split`]
2874 - [`ptr::hash`]
2875 - [`Range::contains`]
2876 - [`RangeFrom::contains`]
2877 - [`RangeTo::contains`]
2878 - [`RangeInclusive::contains`]
2879 - [`RangeToInclusive::contains`]
2880 - [`Option::copied`]
2881
2882 Cargo
2883 -----
2884 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2885   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2886   platform specific.
2887
2888 Misc
2889 ----
2890 - [The Rust toolchain is now available natively for musl based distros.][58575]
2891
2892 [59460]: https://github.com/rust-lang/rust/pull/59460/
2893 [59464]: https://github.com/rust-lang/rust/pull/59464/
2894 [59500]: https://github.com/rust-lang/rust/pull/59500/
2895 [59512]: https://github.com/rust-lang/rust/pull/59512/
2896 [59580]: https://github.com/rust-lang/rust/pull/59580/
2897 [59283]: https://github.com/rust-lang/rust/pull/59283/
2898 [59451]: https://github.com/rust-lang/rust/pull/59451/
2899 [59076]: https://github.com/rust-lang/rust/pull/59076/
2900 [58778]: https://github.com/rust-lang/rust/pull/58778/
2901 [58717]: https://github.com/rust-lang/rust/pull/58717/
2902 [58369]: https://github.com/rust-lang/rust/pull/58369/
2903 [58423]: https://github.com/rust-lang/rust/pull/58423/
2904 [58080]: https://github.com/rust-lang/rust/pull/58080/
2905 [57847]: https://github.com/rust-lang/rust/pull/57847/
2906 [58575]: https://github.com/rust-lang/rust/pull/58575
2907 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2908 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2909 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2910 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2911 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2912 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2913 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2914 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2915 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2916 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2917 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2918 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2919
2920 Version 1.34.2 (2019-05-14)
2921 ===========================
2922
2923 * [Destabilize the `Error::type_id` function due to a security
2924    vulnerability][60785] ([CVE-2019-12083])
2925
2926 [60785]: https://github.com/rust-lang/rust/pull/60785
2927 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2928
2929 Version 1.34.1 (2019-04-25)
2930 ===========================
2931
2932 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2933 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2934 * [Fix Clippy panic when checking some macros][clippy/3805]
2935
2936 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2937 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2938 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2939
2940 Version 1.34.0 (2019-04-11)
2941 ==========================
2942
2943 Language
2944 --------
2945 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2946   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2947   but had no effect.
2948 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2949   `#[attr{}]` procedural macros.][57367]
2950 - [You can now write `extern crate self as foo;`][57407] to import your
2951   crate's root into the extern prelude.
2952
2953
2954 Compiler
2955 --------
2956 - [You can now target `riscv64imac-unknown-none-elf` and
2957   `riscv64gc-unknown-none-elf`.][58406]
2958 - [You can now enable linker plugin LTO optimisations with
2959   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2960   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2961   boundaries.
2962 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2963
2964
2965 Libraries
2966 ---------
2967 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2968   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2969   the `Hash` trait to create an iterator.
2970 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2971   methods.][58421] Most notably you no longer require the `Ord` trait to create
2972   an iterator.
2973 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2974   for all numeric types.][58044]
2975 - [Indexing a `str` is now generic over all types that
2976   implement `SliceIndex<str>`.][57604]
2977 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2978   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2979   produce a warning if their returning type is unused.
2980 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2981   `overflowing_pow` are now available for all numeric types.][57873] These are
2982   equivalent to methods such as `wrapping_add` for the `pow` operation.
2983
2984
2985 Stabilized APIs
2986 ---------------
2987
2988 #### std & core
2989 * [`Any::type_id`]
2990 * [`Error::type_id`]
2991 * [`atomic::AtomicI16`]
2992 * [`atomic::AtomicI32`]
2993 * [`atomic::AtomicI64`]
2994 * [`atomic::AtomicI8`]
2995 * [`atomic::AtomicU16`]
2996 * [`atomic::AtomicU32`]
2997 * [`atomic::AtomicU64`]
2998 * [`atomic::AtomicU8`]
2999 * [`convert::Infallible`]
3000 * [`convert::TryFrom`]
3001 * [`convert::TryInto`]
3002 * [`iter::from_fn`]
3003 * [`iter::successors`]
3004 * [`num::NonZeroI128`]
3005 * [`num::NonZeroI16`]
3006 * [`num::NonZeroI32`]
3007 * [`num::NonZeroI64`]
3008 * [`num::NonZeroI8`]
3009 * [`num::NonZeroIsize`]
3010 * [`slice::sort_by_cached_key`]
3011 * [`str::escape_debug`]
3012 * [`str::escape_default`]
3013 * [`str::escape_unicode`]
3014 * [`str::split_ascii_whitespace`]
3015
3016 #### std
3017 * [`Instant::checked_add`]
3018 * [`Instant::checked_sub`]
3019 * [`SystemTime::checked_add`]
3020 * [`SystemTime::checked_sub`]
3021
3022 Cargo
3023 -----
3024 - [You can now use alternative registries to crates.io.][cargo/6654]
3025
3026 Misc
3027 ----
3028 - [You can now use the `?` operator in your documentation tests without manually
3029   adding `fn main() -> Result<(), _> {}`.][56470]
3030
3031 Compatibility Notes
3032 -------------------
3033 - [`Command::before_exec` is being replaced by the unsafe method
3034   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
3035 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
3036   can now use `const` functions in `static` variables.
3037
3038 [58370]: https://github.com/rust-lang/rust/pull/58370/
3039 [58406]: https://github.com/rust-lang/rust/pull/58406/
3040 [58421]: https://github.com/rust-lang/rust/pull/58421/
3041 [58166]: https://github.com/rust-lang/rust/pull/58166/
3042 [58044]: https://github.com/rust-lang/rust/pull/58044/
3043 [58057]: https://github.com/rust-lang/rust/pull/58057/
3044 [58059]: https://github.com/rust-lang/rust/pull/58059/
3045 [57809]: https://github.com/rust-lang/rust/pull/57809/
3046 [57873]: https://github.com/rust-lang/rust/pull/57873/
3047 [57604]: https://github.com/rust-lang/rust/pull/57604/
3048 [57367]: https://github.com/rust-lang/rust/pull/57367/
3049 [57407]: https://github.com/rust-lang/rust/pull/57407/
3050 [57425]: https://github.com/rust-lang/rust/pull/57425/
3051 [57106]: https://github.com/rust-lang/rust/pull/57106/
3052 [56470]: https://github.com/rust-lang/rust/pull/56470/
3053 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
3054 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
3055 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
3056 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
3057 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
3058 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
3059 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
3060 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
3061 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
3062 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
3063 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
3064 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
3065 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
3066 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
3067 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
3068 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
3069 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
3070 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
3071 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
3072 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
3073 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
3074 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
3075 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
3076 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
3077 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
3078 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
3079 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
3080 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
3081 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
3082 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
3083 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
3084
3085
3086 Version 1.33.0 (2019-02-28)
3087 ==========================
3088
3089 Language
3090 --------
3091 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
3092   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
3093 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
3094   E.g. You can have match statement on a `u8` that covers `0..=255` and
3095   you would no longer be required to have a `_ => unreachable!()` case.
3096 - [You can now have multiple patterns in `if let` and `while let`
3097   expressions.][57532] You can do this with the same syntax as a `match`
3098   expression. E.g.
3099   ```rust
3100   enum Creature {
3101       Crab(String),
3102       Lobster(String),
3103       Person(String),
3104   }
3105
3106   fn main() {
3107       let state = Creature::Crab("Ferris");
3108
3109       if let Creature::Crab(name) | Creature::Person(name) = state {
3110           println!("This creature's name is: {}", name);
3111       }
3112   }
3113   ```
3114 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
3115   this feature will by default produce a warning as this behaviour can be
3116   unintuitive. E.g. `if let _ = 5 {}`
3117 - [You can now use `let` bindings, assignments, expression statements,
3118   and irrefutable pattern destructuring in const functions.][57175]
3119 - [You can now call unsafe const functions.][57067] E.g.
3120   ```rust
3121   const unsafe fn foo() -> i32 { 5 }
3122   const fn bar() -> i32 {
3123       unsafe { foo() }
3124   }
3125   ```
3126 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
3127   E.g. `#[cfg_attr(all(), must_use, optimize)]`
3128 - [You can now specify a specific alignment with the `#[repr(packed)]`
3129   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
3130   with an alignment of 2 bytes and a size of 6 bytes.
3131 - [You can now import an item from a module as an `_`.][56303] This allows you to
3132   import a trait's impls, and not have the name in the namespace. E.g.
3133   ```rust
3134   use std::io::Read as _;
3135
3136   // Allowed as there is only one `Read` in the module.
3137   pub trait Read {}
3138   ```
3139 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3140
3141 Compiler
3142 --------
3143 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3144   command line argument.][56351]
3145 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3146 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3147 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3148   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3149   information on Rust's platform support.
3150 - [Added support for the `thumbv7neon-linux-androideabi` and
3151   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3152 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3153
3154 Libraries
3155 ---------
3156 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3157   functions for all numeric types.][57566]
3158 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3159   are now `const` functions for all numeric types.][57105]
3160 - [The methods `is_positive` and `is_negative` are now `const` functions for
3161   all signed numeric types.][57105]
3162 - [The `get` method for all `NonZero` types is now `const`.][57167]
3163 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3164   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3165   numeric types.][57234]
3166 - [`Ipv4Addr::new` is now a `const` function][57234]
3167
3168 Stabilized APIs
3169 ---------------
3170 - [`unix::FileExt::read_exact_at`]
3171 - [`unix::FileExt::write_all_at`]
3172 - [`Option::transpose`]
3173 - [`Result::transpose`]
3174 - [`convert::identity`]
3175 - [`pin::Pin`]
3176 - [`marker::Unpin`]
3177 - [`marker::PhantomPinned`]
3178 - [`Vec::resize_with`]
3179 - [`VecDeque::resize_with`]
3180 - [`Duration::as_millis`]
3181 - [`Duration::as_micros`]
3182 - [`Duration::as_nanos`]
3183
3184
3185 Cargo
3186 -----
3187 - [You can now publish crates that require a feature flag to compile with
3188   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3189 - [Cargo should now rebuild a crate if a file was modified during the initial
3190   build.][cargo/6484]
3191
3192 Compatibility Notes
3193 -------------------
3194 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3195   are now deprecated in the standard library, and their usage will now produce a warning.
3196   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3197   methods instead.
3198 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3199   downcasting.
3200 - [Libtest no longer creates a new thread for each test when
3201   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3202
3203 [55982]: https://github.com/rust-lang/rust/pull/55982/
3204 [56243]: https://github.com/rust-lang/rust/pull/56243
3205 [56303]: https://github.com/rust-lang/rust/pull/56303/
3206 [56351]: https://github.com/rust-lang/rust/pull/56351/
3207 [56362]: https://github.com/rust-lang/rust/pull/56362
3208 [56642]: https://github.com/rust-lang/rust/pull/56642/
3209 [56769]: https://github.com/rust-lang/rust/pull/56769/
3210 [56805]: https://github.com/rust-lang/rust/pull/56805
3211 [56947]: https://github.com/rust-lang/rust/pull/56947/
3212 [57049]: https://github.com/rust-lang/rust/pull/57049/
3213 [57067]: https://github.com/rust-lang/rust/pull/57067/
3214 [57105]: https://github.com/rust-lang/rust/pull/57105
3215 [57130]: https://github.com/rust-lang/rust/pull/57130/
3216 [57167]: https://github.com/rust-lang/rust/pull/57167/
3217 [57175]: https://github.com/rust-lang/rust/pull/57175/
3218 [57234]: https://github.com/rust-lang/rust/pull/57234/
3219 [57332]: https://github.com/rust-lang/rust/pull/57332/
3220 [57465]: https://github.com/rust-lang/rust/pull/57465/
3221 [57532]: https://github.com/rust-lang/rust/pull/57532/
3222 [57535]: https://github.com/rust-lang/rust/pull/57535/
3223 [57566]: https://github.com/rust-lang/rust/pull/57566/
3224 [57615]: https://github.com/rust-lang/rust/pull/57615/
3225 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3226 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3227 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3228 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3229 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3230 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3231 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3232 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3233 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3234 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3235 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3236 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3237 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3238 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3239 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3240 [platform-support]: https://forge.rust-lang.org/platform-support.html
3241
3242 Version 1.32.0 (2019-01-17)
3243 ==========================
3244
3245 Language
3246 --------
3247 #### 2018 edition
3248 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3249   operator allows you to specify zero or one repetitions similar to the `*` and
3250   `+` operators.
3251 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3252   now always resolve to the item (`enum`, `struct`, etc.) available in the
3253   module if present, before resolving to a external crate or an item the prelude.][56759]
3254   E.g.
3255   ```rust
3256   enum Color { Red, Green, Blue }
3257
3258   use Color::*;
3259   ```
3260
3261 #### All editions
3262 - [You can now match against `PhantomData<T>` types.][55837]
3263 - [You can now match against literals in macros with the `literal`
3264   specifier.][56072] This will match against a literal of any type.
3265   E.g. `1`, `'A'`, `"Hello World"`
3266 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3267   ```rust
3268   struct Point(i32, i32);
3269
3270   impl Point {
3271       pub fn new(x: i32, y: i32) -> Self {
3272           Self(x, y)
3273       }
3274
3275       pub fn is_origin(&self) -> bool {
3276           match self {
3277               Self(0, 0) => true,
3278               _ => false,
3279           }
3280       }
3281   }
3282   ```
3283 - [Self can also now be used in type definitions.][56366] E.g.
3284   ```rust
3285   enum List<T>
3286   where
3287       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3288   {
3289       Nil,
3290       Cons(T, Box<Self>) // likewise here
3291   }
3292   ```
3293 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3294   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3295
3296 Compiler
3297 --------
3298 - [The default allocator has changed from jemalloc to the default allocator on
3299   your system.][55238] The compiler itself on Linux & macOS will still use
3300   jemalloc, but programs compiled with it will use the system allocator.
3301 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3302
3303 Libraries
3304 ---------
3305 - [`PathBuf` now implements `FromStr`.][55148]
3306 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3307 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3308   easily debug expressions in your rust program. E.g.
3309   ```rust
3310   let a = 2;
3311   let b = dbg!(a * 2) + 1;
3312   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3313   assert_eq!(b, 5);
3314   ```
3315
3316 The following APIs are now `const` functions and can be used in a
3317 `const` context.
3318
3319 - [`Cell::as_ptr`]
3320 - [`UnsafeCell::get`]
3321 - [`char::is_ascii`]
3322 - [`iter::empty`]
3323 - [`ManuallyDrop::new`]
3324 - [`ManuallyDrop::into_inner`]
3325 - [`RangeInclusive::start`]
3326 - [`RangeInclusive::end`]
3327 - [`NonNull::as_ptr`]
3328 - [`slice::as_ptr`]
3329 - [`str::as_ptr`]
3330 - [`Duration::as_secs`]
3331 - [`Duration::subsec_millis`]
3332 - [`Duration::subsec_micros`]
3333 - [`Duration::subsec_nanos`]
3334 - [`CStr::as_ptr`]
3335 - [`Ipv4Addr::is_unspecified`]
3336 - [`Ipv6Addr::new`]
3337 - [`Ipv6Addr::octets`]
3338
3339 Stabilized APIs
3340 ---------------
3341 - [`i8::to_be_bytes`]
3342 - [`i8::to_le_bytes`]
3343 - [`i8::to_ne_bytes`]
3344 - [`i8::from_be_bytes`]
3345 - [`i8::from_le_bytes`]
3346 - [`i8::from_ne_bytes`]
3347 - [`i16::to_be_bytes`]
3348 - [`i16::to_le_bytes`]
3349 - [`i16::to_ne_bytes`]
3350 - [`i16::from_be_bytes`]
3351 - [`i16::from_le_bytes`]
3352 - [`i16::from_ne_bytes`]
3353 - [`i32::to_be_bytes`]
3354 - [`i32::to_le_bytes`]
3355 - [`i32::to_ne_bytes`]
3356 - [`i32::from_be_bytes`]
3357 - [`i32::from_le_bytes`]
3358 - [`i32::from_ne_bytes`]
3359 - [`i64::to_be_bytes`]
3360 - [`i64::to_le_bytes`]
3361 - [`i64::to_ne_bytes`]
3362 - [`i64::from_be_bytes`]
3363 - [`i64::from_le_bytes`]
3364 - [`i64::from_ne_bytes`]
3365 - [`i128::to_be_bytes`]
3366 - [`i128::to_le_bytes`]
3367 - [`i128::to_ne_bytes`]
3368 - [`i128::from_be_bytes`]
3369 - [`i128::from_le_bytes`]
3370 - [`i128::from_ne_bytes`]
3371 - [`isize::to_be_bytes`]
3372 - [`isize::to_le_bytes`]
3373 - [`isize::to_ne_bytes`]
3374 - [`isize::from_be_bytes`]
3375 - [`isize::from_le_bytes`]
3376 - [`isize::from_ne_bytes`]
3377 - [`u8::to_be_bytes`]
3378 - [`u8::to_le_bytes`]
3379 - [`u8::to_ne_bytes`]
3380 - [`u8::from_be_bytes`]
3381 - [`u8::from_le_bytes`]
3382 - [`u8::from_ne_bytes`]
3383 - [`u16::to_be_bytes`]
3384 - [`u16::to_le_bytes`]
3385 - [`u16::to_ne_bytes`]
3386 - [`u16::from_be_bytes`]
3387 - [`u16::from_le_bytes`]
3388 - [`u16::from_ne_bytes`]
3389 - [`u32::to_be_bytes`]
3390 - [`u32::to_le_bytes`]
3391 - [`u32::to_ne_bytes`]
3392 - [`u32::from_be_bytes`]
3393 - [`u32::from_le_bytes`]
3394 - [`u32::from_ne_bytes`]
3395 - [`u64::to_be_bytes`]
3396 - [`u64::to_le_bytes`]
3397 - [`u64::to_ne_bytes`]
3398 - [`u64::from_be_bytes`]
3399 - [`u64::from_le_bytes`]
3400 - [`u64::from_ne_bytes`]
3401 - [`u128::to_be_bytes`]
3402 - [`u128::to_le_bytes`]
3403 - [`u128::to_ne_bytes`]
3404 - [`u128::from_be_bytes`]
3405 - [`u128::from_le_bytes`]
3406 - [`u128::from_ne_bytes`]
3407 - [`usize::to_be_bytes`]
3408 - [`usize::to_le_bytes`]
3409 - [`usize::to_ne_bytes`]
3410 - [`usize::from_be_bytes`]
3411 - [`usize::from_le_bytes`]
3412 - [`usize::from_ne_bytes`]
3413
3414 Cargo
3415 -----
3416 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3417 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3418
3419 Misc
3420 ----
3421 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3422
3423 Compatibility Notes
3424 -------------------
3425 - [The argument types for AVX's
3426   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3427   been changed from `*const` to `*mut` as the previous implementation
3428   was unsound.
3429
3430
3431 [55148]: https://github.com/rust-lang/rust/pull/55148/
3432 [55238]: https://github.com/rust-lang/rust/pull/55238/
3433 [55280]: https://github.com/rust-lang/rust/pull/55280/
3434 [55610]: https://github.com/rust-lang/rust/pull/55610/
3435 [55663]: https://github.com/rust-lang/rust/pull/55663/
3436 [55702]: https://github.com/rust-lang/rust/pull/55702/
3437 [55837]: https://github.com/rust-lang/rust/pull/55837/
3438 [55843]: https://github.com/rust-lang/rust/pull/55843/
3439 [56072]: https://github.com/rust-lang/rust/pull/56072/
3440 [56245]: https://github.com/rust-lang/rust/pull/56245/
3441 [56365]: https://github.com/rust-lang/rust/pull/56365/
3442 [56366]: https://github.com/rust-lang/rust/pull/56366/
3443 [56395]: https://github.com/rust-lang/rust/pull/56395/
3444 [56759]: https://github.com/rust-lang/rust/pull/56759/
3445 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3446 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3447 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3448 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3449 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3450 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3451 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3452 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3453 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3454 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3455 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3456 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3457 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3458 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3459 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3460 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3461 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3462 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3463 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3464 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3465 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3466 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3467 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3468 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3469 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3470 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3471 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3472 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3473 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3474 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3475 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3476 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3477 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3478 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3479 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3480 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3481 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3482 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3483 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3484 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3485 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3486 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3487 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3488 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3489 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3490 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3491 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3492 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3493 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3494 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3495 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3496 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3497 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3498 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3499 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3500 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3501 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3502 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3503 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3504 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3505 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3506 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3507 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3508 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3509 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3510 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3511 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3512 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3513 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3514 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3515 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3516 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3517 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3518 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3519 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3520 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3521 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3522 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3523 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3524 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3525 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3526 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3527 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3528 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3529 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3530 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3531 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3532 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3533 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3534 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3535 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3536 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3537 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3538
3539
3540 Version 1.31.1 (2018-12-20)
3541 ===========================
3542
3543 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3544 - [Fix broken go-to-definition in RLS][rls/1171]
3545 - [Fix infinite loop on hover in RLS][rls/1170]
3546
3547 [56562]: https://github.com/rust-lang/rust/pull/56562
3548 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3549 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3550
3551 Version 1.31.0 (2018-12-06)
3552 ==========================
3553
3554 Language
3555 --------
3556 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3557 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3558   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3559   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3560   in structs.
3561 - [You can now define and use `const` functions.][54835] These are currently
3562   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3563   [language reference][const-reference] for what exactly is available.
3564 - [You can now use tool lints, which allow you to scope lints from external
3565   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3566 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3567   a crate, not just in exported functions.][54451]
3568 - [You can now use parentheses in pattern matches.][54497]
3569
3570 Compiler
3571 --------
3572 - [Updated musl to 1.1.20][54430]
3573
3574 Libraries
3575 ---------
3576 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3577   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3578 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3579   into `Option<&mut T>` using the `From` trait.][53218]
3580 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3581
3582
3583 Stabilized APIs
3584 ---------------
3585 - [`slice::align_to`]
3586 - [`slice::align_to_mut`]
3587 - [`slice::chunks_exact`]
3588 - [`slice::chunks_exact_mut`]
3589 - [`slice::rchunks`]
3590 - [`slice::rchunks_mut`]
3591 - [`slice::rchunks_exact`]
3592 - [`slice::rchunks_exact_mut`]
3593 - [`Option::replace`]
3594
3595 Cargo
3596 -----
3597 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3598 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3599   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3600
3601 [52813]: https://github.com/rust-lang/rust/pull/52813/
3602 [53218]: https://github.com/rust-lang/rust/pull/53218/
3603 [53555]: https://github.com/rust-lang/rust/issues/53555/
3604 [54057]: https://github.com/rust-lang/rust/pull/54057/
3605 [54240]: https://github.com/rust-lang/rust/pull/54240/
3606 [54430]: https://github.com/rust-lang/rust/pull/54430/
3607 [54451]: https://github.com/rust-lang/rust/pull/54451/
3608 [54497]: https://github.com/rust-lang/rust/pull/54497/
3609 [54778]: https://github.com/rust-lang/rust/pull/54778/
3610 [54835]: https://github.com/rust-lang/rust/pull/54835/
3611 [54870]: https://github.com/rust-lang/rust/pull/54870/
3612 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3613 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3614 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3615 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3616 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3617 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3618 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3619 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3620 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3621 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3622 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3623 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3624 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3625 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3626
3627 Version 1.30.1 (2018-11-08)
3628 ===========================
3629
3630 - [Fixed overflow ICE in rustdoc][54199]
3631 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3632
3633 [54199]: https://github.com/rust-lang/rust/pull/54199
3634 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3635
3636 Version 1.30.0 (2018-10-25)
3637 ==========================
3638
3639 Language
3640 --------
3641 - [Procedural macros are now available.][52081] These kinds of macros allow for
3642   more powerful code generation. There is a [new chapter available][proc-macros]
3643   in the Rust Programming Language book that goes further in depth.
3644 - [You can now use keywords as identifiers using the raw identifiers
3645   syntax (`r#`),][53236] e.g. `let r#for = true;`
3646 - [Using anonymous parameters in traits is now deprecated with a warning and
3647   will be a hard error in the 2018 edition.][53272]
3648 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3649   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3650 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3651   Previously, using a external crate in a module without a use statement
3652   required `let json = ::serde_json::from_str(foo);` but can now be written
3653   as `let json = serde_json::from_str(foo);`.
3654 - [You can now apply the `#[used]` attribute to static items to prevent the
3655   compiler from optimising them away, even if they appear to be unused,][51363]
3656   e.g. `#[used] static FOO: u32 = 1;`
3657 - [You can now import and reexport macros from other crates with the `use`
3658   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3659   the root module of the crate. If your macro relies on calling other local
3660   macros, it is recommended to export with the
3661   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3662   those macros.
3663 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3664   using the `vis` specifier.][53370]
3665 - [Non-macro attributes now allow all forms of literals, not just
3666   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3667   write `#[attr(true)]`.
3668 - [You can now specify a function to handle a panic in the Rust runtime with the
3669   `#[panic_handler]` attribute.][51366]
3670
3671 Compiler
3672 --------
3673 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3674 - [Added the `aarch64-unknown-netbsd` target][53165]
3675 - [Upgraded to LLVM 8.][53611]
3676
3677 Libraries
3678 ---------
3679 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3680
3681 Stabilized APIs
3682 ---------------
3683 - [`Ipv4Addr::BROADCAST`]
3684 - [`Ipv4Addr::LOCALHOST`]
3685 - [`Ipv4Addr::UNSPECIFIED`]
3686 - [`Ipv6Addr::LOCALHOST`]
3687 - [`Ipv6Addr::UNSPECIFIED`]
3688 - [`Iterator::find_map`]
3689
3690   The following methods are replacement methods for `trim_left`, `trim_right`,
3691   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3692   in 1.33.0:
3693 - [`str::trim_end_matches`]
3694 - [`str::trim_end`]
3695 - [`str::trim_start_matches`]
3696 - [`str::trim_start`]
3697
3698 Cargo
3699 ----
3700 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3701 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3702   equivalent to calling `rustdoc --error-format=json`.
3703 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3704
3705 Misc
3706 ----
3707 - [`rustdoc` allows you to specify what edition to treat your code as with the
3708   `--edition` option.][54057]
3709 - [`rustdoc` now has the `--color` (specify whether to output color) and
3710   `--error-format` (specify error format, e.g. `json`) options.][53003]
3711 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3712   debug symbols.][53774]
3713 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3714   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3715
3716 [50911]: https://github.com/rust-lang/rust/pull/50911/
3717 [51363]: https://github.com/rust-lang/rust/pull/51363/
3718 [51366]: https://github.com/rust-lang/rust/pull/51366/
3719 [52081]: https://github.com/rust-lang/rust/pull/52081/
3720 [53003]: https://github.com/rust-lang/rust/pull/53003/
3721 [53033]: https://github.com/rust-lang/rust/pull/53033/
3722 [53044]: https://github.com/rust-lang/rust/pull/53044/
3723 [53165]: https://github.com/rust-lang/rust/pull/53165/
3724 [53611]: https://github.com/rust-lang/rust/pull/53611/
3725 [53213]: https://github.com/rust-lang/rust/pull/53213/
3726 [53236]: https://github.com/rust-lang/rust/pull/53236/
3727 [53272]: https://github.com/rust-lang/rust/pull/53272/
3728 [53370]: https://github.com/rust-lang/rust/pull/53370/
3729 [53459]: https://github.com/rust-lang/rust/pull/53459/
3730 [53774]: https://github.com/rust-lang/rust/pull/53774/
3731 [53822]: https://github.com/rust-lang/rust/pull/53822/
3732 [54057]: https://github.com/rust-lang/rust/pull/54057/
3733 [54146]: https://github.com/rust-lang/rust/pull/54146/
3734 [54404]: https://github.com/rust-lang/rust/pull/54404/
3735 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3736 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3737 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3738 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3739
3740 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3741 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3742 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3743 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3744 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3745 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3746 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3747 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3748 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3749 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3750
3751
3752 Version 1.29.2 (2018-10-11)
3753 ===========================
3754
3755 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3756 - The `rls-preview` component on the windows-gnu targets has been restored.
3757
3758 [54639]: https://github.com/rust-lang/rust/pull/54639
3759
3760
3761 Version 1.29.1 (2018-09-25)
3762 ===========================
3763
3764 Security Notes
3765 --------------
3766
3767 - The standard library's `str::repeat` function contained an out of bounds write
3768   caused by an integer overflow. This has been fixed by deterministically
3769   panicking when an overflow happens.
3770
3771   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3772   us.
3773
3774
3775 Version 1.29.0 (2018-09-13)
3776 ==========================
3777
3778 Compiler
3779 --------
3780 - [Bumped minimum LLVM version to 5.0.][51899]
3781 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3782 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3783 - [Upgraded to LLVM 7.][51966]
3784
3785 Libraries
3786 ---------
3787 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3788 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3789 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3790 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3791   for `&str`.][51178]
3792 - [`Cell<T>` now allows `T` to be unsized.][50494]
3793 - [`SocketAddr` is now stable on Redox.][52656]
3794
3795 Stabilized APIs
3796 ---------------
3797 - [`Arc::downcast`]
3798 - [`Iterator::flatten`]
3799 - [`Rc::downcast`]
3800
3801 Cargo
3802 -----
3803 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3804   `--locked` to disable this behavior.
3805 - [`cargo-install` will now allow you to cross compile an install
3806   using `--target`.][cargo/5614]
3807 - [Added the `cargo-fix` subcommand to automatically move project code from
3808   2015 edition to 2018.][cargo/5723]
3809 - [`cargo doc` can now optionally document private types using the
3810   `--document-private-items` flag.][cargo/5543]
3811
3812 Misc
3813 ----
3814 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3815   the specified level to that level.][52354] For example `--cap-lints warn`
3816   will demote `deny` and `forbid` lints to `warn`.
3817 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3818   fails and `101` if there is a panic.][52197]
3819 - [A preview of clippy has been made available through rustup.][51122]
3820   You can install the preview with `rustup component add clippy-preview`.
3821
3822 Compatibility Notes
3823 -------------------
3824 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3825   Use `str::get_unchecked(begin..end)` instead.
3826 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3827   Consider using the `home_dir` function from
3828   https://crates.io/crates/dirs instead.
3829 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3830 - [`cfg` attributes and `--cfg` command line flags are now more
3831   strictly validated.][53893]
3832
3833 [53893]: https://github.com/rust-lang/rust/pull/53893/
3834 [52861]: https://github.com/rust-lang/rust/pull/52861/
3835 [51966]: https://github.com/rust-lang/rust/pull/51966/
3836 [52656]: https://github.com/rust-lang/rust/pull/52656/
3837 [52239]: https://github.com/rust-lang/rust/pull/52239/
3838 [52330]: https://github.com/rust-lang/rust/pull/52330/
3839 [52354]: https://github.com/rust-lang/rust/pull/52354/
3840 [52402]: https://github.com/rust-lang/rust/pull/52402/
3841 [52103]: https://github.com/rust-lang/rust/pull/52103/
3842 [52197]: https://github.com/rust-lang/rust/pull/52197/
3843 [51807]: https://github.com/rust-lang/rust/pull/51807/
3844 [51899]: https://github.com/rust-lang/rust/pull/51899/
3845 [51912]: https://github.com/rust-lang/rust/pull/51912/
3846 [51511]: https://github.com/rust-lang/rust/pull/51511/
3847 [51619]: https://github.com/rust-lang/rust/pull/51619/
3848 [51656]: https://github.com/rust-lang/rust/pull/51656/
3849 [51178]: https://github.com/rust-lang/rust/pull/51178/
3850 [51122]: https://github.com/rust-lang/rust/pull/51122
3851 [50494]: https://github.com/rust-lang/rust/pull/50494/
3852 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3853 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3854 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3855 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3856 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3857 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3858 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3859
3860
3861 Version 1.28.0 (2018-08-02)
3862 ===========================
3863
3864 Language
3865 --------
3866 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3867   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3868   the inner type across Foreign Function Interface (FFI) boundaries.
3869 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3870   and can now be used as identifiers.][51196]
3871 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3872   stable.][51241] This will allow users to specify a global allocator for
3873   their program.
3874 - [Unit test functions marked with the `#[test]` attribute can now return
3875   `Result<(), E: Debug>` in addition to `()`.][51298]
3876 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3877   allows macros to easily target lifetimes.
3878
3879 Compiler
3880 --------
3881 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3882   prioritise making smaller binary sizes. `z` is the same as `s` with the
3883   exception that it does not vectorise loops, which typically results in an even
3884   smaller binary.
3885 - [The short error format is now stable.][49546] Specified with
3886   `--error-format=short` this option will provide a more compressed output of
3887   rust error messages.
3888 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3889 - [Reduced the number of allocations in the macro parser.][50855] This can
3890   improve compile times of macro heavy crates on average by 5%.
3891
3892 Libraries
3893 ---------
3894 - [Implemented `Default` for `&mut str`.][51306]
3895 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3896 - [Implemented `Extend` for `()`.][50234]
3897 - [The `Debug` implementation of `time::Duration` should now be more easily
3898   human readable.][50364] Previously a `Duration` of one second would printed as
3899   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3900 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3901   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3902   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3903   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3904   for `PathBuf`.][50170]
3905 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3906   and `Wrapping<i128>`.][50465]
3907 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3908   possible.][51050] This can provide up to a 40% speed increase.
3909 - [Improved error messages when using `format!`.][50610]
3910
3911 Stabilized APIs
3912 ---------------
3913 - [`Iterator::step_by`]
3914 - [`Path::ancestors`]
3915 - [`SystemTime::UNIX_EPOCH`]
3916 - [`alloc::GlobalAlloc`]
3917 - [`alloc::Layout`]
3918 - [`alloc::LayoutErr`]
3919 - [`alloc::System`]
3920 - [`alloc::alloc`]
3921 - [`alloc::alloc_zeroed`]
3922 - [`alloc::dealloc`]
3923 - [`alloc::realloc`]
3924 - [`alloc::handle_alloc_error`]
3925 - [`btree_map::Entry::or_default`]
3926 - [`fmt::Alignment`]
3927 - [`hash_map::Entry::or_default`]
3928 - [`iter::repeat_with`]
3929 - [`num::NonZeroUsize`]
3930 - [`num::NonZeroU128`]
3931 - [`num::NonZeroU16`]
3932 - [`num::NonZeroU32`]
3933 - [`num::NonZeroU64`]
3934 - [`num::NonZeroU8`]
3935 - [`ops::RangeBounds`]
3936 - [`slice::SliceIndex`]
3937 - [`slice::from_mut`]
3938 - [`slice::from_ref`]
3939 - [`{Any + Send + Sync}::downcast_mut`]
3940 - [`{Any + Send + Sync}::downcast_ref`]
3941 - [`{Any + Send + Sync}::is`]
3942
3943 Cargo
3944 -----
3945 - [Cargo will now no longer allow you to publish crates with build scripts that
3946   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3947   considered to be immutable.
3948
3949 Misc
3950 ----
3951 - [The `suggestion_applicability` field in `rustc`'s json output is now
3952   stable.][50486] This will allow dev tools to check whether a code suggestion
3953   would apply to them.
3954
3955 Compatibility Notes
3956 -------------------
3957 - [Rust will consider trait objects with duplicated constraints to be the same
3958   type as without the duplicated constraint.][51276] For example the below code will
3959   now fail to compile.
3960   ```rust
3961   trait Trait {}
3962
3963   impl Trait + Send {
3964       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3965   }
3966
3967   impl Trait + Send + Send {
3968       fn test(&self) { println!("two"); }
3969   }
3970   ```
3971
3972 [49546]: https://github.com/rust-lang/rust/pull/49546/
3973 [50143]: https://github.com/rust-lang/rust/pull/50143/
3974 [50170]: https://github.com/rust-lang/rust/pull/50170/
3975 [50234]: https://github.com/rust-lang/rust/pull/50234/
3976 [50265]: https://github.com/rust-lang/rust/pull/50265/
3977 [50364]: https://github.com/rust-lang/rust/pull/50364/
3978 [50385]: https://github.com/rust-lang/rust/pull/50385/
3979 [50465]: https://github.com/rust-lang/rust/pull/50465/
3980 [50486]: https://github.com/rust-lang/rust/pull/50486/
3981 [50554]: https://github.com/rust-lang/rust/pull/50554/
3982 [50610]: https://github.com/rust-lang/rust/pull/50610/
3983 [50855]: https://github.com/rust-lang/rust/pull/50855/
3984 [51050]: https://github.com/rust-lang/rust/pull/51050/
3985 [51196]: https://github.com/rust-lang/rust/pull/51196/
3986 [51200]: https://github.com/rust-lang/rust/pull/51200/
3987 [51241]: https://github.com/rust-lang/rust/pull/51241/
3988 [51276]: https://github.com/rust-lang/rust/pull/51276/
3989 [51298]: https://github.com/rust-lang/rust/pull/51298/
3990 [51306]: https://github.com/rust-lang/rust/pull/51306/
3991 [51562]: https://github.com/rust-lang/rust/pull/51562/
3992 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3993 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3994 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3995 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3996 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3997 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3998 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3999 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
4000 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
4001 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
4002 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
4003 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
4004 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
4005 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
4006 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
4007 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
4008 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
4009 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
4010 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
4011 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
4012 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
4013 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
4014 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
4015 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
4016 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
4017 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
4018 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
4019 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
4020 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
4021 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
4022
4023 Version 1.27.2 (2018-07-20)
4024 ===========================
4025
4026 Compatibility Notes
4027 -------------------
4028
4029 - The borrow checker was fixed to avoid potential unsoundness when using
4030   match ergonomics: [#52213][52213].
4031
4032 [52213]: https://github.com/rust-lang/rust/issues/52213
4033
4034 Version 1.27.1 (2018-07-10)
4035 ===========================
4036
4037 Security Notes
4038 --------------
4039
4040 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
4041   when running, which enabled executing code as some other user on a
4042   given machine. This release fixes that vulnerability; you can read
4043   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
4044
4045   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
4046
4047 Compatibility Notes
4048 -------------------
4049
4050 - The borrow checker was fixed to avoid an additional potential unsoundness when using
4051   match ergonomics: [#51415][51415], [#49534][49534].
4052
4053 [51415]: https://github.com/rust-lang/rust/issues/51415
4054 [49534]: https://github.com/rust-lang/rust/issues/49534
4055 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
4056 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
4057
4058 Version 1.27.0 (2018-06-21)
4059 ==========================
4060
4061 Language
4062 --------
4063 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
4064   be used as an identifier.
4065 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
4066   bare `Trait` syntax, and should make it clearer when being used in tandem with
4067   `impl Trait` because it is equivalent to the following syntax:
4068   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
4069   `Box<Trait> == Box<dyn Trait>`.
4070 - [Attributes on generic parameters such as types and lifetimes are
4071   now stable.][48851] e.g.
4072   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
4073 - [The `#[must_use]` attribute can now also be used on functions as well as
4074   types.][48925] It provides a lint that by default warns users when the
4075   value returned by a function has not been used.
4076
4077 Compiler
4078 --------
4079 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
4080
4081 Libraries
4082 ---------
4083 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
4084   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
4085   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
4086   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
4087   the `cfg` attribute.
4088 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
4089   std are now available in core.][49896]
4090 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
4091   to `Self`.][49630]
4092 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
4093   that the operation isn't done in place.
4094 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
4095   the `#[must_use]` attribute][49533] to warn about unused potentially
4096   expensive allocations.
4097
4098 Stabilized APIs
4099 ---------------
4100 - [`DoubleEndedIterator::rfind`]
4101 - [`DoubleEndedIterator::rfold`]
4102 - [`DoubleEndedIterator::try_rfold`]
4103 - [`Duration::from_micros`]
4104 - [`Duration::from_nanos`]
4105 - [`Duration::subsec_micros`]
4106 - [`Duration::subsec_millis`]
4107 - [`HashMap::remove_entry`]
4108 - [`Iterator::try_fold`]
4109 - [`Iterator::try_for_each`]
4110 - [`NonNull::cast`]
4111 - [`Option::filter`]
4112 - [`String::replace_range`]
4113 - [`Take::set_limit`]
4114 - [`hint::unreachable_unchecked`]
4115 - [`os::unix::process::parent_id`]
4116 - [`ptr::swap_nonoverlapping`]
4117 - [`slice::rsplit_mut`]
4118 - [`slice::rsplit`]
4119 - [`slice::swap_with_slice`]
4120
4121 Cargo
4122 -----
4123 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
4124   `readme`, and `repository` fields.][cargo/5386]
4125 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
4126 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
4127   a different directory than `target` for placing compilation artifacts.
4128 - [Cargo will be adding automatic target inference for binaries, benchmarks,
4129   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
4130   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
4131   where cargo would infer a binary, Cargo will produce a warning. You can
4132   disable this feature ahead of time by setting any of the following to false:
4133   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4134 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4135   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4136
4137 Misc
4138 ----
4139 - [Added “The Rustc book” into the official documentation.][49707]
4140   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4141 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4142
4143 Compatibility Notes
4144 -------------------
4145 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4146   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4147   compile, `"".is_empty()` will still compile.
4148 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4149   will only print the inner type.][48553] E.g.
4150   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4151   not `AtomicBool(true)`.
4152 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4153   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4154   alignment should cover all use cases.
4155 - The `.description()` method on the `std::error::Error` trait
4156   [has been soft-deprecated][50163]. It is no longer required to implement it.
4157
4158 [48553]: https://github.com/rust-lang/rust/pull/48553/
4159 [48851]: https://github.com/rust-lang/rust/pull/48851/
4160 [48925]: https://github.com/rust-lang/rust/pull/48925/
4161 [49533]: https://github.com/rust-lang/rust/pull/49533/
4162 [49623]: https://github.com/rust-lang/rust/pull/49623/
4163 [49630]: https://github.com/rust-lang/rust/pull/49630/
4164 [49664]: https://github.com/rust-lang/rust/pull/49664/
4165 [49699]: https://github.com/rust-lang/rust/pull/49699/
4166 [49707]: https://github.com/rust-lang/rust/pull/49707/
4167 [49719]: https://github.com/rust-lang/rust/pull/49719/
4168 [49896]: https://github.com/rust-lang/rust/pull/49896/
4169 [49968]: https://github.com/rust-lang/rust/pull/49968/
4170 [50163]: https://github.com/rust-lang/rust/pull/50163
4171 [50177]: https://github.com/rust-lang/rust/pull/50177/
4172 [50378]: https://github.com/rust-lang/rust/pull/50378/
4173 [50398]: https://github.com/rust-lang/rust/pull/50398/
4174 [50423]: https://github.com/rust-lang/rust/pull/50423/
4175 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4176 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4177 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4178 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4179 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4180 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4181 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4182 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4183 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4184 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4185 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4186 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4187 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4188 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4189 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4190 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4191 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4192 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4193 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4194 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4195 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4196 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4197 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4198 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4199 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4200 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4201 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4202 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4203 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4204 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4205
4206
4207 Version 1.26.2 (2018-06-05)
4208 ==========================
4209
4210 Compatibility Notes
4211 -------------------
4212
4213 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4214
4215 [51117]: https://github.com/rust-lang/rust/issues/51117
4216
4217
4218 Version 1.26.1 (2018-05-29)
4219 ==========================
4220
4221 Tools
4222 -----
4223
4224 - [RLS now works on Windows.][50646]
4225 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4226
4227
4228 Compatibility Notes
4229 --------
4230
4231 - [`fn main() -> impl Trait` no longer works for non-Termination
4232   trait.][50656]
4233   This reverts an accidental stabilization.
4234 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4235 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4236
4237 [50646]: https://github.com/rust-lang/rust/issues/50646
4238 [50656]: https://github.com/rust-lang/rust/pull/50656
4239 [50812]: https://github.com/rust-lang/rust/pull/50812
4240 [50950]: https://github.com/rust-lang/rust/issues/50950
4241 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4242
4243 Version 1.26.0 (2018-05-10)
4244 ==========================
4245
4246 Language
4247 --------
4248 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4249   implement either or both traits.][49299]
4250 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4251 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4252   lifetime can be elided.][49458]
4253 - [`impl Trait` is now stable allowing you to have abstract types in returns
4254    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4255   `fn open(path: impl AsRef<Path>)`.
4256 - [Pattern matching will now automatically apply dereferences.][49394]
4257 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4258 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4259 - [A lot of operations are now available in a const context.][46882] E.g. You
4260   can now index into constant arrays, reference and dereference into constants,
4261   and use tuple struct constructors.
4262 - [Fixed entry slice patterns are now stable.][48516] E.g.
4263   ```rust
4264   let points = [1, 2, 3, 4];
4265   match points {
4266       [1, 2, 3, 4] => println!("All points were sequential."),
4267       _ => println!("Not all points were sequential."),
4268   }
4269   ```
4270
4271
4272 Compiler
4273 --------
4274 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4275 - [Fixed exponential projection complexity on nested types.][48296]
4276   This can provide up to a ~12% reduction in compile times for certain crates.
4277 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4278   to remap path prefixes outputted by the compiler.
4279 - [Added `powerpc-unknown-netbsd` target.][48281]
4280
4281 Libraries
4282 ---------
4283 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4284 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4285   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4286 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4287 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4288 - [`ascii::escape_default` is now available in libcore.][48735]
4289 - [Trailing commas are now supported in std and core macros.][48056]
4290 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4291 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4292
4293 Stabilized APIs
4294 ---------------
4295 - [`*const T::add`]
4296 - [`*const T::copy_to_nonoverlapping`]
4297 - [`*const T::copy_to`]
4298 - [`*const T::read_unaligned`]
4299 - [`*const T::read_volatile`]
4300 - [`*const T::read`]
4301 - [`*const T::sub`]
4302 - [`*const T::wrapping_add`]
4303 - [`*const T::wrapping_sub`]
4304 - [`*mut T::add`]
4305 - [`*mut T::copy_to_nonoverlapping`]
4306 - [`*mut T::copy_to`]
4307 - [`*mut T::read_unaligned`]
4308 - [`*mut T::read_volatile`]
4309 - [`*mut T::read`]
4310 - [`*mut T::replace`]
4311 - [`*mut T::sub`]
4312 - [`*mut T::swap`]
4313 - [`*mut T::wrapping_add`]
4314 - [`*mut T::wrapping_sub`]
4315 - [`*mut T::write_bytes`]
4316 - [`*mut T::write_unaligned`]
4317 - [`*mut T::write_volatile`]
4318 - [`*mut T::write`]
4319 - [`Box::leak`]
4320 - [`FromUtf8Error::as_bytes`]
4321 - [`LocalKey::try_with`]
4322 - [`Option::cloned`]
4323 - [`btree_map::Entry::and_modify`]
4324 - [`fs::read_to_string`]
4325 - [`fs::read`]
4326 - [`fs::write`]
4327 - [`hash_map::Entry::and_modify`]
4328 - [`iter::FusedIterator`]
4329 - [`ops::RangeInclusive`]
4330 - [`ops::RangeToInclusive`]
4331 - [`process::id`]
4332 - [`slice::rotate_left`]
4333 - [`slice::rotate_right`]
4334 - [`String::retain`]
4335
4336
4337 Cargo
4338 -----
4339 - [Cargo will now output path to custom commands when `-v` is
4340   passed with `--list`][cargo/5041]
4341 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4342
4343 Misc
4344 ----
4345 - [The second edition of "The Rust Programming Language" book is now recommended
4346   over the first.][48404]
4347
4348 Compatibility Notes
4349 -------------------
4350
4351 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4352   syntax is now invalid.
4353   ```
4354   use std::ops::Fn as dyn;
4355   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4356   ```
4357 - [The result of dereferences are no longer promoted to `'static`.][47408]
4358   e.g.
4359   ```rust
4360   fn main() {
4361       const PAIR: &(i32, i32) = &(0, 1);
4362       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4363   }
4364   ```
4365 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4366 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4367   an error.][48235]
4368 - [Removed hoedown from rustdoc.][48274]
4369 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4370
4371 [46882]: https://github.com/rust-lang/rust/pull/46882
4372 [47379]: https://github.com/rust-lang/rust/pull/47379
4373 [47408]: https://github.com/rust-lang/rust/pull/47408
4374 [47813]: https://github.com/rust-lang/rust/pull/47813
4375 [48056]: https://github.com/rust-lang/rust/pull/48056
4376 [48125]: https://github.com/rust-lang/rust/pull/48125
4377 [48166]: https://github.com/rust-lang/rust/pull/48166
4378 [48235]: https://github.com/rust-lang/rust/pull/48235
4379 [48274]: https://github.com/rust-lang/rust/pull/48274
4380 [48281]: https://github.com/rust-lang/rust/pull/48281
4381 [48296]: https://github.com/rust-lang/rust/pull/48296
4382 [48326]: https://github.com/rust-lang/rust/pull/48326
4383 [48359]: https://github.com/rust-lang/rust/pull/48359
4384 [48404]: https://github.com/rust-lang/rust/pull/48404
4385 [48481]: https://github.com/rust-lang/rust/pull/48481
4386 [48516]: https://github.com/rust-lang/rust/pull/48516
4387 [48628]: https://github.com/rust-lang/rust/pull/48628
4388 [48629]: https://github.com/rust-lang/rust/pull/48629
4389 [48657]: https://github.com/rust-lang/rust/pull/48657
4390 [48735]: https://github.com/rust-lang/rust/pull/48735
4391 [48978]: https://github.com/rust-lang/rust/pull/48978
4392 [49101]: https://github.com/rust-lang/rust/pull/49101
4393 [49109]: https://github.com/rust-lang/rust/pull/49109
4394 [49121]: https://github.com/rust-lang/rust/pull/49121
4395 [49162]: https://github.com/rust-lang/rust/pull/49162
4396 [49184]: https://github.com/rust-lang/rust/pull/49184
4397 [49234]: https://github.com/rust-lang/rust/pull/49234
4398 [49255]: https://github.com/rust-lang/rust/pull/49255
4399 [49299]: https://github.com/rust-lang/rust/pull/49299
4400 [49305]: https://github.com/rust-lang/rust/pull/49305
4401 [49394]: https://github.com/rust-lang/rust/pull/49394
4402 [49458]: https://github.com/rust-lang/rust/pull/49458
4403 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4404 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4405 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4406 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4407 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4408 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4409 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4410 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4411 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4412 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4413 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4414 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4415 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4416 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4417 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4418 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4419 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4420 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4421 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4422 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4423 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4424 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4425 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4426 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4427 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4428 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4429 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4430 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4431 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4432 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4433 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4434 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4435 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4436 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4437 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4438 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4439 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4440 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4441 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4442 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4443 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4444 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4445
4446
4447 Version 1.25.0 (2018-03-29)
4448 ==========================
4449
4450 Language
4451 --------
4452 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4453 - [You can now use nested groups of imports.][47948]
4454   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4455 - [You can now have `|` at the start of a match arm.][47947] e.g.
4456 ```rust
4457 enum Foo { A, B, C }
4458
4459 fn main() {
4460     let x = Foo::A;
4461     match x {
4462         | Foo::A
4463         | Foo::B => println!("AB"),
4464         | Foo::C => println!("C"),
4465     }
4466 }
4467 ```
4468
4469 Compiler
4470 --------
4471 - [Upgraded to LLVM 6.][47828]
4472 - [Added `-C lto=val` option.][47521]
4473 - [Added `i586-unknown-linux-musl` target][47282]
4474
4475 Libraries
4476 ---------
4477 - [Impl Send for `process::Command` on Unix.][47760]
4478 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4479 - [`UnsafeCell::into_inner` is now safe.][47204]
4480 - [Implement libstd for CloudABI.][47268]
4481 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4482 - [Implement `AsRef<Path>` for Component][46985]
4483 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4484 - [Moved `Duration` to libcore.][46666]
4485
4486 Stabilized APIs
4487 ---------------
4488 - [`Location::column`]
4489 - [`ptr::NonNull`]
4490
4491 The following functions can now be used in a constant expression.
4492 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4493 - [`Duration::new`][47300]
4494 - [`Duration::from_secs`][47300]
4495 - [`Duration::from_millis`][47300]
4496
4497 Cargo
4498 -----
4499 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4500 - [`cargo new` now defaults to creating a binary crate, instead of a
4501   library crate.][cargo/5029]
4502
4503 Misc
4504 ----
4505 - [Rust by example is now shipped with new releases][46196]
4506
4507 Compatibility Notes
4508 -------------------
4509 - [Deprecated `net::lookup_host`.][47510]
4510 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4511 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4512   around indexing operations (see [#47349][47349]). This has been fixed (which also
4513   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4514 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4515
4516 [33903]: https://github.com/rust-lang/rust/pull/33903
4517 [47947]: https://github.com/rust-lang/rust/pull/47947
4518 [47948]: https://github.com/rust-lang/rust/pull/47948
4519 [47760]: https://github.com/rust-lang/rust/pull/47760
4520 [47790]: https://github.com/rust-lang/rust/pull/47790
4521 [47828]: https://github.com/rust-lang/rust/pull/47828
4522 [47398]: https://github.com/rust-lang/rust/pull/47398
4523 [47510]: https://github.com/rust-lang/rust/pull/47510
4524 [47521]: https://github.com/rust-lang/rust/pull/47521
4525 [47204]: https://github.com/rust-lang/rust/pull/47204
4526 [47251]: https://github.com/rust-lang/rust/pull/47251
4527 [47268]: https://github.com/rust-lang/rust/pull/47268
4528 [47282]: https://github.com/rust-lang/rust/pull/47282
4529 [47300]: https://github.com/rust-lang/rust/pull/47300
4530 [47349]: https://github.com/rust-lang/rust/pull/47349
4531 [46931]: https://github.com/rust-lang/rust/pull/46931
4532 [46985]: https://github.com/rust-lang/rust/pull/46985
4533 [47006]: https://github.com/rust-lang/rust/pull/47006
4534 [46830]: https://github.com/rust-lang/rust/pull/46830
4535 [46095]: https://github.com/rust-lang/rust/pull/46095
4536 [46666]: https://github.com/rust-lang/rust/pull/46666
4537 [46196]: https://github.com/rust-lang/rust/pull/46196
4538 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4539 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4540 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4541 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4542 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4543
4544
4545 Version 1.24.1 (2018-03-01)
4546 ==========================
4547
4548  - [Do not abort when unwinding through FFI][48251]
4549  - [Emit UTF-16 files for linker arguments on Windows][48318]
4550  - [Make the error index generator work again][48308]
4551  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4552
4553 [48251]: https://github.com/rust-lang/rust/issues/48251
4554 [48308]: https://github.com/rust-lang/rust/issues/48308
4555 [48318]: https://github.com/rust-lang/rust/issues/48318
4556 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4557
4558
4559 Version 1.24.0 (2018-02-15)
4560 ==========================
4561
4562 Language
4563 --------
4564 - [External `sysv64` ffi is now available.][46528]
4565   eg. `extern "sysv64" fn foo () {}`
4566
4567 Compiler
4568 --------
4569 - [rustc now uses 16 codegen units by default for release builds.][46910]
4570   For the fastest builds, utilize `codegen-units=1`.
4571 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4572 - [Add `aarch64-unknown-openbsd` support][46760]
4573
4574 Libraries
4575 ---------
4576 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4577   improvement in performance in the majority of cases.
4578 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4579   with Windows.][46798]
4580 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4581 - [impl `From<bool>` for `AtomicBool`][46293]
4582 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4583 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4584 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4585 - [float::from_bits now just uses transmute.][46012] This provides
4586   some optimisations from LLVM.
4587 - [Copied `AsciiExt` methods onto `char`][46077]
4588 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4589 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4590 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4591 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4592
4593 Stabilized APIs
4594 ---------------
4595 - [`RefCell::replace`]
4596 - [`RefCell::swap`]
4597 - [`atomic::spin_loop_hint`]
4598
4599 The following functions can now be used in a constant expression.
4600 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4601
4602 - [`AtomicBool::new`][46287]
4603 - [`AtomicUsize::new`][46287]
4604 - [`AtomicIsize::new`][46287]
4605 - [`AtomicPtr::new`][46287]
4606 - [`Cell::new`][46287]
4607 - [`{integer}::min_value`][46287]
4608 - [`{integer}::max_value`][46287]
4609 - [`mem::size_of`][46287]
4610 - [`mem::align_of`][46287]
4611 - [`ptr::null`][46287]
4612 - [`ptr::null_mut`][46287]
4613 - [`RefCell::new`][46287]
4614 - [`UnsafeCell::new`][46287]
4615
4616 Cargo
4617 -----
4618 - [Added a `workspace.default-members` config that
4619   overrides implied `--all` in virtual workspaces.][cargo/4743]
4620 - [Enable incremental by default on development builds.][cargo/4817] Also added
4621   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4622   per-project or global basis respectively.
4623
4624 Misc
4625 ----
4626
4627 Compatibility Notes
4628 -------------------
4629 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4630 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4631   in accordance with IETF RFC 4291 §2.2.
4632 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4633 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4634   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4635 - [Leading zeros in tuple struct members is now an error][47084]
4636 - [`column!()` macro is one-based instead of zero-based][46977]
4637 - [`fmt::Arguments` can no longer be shared across threads][45198]
4638 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4639 - [Cargo sets a different working directory for the compiler][cargo/4788]
4640
4641 [44884]: https://github.com/rust-lang/rust/pull/44884
4642 [45198]: https://github.com/rust-lang/rust/pull/45198
4643 [45506]: https://github.com/rust-lang/rust/pull/45506
4644 [45904]: https://github.com/rust-lang/rust/pull/45904
4645 [45990]: https://github.com/rust-lang/rust/pull/45990
4646 [46012]: https://github.com/rust-lang/rust/pull/46012
4647 [46077]: https://github.com/rust-lang/rust/pull/46077
4648 [46094]: https://github.com/rust-lang/rust/pull/46094
4649 [46284]: https://github.com/rust-lang/rust/pull/46284
4650 [46287]: https://github.com/rust-lang/rust/pull/46287
4651 [46293]: https://github.com/rust-lang/rust/pull/46293
4652 [46528]: https://github.com/rust-lang/rust/pull/46528
4653 [46671]: https://github.com/rust-lang/rust/pull/46671
4654 [46713]: https://github.com/rust-lang/rust/pull/46713
4655 [46735]: https://github.com/rust-lang/rust/pull/46735
4656 [46749]: https://github.com/rust-lang/rust/pull/46749
4657 [46760]: https://github.com/rust-lang/rust/pull/46760
4658 [46798]: https://github.com/rust-lang/rust/pull/46798
4659 [46828]: https://github.com/rust-lang/rust/pull/46828
4660 [46831]: https://github.com/rust-lang/rust/pull/46831
4661 [46833]: https://github.com/rust-lang/rust/pull/46833
4662 [46910]: https://github.com/rust-lang/rust/pull/46910
4663 [46977]: https://github.com/rust-lang/rust/pull/46977
4664 [47018]: https://github.com/rust-lang/rust/pull/47018
4665 [47080]: https://github.com/rust-lang/rust/pull/47080
4666 [47084]: https://github.com/rust-lang/rust/pull/47084
4667 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4668 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4669 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4670 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4671 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4672 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4673
4674
4675 Version 1.23.0 (2018-01-04)
4676 ==========================
4677
4678 Language
4679 --------
4680 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4681 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4682   Which should fix some confusing errors in some operations.
4683
4684 Compiler
4685 --------
4686 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4687   undefined behavior.][45920]
4688 - [rustc now suggests renaming import if names clash.][45660]
4689 - [Display errors/warnings correctly when there are zero-width or
4690   wide characters.][45711]
4691 - [rustc now avoids unnecessary copies of arguments that are
4692   simple bindings][45380] This should improve memory usage on average by 5-10%.
4693 - [Updated musl used to build musl rustc to 1.1.17][45393]
4694
4695 Libraries
4696 ---------
4697 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4698 - [Implement Hash for raw pointers to unsized types][45483]
4699 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4700 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4701 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4702 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4703   and `<*mut T>::as_mut`][44932]
4704 - [Optimized `Thread::{park, unpark}` implementation][45524]
4705 - [Improved `SliceExt::binary_search` performance.][45333]
4706 - [impl `FromIterator<()>` for `()`][45379]
4707 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4708   is now deprecated.
4709
4710 Stabilized APIs
4711 ---------------
4712
4713 Cargo
4714 -----
4715 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4716   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4717 - [Added unit test checking to `cargo check`][cargo/4592]
4718 - [Cargo now lets you install a specific version
4719   using `cargo install --version`][cargo/4637]
4720
4721 Misc
4722 ----
4723 - [Releases now ship with the Cargo book documentation.][45692]
4724 - [rustdoc now prints rendering warnings on every run.][45324]
4725
4726 Compatibility Notes
4727 -------------------
4728 - [Changes have been made to type equality to make it more correct,
4729   in rare cases this could break some code.][45853] [Tracking issue for
4730   further information][45852]
4731 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4732 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4733   Android 9, the minimum supported version is Android 14.
4734 - [Bumped the minimum LLVM to 3.9][45326]
4735
4736 [44042]: https://github.com/rust-lang/rust/pull/44042
4737 [44932]: https://github.com/rust-lang/rust/pull/44932
4738 [45267]: https://github.com/rust-lang/rust/pull/45267
4739 [45324]: https://github.com/rust-lang/rust/pull/45324
4740 [45326]: https://github.com/rust-lang/rust/pull/45326
4741 [45333]: https://github.com/rust-lang/rust/pull/45333
4742 [45379]: https://github.com/rust-lang/rust/pull/45379
4743 [45380]: https://github.com/rust-lang/rust/pull/45380
4744 [45393]: https://github.com/rust-lang/rust/pull/45393
4745 [45435]: https://github.com/rust-lang/rust/pull/45435
4746 [45483]: https://github.com/rust-lang/rust/pull/45483
4747 [45524]: https://github.com/rust-lang/rust/pull/45524
4748 [45571]: https://github.com/rust-lang/rust/pull/45571
4749 [45580]: https://github.com/rust-lang/rust/pull/45580
4750 [45610]: https://github.com/rust-lang/rust/pull/45610
4751 [45660]: https://github.com/rust-lang/rust/pull/45660
4752 [45692]: https://github.com/rust-lang/rust/pull/45692
4753 [45711]: https://github.com/rust-lang/rust/pull/45711
4754 [45772]: https://github.com/rust-lang/rust/pull/45772
4755 [45852]: https://github.com/rust-lang/rust/issues/45852
4756 [45853]: https://github.com/rust-lang/rust/pull/45853
4757 [45887]: https://github.com/rust-lang/rust/pull/45887
4758 [45920]: https://github.com/rust-lang/rust/pull/45920
4759 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4760 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4761 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4762
4763
4764 Version 1.22.1 (2017-11-22)
4765 ==========================
4766
4767 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4768
4769 [46183]: https://github.com/rust-lang/rust/pull/46183
4770
4771 Version 1.22.0 (2017-11-22)
4772 ==========================
4773
4774 Language
4775 --------
4776 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4777 - [Now accepts underscores in unicode escapes][43716]
4778 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4779 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4780
4781 Compiler
4782 --------
4783 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4784 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4785   This should decrease compile times for debug builds.
4786 - [strict memory alignment now enabled on ARMv6][45094]
4787 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4788
4789 Libraries
4790 ---------
4791 - [Allow atomic operations up to 32 bits
4792   on `armv5te_unknown_linux_gnueabi`][44978]
4793 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4794 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4795 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4796 - [Properly detect overflow in `Instant += Duration`.][44220]
4797 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4798 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4799 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4800
4801 Stabilized APIs
4802 ---------------
4803
4804 Cargo
4805 -----
4806 - [Cargo will now build multi file examples in subdirectories of the `examples`
4807   folder that have a `main.rs` file.][cargo/4496]
4808 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4809   the old format will continue to work and can be updated with `cargo update`.
4810 - [Now supports vendoring git repositories][cargo/3992]
4811
4812 Misc
4813 ----
4814 - [`libbacktrace` is now available on Apple platforms.][44251]
4815 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4816   This now lets you specify that a given code example will fail to compile.
4817
4818 Compatibility Notes
4819 -------------------
4820 - [The minimum Android version that rustc can build for has been bumped
4821   to `4.0` from `2.3`][45656]
4822 - [Allowing `T op= &T` for numeric types has broken some type
4823   inference cases][45480]
4824
4825
4826 [42526]: https://github.com/rust-lang/rust/pull/42526
4827 [43017]: https://github.com/rust-lang/rust/pull/43017
4828 [43716]: https://github.com/rust-lang/rust/pull/43716
4829 [43949]: https://github.com/rust-lang/rust/pull/43949
4830 [44015]: https://github.com/rust-lang/rust/pull/44015
4831 [44220]: https://github.com/rust-lang/rust/pull/44220
4832 [44251]: https://github.com/rust-lang/rust/pull/44251
4833 [44287]: https://github.com/rust-lang/rust/pull/44287
4834 [44303]: https://github.com/rust-lang/rust/pull/44303
4835 [44456]: https://github.com/rust-lang/rust/pull/44456
4836 [44466]: https://github.com/rust-lang/rust/pull/44466
4837 [44895]: https://github.com/rust-lang/rust/pull/44895
4838 [44966]: https://github.com/rust-lang/rust/pull/44966
4839 [44978]: https://github.com/rust-lang/rust/pull/44978
4840 [45041]: https://github.com/rust-lang/rust/pull/45041
4841 [45064]: https://github.com/rust-lang/rust/pull/45064
4842 [45075]: https://github.com/rust-lang/rust/pull/45075
4843 [45094]: https://github.com/rust-lang/rust/pull/45094
4844 [45095]: https://github.com/rust-lang/rust/pull/45095
4845 [45480]: https://github.com/rust-lang/rust/issues/45480
4846 [45656]: https://github.com/rust-lang/rust/pull/45656
4847 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4848 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4849 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4850
4851
4852
4853
4854
4855
4856 Version 1.21.0 (2017-10-12)
4857 ==========================
4858
4859 Language
4860 --------
4861 - [You can now use static references for literals.][43838]
4862   Example:
4863   ```rust
4864   fn main() {
4865       let x: &'static u32 = &0;
4866   }
4867   ```
4868 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4869   Example:
4870   ```rust
4871   my_macro!(Vec<i32>::new); // Always worked
4872   my_macro!(Vec::<i32>::new); // Now works
4873   ```
4874
4875 Compiler
4876 --------
4877 - [Upgraded jemalloc to 4.5.0][43911]
4878 - [Enabled unwinding panics on Redox][43917]
4879 - [Now runs LLVM in parallel during translation phase.][43506]
4880   This should reduce peak memory usage.
4881
4882 Libraries
4883 ---------
4884 - [Generate builtin impls for `Clone` for all arrays and tuples that
4885   are `T: Clone`][43690]
4886 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4887 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4888   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4889
4890 Stabilized APIs
4891 ---------------
4892
4893 [`std::mem::discriminant`]
4894
4895 Cargo
4896 -----
4897 - [You can now call `cargo install` with multiple package names][cargo/4216]
4898 - [Cargo commands inside a virtual workspace will now implicitly
4899   pass `--all`][cargo/4335]
4900 - [Added a `[patch]` section to `Cargo.toml` to handle
4901   prepublication dependencies][cargo/4123] [RFC 1969]
4902 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4903   like patterns][cargo/4270]
4904 - [Added the `--all-targets` option][cargo/4400]
4905 - [Using required dependencies as a feature is now deprecated and emits
4906   a warning][cargo/4364]
4907
4908
4909 Misc
4910 ----
4911 - [Cargo docs are moving][43916]
4912   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4913 - [The rustdoc book is now available][43863]
4914   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4915 - [Added a preview of RLS has been made available through rustup][44204]
4916   Install with `rustup component add rls-preview`
4917 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4918   Previously only showed `std::os::unix`.
4919
4920 Compatibility Notes
4921 -------------------
4922 - [Changes in method matching against higher-ranked types][43880] This may cause
4923   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4924 - [rustc's JSON error output's byte position start at top of file.][42973]
4925   Was previously relative to the rustc's internal `CodeMap` struct which
4926   required the unstable library `libsyntax` to correctly use.
4927 - [`unused_results` lint no longer ignores booleans][43728]
4928
4929 [42565]: https://github.com/rust-lang/rust/pull/42565
4930 [42973]: https://github.com/rust-lang/rust/pull/42973
4931 [43348]: https://github.com/rust-lang/rust/pull/43348
4932 [43459]: https://github.com/rust-lang/rust/pull/43459
4933 [43506]: https://github.com/rust-lang/rust/pull/43506
4934 [43540]: https://github.com/rust-lang/rust/pull/43540
4935 [43690]: https://github.com/rust-lang/rust/pull/43690
4936 [43728]: https://github.com/rust-lang/rust/pull/43728
4937 [43838]: https://github.com/rust-lang/rust/pull/43838
4938 [43863]: https://github.com/rust-lang/rust/pull/43863
4939 [43880]: https://github.com/rust-lang/rust/pull/43880
4940 [43911]: https://github.com/rust-lang/rust/pull/43911
4941 [43916]: https://github.com/rust-lang/rust/pull/43916
4942 [43917]: https://github.com/rust-lang/rust/pull/43917
4943 [44204]: https://github.com/rust-lang/rust/pull/44204
4944 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4945 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4946 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4947 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4948 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4949 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4950 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4951 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4952 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4953
4954 Version 1.20.0 (2017-08-31)
4955 ===========================
4956
4957 Language
4958 --------
4959 - [Associated constants are now stabilised.][42809]
4960 - [A lot of macro bugs are now fixed.][42913]
4961
4962 Compiler
4963 --------
4964
4965 - [Struct fields are now properly coerced to the expected field type.][42807]
4966 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4967   `wasm32-experimental-emscripten` target.
4968 - [Changed some of the error messages to be more helpful.][42033]
4969 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4970   it.][43170]
4971 - [rustc now reports the total number of errors on compilation failure][43015]
4972   previously this was only the number of errors in the pass that failed.
4973 - [Expansion in rustc has been sped up 29x.][42533]
4974 - [added `msp430-none-elf` target.][43099]
4975 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4976   applicable][43178]
4977 - [Fixes backtraces on Redox][43228]
4978 - [rustc now identifies different versions of same crate when absolute paths of
4979   different types match in an error message.][42826]
4980
4981 Libraries
4982 ---------
4983
4984
4985 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4986 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4987   tuples.][43011]
4988 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4989   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4990 - [Impl `Clone` for `DefaultHasher`.][42799]
4991 - [Impl `Sync` for `SyncSender`.][42397]
4992 - [Impl `FromStr` for `char`][42271]
4993 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4994   NaN.][42431]
4995 - [allow messages in the `unimplemented!()` macro.][42155]
4996   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4997 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4998 - [Upgrade to Unicode 10.0.0][42999]
4999 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
5000 - [Skip the main thread's manual stack guard on Linux][43072]
5001 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
5002 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
5003   previously 2^15.
5004 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
5005
5006 Stabilized APIs
5007 ---------------
5008
5009 - [`CStr::into_c_string`]
5010 - [`CString::as_c_str`]
5011 - [`CString::into_boxed_c_str`]
5012 - [`Chain::get_mut`]
5013 - [`Chain::get_ref`]
5014 - [`Chain::into_inner`]
5015 - [`Option::get_or_insert_with`]
5016 - [`Option::get_or_insert`]
5017 - [`OsStr::into_os_string`]
5018 - [`OsString::into_boxed_os_str`]
5019 - [`Take::get_mut`]
5020 - [`Take::get_ref`]
5021 - [`Utf8Error::error_len`]
5022 - [`char::EscapeDebug`]
5023 - [`char::escape_debug`]
5024 - [`compile_error!`]
5025 - [`f32::from_bits`]
5026 - [`f32::to_bits`]
5027 - [`f64::from_bits`]
5028 - [`f64::to_bits`]
5029 - [`mem::ManuallyDrop`]
5030 - [`slice::sort_unstable_by_key`]
5031 - [`slice::sort_unstable_by`]
5032 - [`slice::sort_unstable`]
5033 - [`str::from_boxed_utf8_unchecked`]
5034 - [`str::as_bytes_mut`]
5035 - [`str::as_bytes_mut`]
5036 - [`str::from_utf8_mut`]
5037 - [`str::from_utf8_unchecked_mut`]
5038 - [`str::get_mut`]
5039 - [`str::get_unchecked_mut`]
5040 - [`str::get_unchecked`]
5041 - [`str::get`]
5042 - [`str::into_boxed_bytes`]
5043
5044
5045 Cargo
5046 -----
5047 - [Cargo API token location moved from `~/.cargo/config` to
5048   `~/.cargo/credentials`.][cargo/3978]
5049 - [Cargo will now build `main.rs` binaries that are in sub-directories of
5050   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
5051   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
5052 - [You can now specify version of a binary when installed through
5053   `cargo install` using `--vers`.][cargo/4229]
5054 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
5055   failure.][cargo/4248]
5056 - [Changed the convention around which file is the crate root.][cargo/4259]
5057 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
5058   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
5059
5060 Compatibility Notes
5061 -------------------
5062
5063 - [Functions with `'static` in their return types will now not be as usable as
5064   if they were using lifetime parameters instead.][42417]
5065 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
5066   takes the sign of NaN into account where previously didn't.][42430]
5067
5068 [42033]: https://github.com/rust-lang/rust/pull/42033
5069 [42155]: https://github.com/rust-lang/rust/pull/42155
5070 [42271]: https://github.com/rust-lang/rust/pull/42271
5071 [42397]: https://github.com/rust-lang/rust/pull/42397
5072 [42417]: https://github.com/rust-lang/rust/pull/42417
5073 [42430]: https://github.com/rust-lang/rust/pull/42430
5074 [42431]: https://github.com/rust-lang/rust/pull/42431
5075 [42533]: https://github.com/rust-lang/rust/pull/42533
5076 [42571]: https://github.com/rust-lang/rust/pull/42571
5077 [42613]: https://github.com/rust-lang/rust/pull/42613
5078 [42799]: https://github.com/rust-lang/rust/pull/42799
5079 [42807]: https://github.com/rust-lang/rust/pull/42807
5080 [42809]: https://github.com/rust-lang/rust/pull/42809
5081 [42822]: https://github.com/rust-lang/rust/pull/42822
5082 [42826]: https://github.com/rust-lang/rust/pull/42826
5083 [42854]: https://github.com/rust-lang/rust/pull/42854
5084 [42913]: https://github.com/rust-lang/rust/pull/42913
5085 [42999]: https://github.com/rust-lang/rust/pull/42999
5086 [43011]: https://github.com/rust-lang/rust/pull/43011
5087 [43015]: https://github.com/rust-lang/rust/pull/43015
5088 [43072]: https://github.com/rust-lang/rust/pull/43072
5089 [43077]: https://github.com/rust-lang/rust/pull/43077
5090 [43097]: https://github.com/rust-lang/rust/pull/43097
5091 [43099]: https://github.com/rust-lang/rust/pull/43099
5092 [43170]: https://github.com/rust-lang/rust/pull/43170
5093 [43178]: https://github.com/rust-lang/rust/pull/43178
5094 [43185]: https://github.com/rust-lang/rust/pull/43185
5095 [43228]: https://github.com/rust-lang/rust/pull/43228
5096 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
5097 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
5098 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
5099 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
5100 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
5101 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
5102 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
5103 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
5104 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
5105 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
5106 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
5107 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
5108 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
5109 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
5110 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
5111 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
5112 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
5113 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
5114 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
5115 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
5116 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
5117 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
5118 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
5119 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
5120 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
5121 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
5122 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
5123 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
5124 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
5125 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
5126 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
5127 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
5128 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
5129 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
5130 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
5131 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
5132 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
5133 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5134 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5135
5136
5137 Version 1.19.0 (2017-07-20)
5138 ===========================
5139
5140 Language
5141 --------
5142
5143 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5144   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5145 - [Macro recursion limit increased to 1024 from 64.][41676]
5146 - [Added lint for detecting unused macros.][41907]
5147 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5148   For example: `let x = loop { break 7; };`
5149 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5150   contain `Copy` types and cannot have a `Drop` implementation.
5151   Example: `union Foo { bar: u8, baz: usize }`
5152 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5153   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5154
5155 Compiler
5156 --------
5157
5158 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5159 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5160   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5161   you should use `--target armv7-linux-androideabi`.
5162 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5163 - [Minor optimisation of string operations.][42037]
5164 - [Compiler error message is now `aborting due to previous error(s)` instead of
5165   `aborting due to N previous errors`][42150] This was previously inaccurate and
5166   would only count certain kinds of errors.
5167 - [The compiler now supports Visual Studio 2017][42225]
5168 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5169 - [Added a lot][42264] of [new error codes][42302]
5170 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5171   libraries with C Run-time Libraries(CRT) to be statically linked.
5172 - [Fixed various ARM codegen bugs][42740]
5173
5174 Libraries
5175 ---------
5176
5177 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5178   `Extend<Cow<'a, str>>`][41449]
5179 - [`Vec` now implements `From<&mut [T]>`][41530]
5180 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5181 - [`SplitWhitespace` now implements `Clone`][41659]
5182 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5183   1.5x faster][41764]
5184 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5185   macros, but for printing to stderr.
5186
5187 Stabilized APIs
5188 ---------------
5189
5190 - [`OsString::shrink_to_fit`]
5191 - [`cmp::Reverse`]
5192 - [`Command::envs`]
5193 - [`thread::ThreadId`]
5194
5195 Cargo
5196 -----
5197
5198 - [Build scripts can now add environment variables to the environment
5199   the crate is being compiled in.
5200   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5201 - [Subcommands now replace the current process rather than spawning a new
5202   child process][cargo/3970]
5203 - [Workspace members can now accept glob file patterns][cargo/3979]
5204 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5205   the members in a given workspace.][cargo/3988]
5206 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5207 - [Target directory path is now in the cargo metadata][cargo/4022]
5208 - [Cargo no longer checks out a local working directory for the
5209   crates.io index][cargo/4026] This should provide smaller file size for the
5210   registry, and improve cloning times, especially on Windows machines.
5211 - [Added an `--exclude` option for excluding certain packages when using the
5212   `--all` option][cargo/4031]
5213 - [Cargo will now automatically retry when receiving a 5xx error
5214   from crates.io][cargo/4032]
5215 - [The `--features` option now accepts multiple comma or space
5216   delimited values.][cargo/4084]
5217 - [Added support for custom target specific runners][cargo/3954]
5218
5219 Misc
5220 ----
5221
5222 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5223   Windows Debugger.
5224 - [Rust will now release XZ compressed packages][rust-installer/57]
5225 - [rustup will now prefer to download rust packages with
5226   XZ compression][rustup/1100] over GZip packages.
5227 - [Added the ability to escape `#` in rust documentation][41785] By adding
5228   additional `#`'s ie. `##` is now `#`
5229
5230 Compatibility Notes
5231 -------------------
5232
5233 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5234 - [`-Z` flags are now no longer allowed to be used on the stable
5235   compiler.][41751] This has been a warning for a year previous to this.
5236 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5237   longer works][42844]. Users should migrate to the built-in `check`
5238   command, which has been available since 1.16.
5239 - [Ending a float literal with `._` is now a hard error.
5240   Example: `42._` .][41946]
5241 - [Any use of a private `extern crate` outside of its module is now a
5242   hard error.][36886] This was previously a warning.
5243 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5244   relative while the `::` prefix makes a path absolute, but was ignored and the
5245   path was relative regardless.
5246 - [Floating point constants in match patterns is now a hard error][36890]
5247   This was previously a warning.
5248 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5249   match patterns is now a hard error][36891] This was previously a warning.
5250 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5251   a warning.
5252 - [From the pound escape, lines consisting of multiple `#`s are
5253   now visible][41785]
5254 - [It is an error to re-export private enum variants][42460]. This is
5255   known to break a number of crates that depend on an older version of
5256   mustache.
5257 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5258   to use it to find the linker, and the build will fail where it did
5259   not previously][42607]
5260
5261 [36886]: https://github.com/rust-lang/rust/issues/36886
5262 [36888]: https://github.com/rust-lang/rust/issues/36888
5263 [36890]: https://github.com/rust-lang/rust/issues/36890
5264 [36891]: https://github.com/rust-lang/rust/issues/36891
5265 [36892]: https://github.com/rust-lang/rust/issues/36892
5266 [37406]: https://github.com/rust-lang/rust/issues/37406
5267 [39983]: https://github.com/rust-lang/rust/pull/39983
5268 [41145]: https://github.com/rust-lang/rust/pull/41145
5269 [41192]: https://github.com/rust-lang/rust/pull/41192
5270 [41258]: https://github.com/rust-lang/rust/pull/41258
5271 [41370]: https://github.com/rust-lang/rust/pull/41370
5272 [41449]: https://github.com/rust-lang/rust/pull/41449
5273 [41530]: https://github.com/rust-lang/rust/pull/41530
5274 [41624]: https://github.com/rust-lang/rust/pull/41624
5275 [41656]: https://github.com/rust-lang/rust/pull/41656
5276 [41659]: https://github.com/rust-lang/rust/pull/41659
5277 [41676]: https://github.com/rust-lang/rust/pull/41676
5278 [41751]: https://github.com/rust-lang/rust/pull/41751
5279 [41764]: https://github.com/rust-lang/rust/pull/41764
5280 [41785]: https://github.com/rust-lang/rust/pull/41785
5281 [41873]: https://github.com/rust-lang/rust/pull/41873
5282 [41907]: https://github.com/rust-lang/rust/pull/41907
5283 [41946]: https://github.com/rust-lang/rust/pull/41946
5284 [42016]: https://github.com/rust-lang/rust/pull/42016
5285 [42037]: https://github.com/rust-lang/rust/pull/42037
5286 [42068]: https://github.com/rust-lang/rust/pull/42068
5287 [42150]: https://github.com/rust-lang/rust/pull/42150
5288 [42162]: https://github.com/rust-lang/rust/pull/42162
5289 [42225]: https://github.com/rust-lang/rust/pull/42225
5290 [42264]: https://github.com/rust-lang/rust/pull/42264
5291 [42302]: https://github.com/rust-lang/rust/pull/42302
5292 [42460]: https://github.com/rust-lang/rust/issues/42460
5293 [42607]: https://github.com/rust-lang/rust/issues/42607
5294 [42740]: https://github.com/rust-lang/rust/pull/42740
5295 [42844]: https://github.com/rust-lang/rust/issues/42844
5296 [42948]: https://github.com/rust-lang/rust/pull/42948
5297 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5298 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5299 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5300 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5301 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5302 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5303 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5304 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5305 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5306 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5307 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5308 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5309 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5310 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5311 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5312 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5313 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5314 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5315 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5316 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5317 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5318 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5319
5320
5321 Version 1.18.0 (2017-06-08)
5322 ===========================
5323
5324 Language
5325 --------
5326
5327 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5328   make the item visible to just that module tree. Also accepts the keyword
5329   `crate` to make something public to the whole crate but not users of the
5330   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5331 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5332   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5333 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5334   types like `Write + Send`, trailing `+` are now supported in trait objects,
5335   and better error reporting for trait objects starting with `?Sized`.
5336 - [0e+10 is now a valid floating point literal][40589]
5337 - [Now warns if you bind a lifetime parameter to 'static][40734]
5338 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5339   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5340   representation in some cases.][40377]
5341
5342 Compiler
5343 --------
5344
5345 - [rustc can now emit mir with `--emit mir`][39891]
5346 - [Improved LLVM IR for trivial functions][40367]
5347 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5348 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5349   opportunities found through profiling
5350 - [Improved backtrace formatting when panicking][38165]
5351
5352 Libraries
5353 ---------
5354
5355 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5356   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5357   iteration or reallocation.
5358 - [Simplified HashMap Bucket interface][40561] provides performance
5359   improvements for iterating and cloning.
5360 - [Specialize Vec::from_elem to use calloc][40409]
5361 - [Fixed Race condition in fs::create_dir_all][39799]
5362 - [No longer caching stdio on Windows][40516]
5363 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5364   2.50%~ faster and in one case now 12.50% faster.
5365 - [Optimized `AtomicBool::fetch_nand`][41143]
5366
5367 Stabilized APIs
5368 ---------------
5369
5370 - [`Child::try_wait`]
5371 - [`HashMap::retain`]
5372 - [`HashSet::retain`]
5373 - [`PeekMut::pop`]
5374 - [`TcpStream::peek`]
5375 - [`UdpSocket::peek`]
5376 - [`UdpSocket::peek_from`]
5377
5378 Cargo
5379 -----
5380
5381 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5382   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5383 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5384 - [Added Android build support][cargo/3885]
5385 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5386   of a certain type, for example `cargo build --bins` will build all
5387   binaries.
5388 - [Added support for haiku][cargo/3952]
5389
5390 Misc
5391 ----
5392
5393 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5394 - [Added rust-windbg script for better debugging on Windows][39983]
5395 - [Rust now uses the official cross compiler for NetBSD][40612]
5396 - [rustdoc now accepts `#` at the start of files][40828]
5397 - [Fixed jemalloc support for musl][41168]
5398
5399 Compatibility Notes
5400 -------------------
5401
5402 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5403   always placed after the sign if it exists and before the digits. With the `#`
5404   flag the zeroes are placed after the prefix and before the digits.
5405 - [Due to the struct field optimisation][40377], using `transmute` on structs
5406   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5407   always been undefined behavior, but is now more likely to break in practice.
5408 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5409   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5410   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5411 - [Overlapping inherent `impl`s are now a hard error][40728]
5412 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5413 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5414   `out.asm` and `out.ll` instead of only one of the filetypes.
5415 - [ calling a function that returns `Self` will no longer work][41805] when
5416   the size of `Self` cannot be statically determined.
5417 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5418   this has caused a few regressions namely:
5419
5420   - Changed the link order of local static/dynamic libraries (respecting the
5421     order on given rather than having the compiler reorder).
5422   - Changed how MinGW is linked, native code linked to dynamic libraries
5423     may require manually linking to the gcc support library (for the native
5424     code itself)
5425
5426 [38165]: https://github.com/rust-lang/rust/pull/38165
5427 [39799]: https://github.com/rust-lang/rust/pull/39799
5428 [39891]: https://github.com/rust-lang/rust/pull/39891
5429 [39983]: https://github.com/rust-lang/rust/pull/39983
5430 [40043]: https://github.com/rust-lang/rust/pull/40043
5431 [40241]: https://github.com/rust-lang/rust/pull/40241
5432 [40338]: https://github.com/rust-lang/rust/pull/40338
5433 [40367]: https://github.com/rust-lang/rust/pull/40367
5434 [40377]: https://github.com/rust-lang/rust/pull/40377
5435 [40409]: https://github.com/rust-lang/rust/pull/40409
5436 [40516]: https://github.com/rust-lang/rust/pull/40516
5437 [40556]: https://github.com/rust-lang/rust/pull/40556
5438 [40561]: https://github.com/rust-lang/rust/pull/40561
5439 [40589]: https://github.com/rust-lang/rust/pull/40589
5440 [40612]: https://github.com/rust-lang/rust/pull/40612
5441 [40723]: https://github.com/rust-lang/rust/pull/40723
5442 [40728]: https://github.com/rust-lang/rust/pull/40728
5443 [40731]: https://github.com/rust-lang/rust/pull/40731
5444 [40734]: https://github.com/rust-lang/rust/pull/40734
5445 [40805]: https://github.com/rust-lang/rust/pull/40805
5446 [40807]: https://github.com/rust-lang/rust/pull/40807
5447 [40828]: https://github.com/rust-lang/rust/pull/40828
5448 [40870]: https://github.com/rust-lang/rust/pull/40870
5449 [41085]: https://github.com/rust-lang/rust/pull/41085
5450 [41143]: https://github.com/rust-lang/rust/pull/41143
5451 [41168]: https://github.com/rust-lang/rust/pull/41168
5452 [41270]: https://github.com/rust-lang/rust/issues/41270
5453 [41469]: https://github.com/rust-lang/rust/pull/41469
5454 [41805]: https://github.com/rust-lang/rust/issues/41805
5455 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5456 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5457 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5458 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5459 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5460 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5461 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5462 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5463 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5464 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5465 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5466 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5467 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5468 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5469
5470
5471 Version 1.17.0 (2017-04-27)
5472 ===========================
5473
5474 Language
5475 --------
5476
5477 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5478 * [Fields of structs may be initialized without duplicating the field/variable
5479   names][39761]. [RFC 1682]
5480 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5481 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5482   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5483   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5484   `'b`. Soundness fix.
5485 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5486 * [Static variables may contain references to other statics][40027]
5487
5488 Compiler
5489 --------
5490
5491 * [Exit quickly on only `--emit dep-info`][40336]
5492 * [Make `-C relocation-model` more correctly determine whether the linker
5493   creates a position-independent executable][40245]
5494 * [Add `-C overflow-checks` to directly control whether integer overflow
5495   panics][40037]
5496 * [The rustc type checker now checks items on demand instead of in a single
5497   in-order pass][40008]. This is mostly an internal refactoring in support of
5498   future work, including incremental type checking, but also resolves [RFC
5499   1647], allowing `Self` to appear in `impl` `where` clauses.
5500 * [Optimize vtable loads][39995]
5501 * [Turn off vectorization for Emscripten targets][39990]
5502 * [Provide suggestions for unknown macros imported with `use`][39953]
5503 * [Fix ICEs in path resolution][39939]
5504 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5505 * [Add clearer error message using `&str + &str`][39116]
5506
5507 Stabilized APIs
5508 ---------------
5509
5510 * [`Arc::into_raw`]
5511 * [`Arc::from_raw`]
5512 * [`Arc::ptr_eq`]
5513 * [`Rc::into_raw`]
5514 * [`Rc::from_raw`]
5515 * [`Rc::ptr_eq`]
5516 * [`Ordering::then`]
5517 * [`Ordering::then_with`]
5518 * [`BTreeMap::range`]
5519 * [`BTreeMap::range_mut`]
5520 * [`collections::Bound`]
5521 * [`process::abort`]
5522 * [`ptr::read_unaligned`]
5523 * [`ptr::write_unaligned`]
5524 * [`Result::expect_err`]
5525 * [`Cell::swap`]
5526 * [`Cell::replace`]
5527 * [`Cell::into_inner`]
5528 * [`Cell::take`]
5529
5530 Libraries
5531 ---------
5532
5533 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5534 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5535 * [`String` implements `FromIterator<&char>`][40028]
5536 * `Box` [implements][40009] a number of new conversions:
5537   `From<Box<str>> for String`,
5538   `From<Box<[T]>> for Vec<T>`,
5539   `From<Box<CStr>> for CString`,
5540   `From<Box<OsStr>> for OsString`,
5541   `From<Box<Path>> for PathBuf`,
5542   `Into<Box<str>> for String`,
5543   `Into<Box<[T]>> for Vec<T>`,
5544   `Into<Box<CStr>> for CString`,
5545   `Into<Box<OsStr>> for OsString`,
5546   `Into<Box<Path>> for PathBuf`,
5547   `Default for Box<str>`,
5548   `Default for Box<CStr>`,
5549   `Default for Box<OsStr>`,
5550   `From<&CStr> for Box<CStr>`,
5551   `From<&OsStr> for Box<OsStr>`,
5552   `From<&Path> for Box<Path>`
5553 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5554 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5555 * [Slightly optimize `slice::sort`][39538]
5556 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5557 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5558   `Box<str>` implements `From<&str>`][39438]
5559 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5560   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5561 * [`format!` estimates the needed capacity before writing a string][39356]
5562 * [Support unprivileged symlink creation in Windows][38921]
5563 * [`PathBuf` implements `Default`][38764]
5564 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5565 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5566   and poor hash functions.
5567
5568 Cargo
5569 -----
5570
5571 * [Add `cargo check --all`][cargo/3731]
5572 * [Add an option to ignore SSL revocation checking][cargo/3699]
5573 * [Add `cargo run --package`][cargo/3691]
5574 * [Add `required_features`][cargo/3667]
5575 * [Assume `build.rs` is a build script][cargo/3664]
5576 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5577
5578 Misc
5579 ----
5580
5581 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5582   `rustbook`][39633]
5583 * [The "Unstable Book" documents nightly-only features][ubook]
5584 * [Improve the style of the sidebar in rustdoc output][40265]
5585 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5586 * [Fix MSP430 breakage due to `i128`][40257]
5587 * [Preliminary Solaris/SPARCv9 support][39903]
5588 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5589   run without installing the MSVC runtime.
5590 * [`rustdoc --test` includes file names in test names][39788]
5591 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5592   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5593 * [Initial support for `aarch64-unknown-freebsd`][39491]
5594 * [Initial support for `i686-unknown-netbsd`][39426]
5595 * [This release no longer includes the old makefile build system][39431]. Rust
5596   is built with a custom build system, written in Rust, and with Cargo.
5597 * [Add Debug implementations for libcollection structs][39002]
5598 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5599 * [`--test-threads=0` produces an error][38945]
5600 * [`rustup` installs documentation by default][40526]
5601 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5602   WinDbg and Visual Studio to improve the debugging experience.
5603
5604 Compatibility Notes
5605 -------------------
5606
5607 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5608   workaround, either use MSVC 2015 or run vcvars.bat.
5609 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5610   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5611   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5612   fix.
5613 * [`format!` and `Display::to_string` panic if an underlying formatting
5614   implementation returns an error][40117]. Previously the error was silently
5615   ignored. It is incorrect for `write_fmt` to return an error when writing
5616   to a string.
5617 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5618   crates were marked stable and could be accessed from the stable toolchain.
5619 * [Rust git source no longer includes vendored crates][39728]. Those that need
5620   to build with vendored crates should build from release tarballs.
5621 * [Fix inert attributes from `proc_macro_derives`][39572]
5622 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5623   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5624   build system.
5625 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5626   existing code generally ignores the type of dead-code unless a type-hint is
5627   provided; this can cause surprising inference interactions particularly around
5628   defaulting. The new code uniformly ignores the result type of dead-code.
5629 * [Tuple-struct constructors with private fields are no longer visible][38932]
5630 * [Lifetime parameters that do not appear in the arguments are now considered
5631   early-bound][38897], resolving a soundness bug (#[32330]). The
5632   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5633   April of 2016.
5634 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5635 * [Make transmuting from fn item types to pointer-sized types a hard
5636   error][34198]
5637
5638 [27787]: https://github.com/rust-lang/rust/issues/27787
5639 [32330]: https://github.com/rust-lang/rust/issues/32330
5640 [34198]: https://github.com/rust-lang/rust/pull/34198
5641 [38161]: https://github.com/rust-lang/rust/pull/38161
5642 [38368]: https://github.com/rust-lang/rust/pull/38368
5643 [38584]: https://github.com/rust-lang/rust/issues/38584
5644 [38661]: https://github.com/rust-lang/rust/pull/38661
5645 [38764]: https://github.com/rust-lang/rust/pull/38764
5646 [38864]: https://github.com/rust-lang/rust/issues/38864
5647 [38897]: https://github.com/rust-lang/rust/pull/38897
5648 [38921]: https://github.com/rust-lang/rust/pull/38921
5649 [38932]: https://github.com/rust-lang/rust/pull/38932
5650 [38945]: https://github.com/rust-lang/rust/pull/38945
5651 [38981]: https://github.com/rust-lang/rust/pull/38981
5652 [39002]: https://github.com/rust-lang/rust/pull/39002
5653 [39116]: https://github.com/rust-lang/rust/pull/39116
5654 [39193]: https://github.com/rust-lang/rust/pull/39193
5655 [39265]: https://github.com/rust-lang/rust/pull/39265
5656 [39356]: https://github.com/rust-lang/rust/pull/39356
5657 [39372]: https://github.com/rust-lang/rust/pull/39372
5658 [39426]: https://github.com/rust-lang/rust/pull/39426
5659 [39431]: https://github.com/rust-lang/rust/pull/39431
5660 [39438]: https://github.com/rust-lang/rust/pull/39438
5661 [39440]: https://github.com/rust-lang/rust/pull/39440
5662 [39485]: https://github.com/rust-lang/rust/pull/39485
5663 [39491]: https://github.com/rust-lang/rust/pull/39491
5664 [39518]: https://github.com/rust-lang/rust/pull/39518
5665 [39538]: https://github.com/rust-lang/rust/pull/39538
5666 [39572]: https://github.com/rust-lang/rust/pull/39572
5667 [39633]: https://github.com/rust-lang/rust/pull/39633
5668 [39642]: https://github.com/rust-lang/rust/pull/39642
5669 [39728]: https://github.com/rust-lang/rust/pull/39728
5670 [39761]: https://github.com/rust-lang/rust/pull/39761
5671 [39788]: https://github.com/rust-lang/rust/pull/39788
5672 [39793]: https://github.com/rust-lang/rust/pull/39793
5673 [39837]: https://github.com/rust-lang/rust/pull/39837
5674 [39843]: https://github.com/rust-lang/rust/pull/39843
5675 [39851]: https://github.com/rust-lang/rust/pull/39851
5676 [39903]: https://github.com/rust-lang/rust/pull/39903
5677 [39939]: https://github.com/rust-lang/rust/pull/39939
5678 [39953]: https://github.com/rust-lang/rust/pull/39953
5679 [39960]: https://github.com/rust-lang/rust/pull/39960
5680 [39990]: https://github.com/rust-lang/rust/pull/39990
5681 [39995]: https://github.com/rust-lang/rust/pull/39995
5682 [40008]: https://github.com/rust-lang/rust/pull/40008
5683 [40009]: https://github.com/rust-lang/rust/pull/40009
5684 [40027]: https://github.com/rust-lang/rust/pull/40027
5685 [40028]: https://github.com/rust-lang/rust/pull/40028
5686 [40037]: https://github.com/rust-lang/rust/pull/40037
5687 [40117]: https://github.com/rust-lang/rust/pull/40117
5688 [40166]: https://github.com/rust-lang/rust/pull/40166
5689 [40245]: https://github.com/rust-lang/rust/pull/40245
5690 [40257]: https://github.com/rust-lang/rust/pull/40257
5691 [40261]: https://github.com/rust-lang/rust/pull/40261
5692 [40265]: https://github.com/rust-lang/rust/pull/40265
5693 [40319]: https://github.com/rust-lang/rust/pull/40319
5694 [40336]: https://github.com/rust-lang/rust/pull/40336
5695 [40526]: https://github.com/rust-lang/rust/pull/40526
5696 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5697 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5698 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5699 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5700 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5701 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5702 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5703 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5704 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5705 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5706 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5707 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5708 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5709 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5710 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5711 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5712 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5713 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5714 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5715 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5716 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5717 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5718 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5719 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5720 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5721 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5722 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5723 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5724 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5725 [mdbook]: https://crates.io/crates/mdbook
5726 [ubook]: https://doc.rust-lang.org/unstable-book/
5727
5728
5729 Version 1.16.0 (2017-03-16)
5730 ===========================
5731
5732 Language
5733 --------
5734
5735 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5736 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5737   match patterns][38069]
5738 * [Clean up semantics of `self` in an import list][38313]
5739 * [`Self` may appear in `impl` headers][38920]
5740 * [`Self` may appear in struct expressions][39282]
5741
5742 Compiler
5743 --------
5744
5745 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5746   a `.rmeta` file containing only crate metadata][38571]. This can be
5747   used by tools like the Rust Language Service to perform
5748   metadata-only builds.
5749 * [Levenshtein based typo suggestions now work in most places, while
5750   previously they worked only for fields and sometimes for local
5751   variables][38927]. Together with the overhaul of "no
5752   resolution"/"unexpected resolution" errors (#[38154]) they result in
5753   large and systematic improvement in resolution diagnostics.
5754 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5755   `U`][38670]
5756 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5757 * [`rustc` no longer attempts to provide "consider using an explicit
5758   lifetime" suggestions][37057]. They were inaccurate.
5759
5760 Stabilized APIs
5761 ---------------
5762
5763 * [`VecDeque::truncate`]
5764 * [`VecDeque::resize`]
5765 * [`String::insert_str`]
5766 * [`Duration::checked_add`]
5767 * [`Duration::checked_sub`]
5768 * [`Duration::checked_div`]
5769 * [`Duration::checked_mul`]
5770 * [`str::replacen`]
5771 * [`str::repeat`]
5772 * [`SocketAddr::is_ipv4`]
5773 * [`SocketAddr::is_ipv6`]
5774 * [`IpAddr::is_ipv4`]
5775 * [`IpAddr::is_ipv6`]
5776 * [`Vec::dedup_by`]
5777 * [`Vec::dedup_by_key`]
5778 * [`Result::unwrap_or_default`]
5779 * [`<*const T>::wrapping_offset`]
5780 * [`<*mut T>::wrapping_offset`]
5781 * `CommandExt::creation_flags`
5782 * [`File::set_permissions`]
5783 * [`String::split_off`]
5784
5785 Libraries
5786 ---------
5787
5788 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5789   their argument by `Borrow` parameter][37761]
5790 * [All public types in std implement `Debug`][38006]
5791 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5792 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5793 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5794   Windows][38274]
5795 * [std: Fix partial writes in `LineWriter`][38062]
5796 * [std: Clamp max read/write sizes on Unix][38062]
5797 * [Use more specific panic message for `&str` slicing errors][38066]
5798 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5799   functionality cannot be achieved in std currently.
5800 * [`writeln!`, like `println!`, now accepts a form with no string
5801   or formatting arguments, to just print a newline][38469]
5802 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5803 * [Reduce the size of static data in `std_unicode::tables`][38781]
5804 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5805   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5806   `Display`][38909]
5807 * [`Duration` implements `Sum`][38712]
5808 * [`String` implements `ToSocketAddrs`][39048]
5809
5810 Cargo
5811 -----
5812
5813 * [The `cargo check` command does a type check of a project without
5814   building it][cargo/3296]
5815 * [crates.io will display CI badges from Travis and AppVeyor, if
5816   specified in Cargo.toml][cargo/3546]
5817 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5818 * [Compilation profiles accept integer values for `debug`, in addition
5819   to `true` and `false`. These are passed to `rustc` as the value to
5820   `-C debuginfo`][cargo/3534]
5821 * [Implement `cargo --version --verbose`][cargo/3604]
5822 * [All builds now output 'dep-info' build dependencies compatible with
5823   make and ninja][cargo/3557]
5824 * [Build all workspace members with `build --all`][cargo/3511]
5825 * [Document all workspace members with `doc --all`][cargo/3515]
5826 * [Path deps outside workspace are not members][cargo/3443]
5827
5828 Misc
5829 ----
5830
5831 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5832   the path to the Rust implementation][38589]
5833 * [The `armv7-linux-androideabi` target no longer enables NEON
5834   extensions, per Google's ABI guide][38413]
5835 * [The stock standard library can be compiled for Redox OS][38401]
5836 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5837   available.
5838 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5839   builds available.
5840 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5841
5842 Compatibility Notes
5843 -------------------
5844
5845 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5846   match patterns][38069]
5847 * In this release, references to uninhabited types can not be
5848   pattern-matched. This was accidentally allowed in 1.15.
5849 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5850 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5851   Windows][38274]
5852 * [Clean up semantics of `self` in an import list][38313]
5853 * Reimplemented lifetime elision. This change was almost entirely compatible
5854   with existing code, but it did close a number of small bugs and loopholes,
5855   as well as being more accepting in some other [cases][41105].
5856
5857 [37057]: https://github.com/rust-lang/rust/pull/37057
5858 [37761]: https://github.com/rust-lang/rust/pull/37761
5859 [38006]: https://github.com/rust-lang/rust/pull/38006
5860 [38051]: https://github.com/rust-lang/rust/pull/38051
5861 [38062]: https://github.com/rust-lang/rust/pull/38062
5862 [38062]: https://github.com/rust-lang/rust/pull/38622
5863 [38066]: https://github.com/rust-lang/rust/pull/38066
5864 [38069]: https://github.com/rust-lang/rust/pull/38069
5865 [38131]: https://github.com/rust-lang/rust/pull/38131
5866 [38154]: https://github.com/rust-lang/rust/pull/38154
5867 [38274]: https://github.com/rust-lang/rust/pull/38274
5868 [38304]: https://github.com/rust-lang/rust/pull/38304
5869 [38313]: https://github.com/rust-lang/rust/pull/38313
5870 [38314]: https://github.com/rust-lang/rust/pull/38314
5871 [38327]: https://github.com/rust-lang/rust/pull/38327
5872 [38401]: https://github.com/rust-lang/rust/pull/38401
5873 [38413]: https://github.com/rust-lang/rust/pull/38413
5874 [38469]: https://github.com/rust-lang/rust/pull/38469
5875 [38559]: https://github.com/rust-lang/rust/pull/38559
5876 [38571]: https://github.com/rust-lang/rust/pull/38571
5877 [38580]: https://github.com/rust-lang/rust/pull/38580
5878 [38589]: https://github.com/rust-lang/rust/pull/38589
5879 [38670]: https://github.com/rust-lang/rust/pull/38670
5880 [38712]: https://github.com/rust-lang/rust/pull/38712
5881 [38726]: https://github.com/rust-lang/rust/pull/38726
5882 [38781]: https://github.com/rust-lang/rust/pull/38781
5883 [38798]: https://github.com/rust-lang/rust/pull/38798
5884 [38909]: https://github.com/rust-lang/rust/pull/38909
5885 [38920]: https://github.com/rust-lang/rust/pull/38920
5886 [38927]: https://github.com/rust-lang/rust/pull/38927
5887 [39048]: https://github.com/rust-lang/rust/pull/39048
5888 [39282]: https://github.com/rust-lang/rust/pull/39282
5889 [39379]: https://github.com/rust-lang/rust/pull/39379
5890 [41105]: https://github.com/rust-lang/rust/issues/41105
5891 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5892 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5893 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5894 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5895 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5896 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5897 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5898 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5899 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5900 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5901 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5902 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5903 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5904 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5905 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5906 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5907 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5908 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5909 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5910 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5911 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5912 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5913 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5914 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5915 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5916 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5917 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5918 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5919 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5920 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5921
5922
5923 Version 1.15.1 (2017-02-09)
5924 ===========================
5925
5926 * [Fix IntoIter::as_mut_slice's signature][39466]
5927 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5928
5929 [39466]: https://github.com/rust-lang/rust/pull/39466
5930 [39523]: https://github.com/rust-lang/rust/pull/39523
5931
5932
5933 Version 1.15.0 (2017-02-02)
5934 ===========================
5935
5936 Language
5937 --------
5938
5939 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5940   stable. This allows popular code-generating crates like Serde and Diesel to
5941   work ergonomically. [RFC 1681].
5942 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5943   with curly braces][36868]. Part of [RFC 1506].
5944 * [A number of minor changes to name resolution have been activated][37127].
5945   They add up to more consistent semantics, allowing for future evolution of
5946   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5947   details of what is different. The breaking changes here have been transitioned
5948   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5949 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5950   bounds][38279]
5951 * [`?Sized` can be used in `where` clauses][37791]
5952 * [There is now a limit on the size of monomorphized types and it can be
5953   modified with the `#![type_size_limit]` crate attribute, similarly to
5954   the `#![recursion_limit]` attribute][37789]
5955
5956 Compiler
5957 --------
5958
5959 * [On Windows, the compiler will apply dllimport attributes when linking to
5960   extern functions][37973]. Additional attributes and flags can control which
5961   library kind is linked and its name. [RFC 1717].
5962 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5963 * [The `--test` flag works with procedural macro crates][38107]
5964 * [Fix `extern "aapcs" fn` ABI][37814]
5965 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5966 * [The `format!` expander recognizes incorrect `printf` and shell-style
5967   formatting directives and suggests the correct format][37613].
5968 * [Only report one error for all unused imports in an import list][37456]
5969
5970 Compiler Performance
5971 --------------------
5972
5973 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5974 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5975 * [Don't clone in `UnificationTable::probe`][37848]
5976 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5977 * [Use small vectors in type walker][37760]
5978 * [Macro expansion performance was improved][37701]
5979 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5980 * [Replace FNV with a faster hash function][37229]
5981
5982 Stabilized APIs
5983 ---------------
5984
5985 * [`std::iter::Iterator::min_by`]
5986 * [`std::iter::Iterator::max_by`]
5987 * [`std::os::*::fs::FileExt`]
5988 * [`std::sync::atomic::Atomic*::get_mut`]
5989 * [`std::sync::atomic::Atomic*::into_inner`]
5990 * [`std::vec::IntoIter::as_slice`]
5991 * [`std::vec::IntoIter::as_mut_slice`]
5992 * [`std::sync::mpsc::Receiver::try_iter`]
5993 * [`std::os::unix::process::CommandExt::before_exec`]
5994 * [`std::rc::Rc::strong_count`]
5995 * [`std::rc::Rc::weak_count`]
5996 * [`std::sync::Arc::strong_count`]
5997 * [`std::sync::Arc::weak_count`]
5998 * [`std::char::encode_utf8`]
5999 * [`std::char::encode_utf16`]
6000 * [`std::cell::Ref::clone`]
6001 * [`std::io::Take::into_inner`]
6002
6003 Libraries
6004 ---------
6005
6006 * [The standard sorting algorithm has been rewritten for dramatic performance
6007   improvements][38192]. It is a hybrid merge sort, drawing influences from
6008   Timsort. Previously it was a naive merge sort.
6009 * [`Iterator::nth` no longer has a `Sized` bound][38134]
6010 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
6011   performance.
6012 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
6013   and `char_indices().last()`][37882]
6014 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
6015 * [Chinese characters display correctly in `fmt::Debug`][37855]
6016 * [Derive `Default` for `Duration`][37699]
6017 * [Support creation of anonymous pipes on WinXP/2k][37677]
6018 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
6019 * [Don't pass overlapped handles to processes][38835]
6020
6021 Cargo
6022 -----
6023
6024 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6025   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6026   should instead check the variable at runtime with `std::env`. That the value
6027   was set at build time was a bug, and incorrect when cross-compiling. This
6028   change is known to cause breakage.
6029 * [Add `--all` flag to `cargo test`][cargo/3221]
6030 * [Compile statically against the MSVC CRT][cargo/3363]
6031 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
6032 * [Link OpenSSL statically on OSX][cargo/3311]
6033 * [Apply new fingerprinting to build dir outputs][cargo/3310]
6034 * [Test for bad path overrides with summaries][cargo/3336]
6035 * [Require `cargo install --vers` to take a semver version][cargo/3338]
6036 * [Fix retrying crate downloads for network errors][cargo/3348]
6037 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
6038 * [Emit more info on --message-format=json][cargo/3319]
6039 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
6040 * [Don't ignore errors in workspace manifest][cargo/3409]
6041 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
6042
6043 Tooling
6044 -------
6045
6046 * [Test runners (binaries built with `--test`) now support a `--list` argument
6047   that lists the tests it contains][38185]
6048 * [Test runners now support a `--exact` argument that makes the test filter
6049   match exactly, instead of matching only a substring of the test name][38181]
6050 * [rustdoc supports a `--playground-url` flag][37763]
6051 * [rustdoc provides more details about `#[should_panic]` errors][37749]
6052
6053 Misc
6054 ----
6055
6056 * [The Rust build system is now written in Rust][37817]. The Makefiles may
6057   continue to be used in this release by passing `--disable-rustbuild` to the
6058   configure script, but they will be deleted soon. Note that the new build
6059   system uses a different on-disk layout that will likely affect any scripts
6060   building Rust.
6061 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
6062   releases.
6063 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
6064 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
6065   releases.
6066
6067 Compatibility Notes
6068 -------------------
6069
6070 * [A number of minor changes to name resolution have been activated][37127].
6071   They add up to more consistent semantics, allowing for future evolution of
6072   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
6073   details of what is different. The breaking changes here have been transitioned
6074   through the [`legacy_imports`] lint since 1.14, with no known regressions.
6075 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
6076   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
6077   should instead check the variable at runtime with `std::env`. That the value
6078   was set at build time was a bug, and incorrect when cross-compiling. This
6079   change is known to cause breakage.
6080 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
6081   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
6082   1.10 and is now an error by default. It will become a hard error in the near
6083   future.
6084 * [The semantics relating modules to file system directories are changing in
6085   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
6086   lint, which is a warning in this release, and will become a hard error in the
6087   future.
6088 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
6089 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
6090   the underlying iterator][37834]
6091
6092 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
6093 [33685]: https://github.com/rust-lang/rust/issues/33685
6094 [36868]: https://github.com/rust-lang/rust/pull/36868
6095 [37127]: https://github.com/rust-lang/rust/pull/37127
6096 [37229]: https://github.com/rust-lang/rust/pull/37229
6097 [37456]: https://github.com/rust-lang/rust/pull/37456
6098 [37527]: https://github.com/rust-lang/rust/pull/37527
6099 [37602]: https://github.com/rust-lang/rust/pull/37602
6100 [37613]: https://github.com/rust-lang/rust/pull/37613
6101 [37615]: https://github.com/rust-lang/rust/pull/37615
6102 [37636]: https://github.com/rust-lang/rust/pull/37636
6103 [37627]: https://github.com/rust-lang/rust/pull/37627
6104 [37642]: https://github.com/rust-lang/rust/pull/37642
6105 [37677]: https://github.com/rust-lang/rust/pull/37677
6106 [37699]: https://github.com/rust-lang/rust/pull/37699
6107 [37701]: https://github.com/rust-lang/rust/pull/37701
6108 [37705]: https://github.com/rust-lang/rust/pull/37705
6109 [37749]: https://github.com/rust-lang/rust/pull/37749
6110 [37760]: https://github.com/rust-lang/rust/pull/37760
6111 [37763]: https://github.com/rust-lang/rust/pull/37763
6112 [37764]: https://github.com/rust-lang/rust/pull/37764
6113 [37789]: https://github.com/rust-lang/rust/pull/37789
6114 [37791]: https://github.com/rust-lang/rust/pull/37791
6115 [37814]: https://github.com/rust-lang/rust/pull/37814
6116 [37817]: https://github.com/rust-lang/rust/pull/37817
6117 [37834]: https://github.com/rust-lang/rust/pull/37834
6118 [37848]: https://github.com/rust-lang/rust/pull/37848
6119 [37855]: https://github.com/rust-lang/rust/pull/37855
6120 [37882]: https://github.com/rust-lang/rust/pull/37882
6121 [37888]: https://github.com/rust-lang/rust/pull/37888
6122 [37973]: https://github.com/rust-lang/rust/pull/37973
6123 [37979]: https://github.com/rust-lang/rust/pull/37979
6124 [38086]: https://github.com/rust-lang/rust/pull/38086
6125 [38107]: https://github.com/rust-lang/rust/pull/38107
6126 [38117]: https://github.com/rust-lang/rust/pull/38117
6127 [38134]: https://github.com/rust-lang/rust/pull/38134
6128 [38146]: https://github.com/rust-lang/rust/pull/38146
6129 [38181]: https://github.com/rust-lang/rust/pull/38181
6130 [38182]: https://github.com/rust-lang/rust/pull/38182
6131 [38185]: https://github.com/rust-lang/rust/pull/38185
6132 [38192]: https://github.com/rust-lang/rust/pull/38192
6133 [38279]: https://github.com/rust-lang/rust/pull/38279
6134 [38835]: https://github.com/rust-lang/rust/pull/38835
6135 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6136 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6137 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6138 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6139 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6140 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6141 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6142 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6143 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6144 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6145 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6146 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6147 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6148 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6149 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6150 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6151 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6152 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6153 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6154 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6155 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6156 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6157 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6158 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6159 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6160 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6161 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6162 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6163 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6164 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6165 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6166 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6167 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6168 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6169 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6170 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6171 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6172 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6173
6174
6175 Version 1.14.0 (2016-12-22)
6176 ===========================
6177
6178 Language
6179 --------
6180
6181 * [`..` matches multiple tuple fields in enum variants, structs
6182   and tuples][36843]. [RFC 1492].
6183 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6184 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6185 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6186   dereferencing][36822]
6187
6188 Compiler
6189 --------
6190
6191 * [Mark enums with non-zero discriminant as non-zero][37224]
6192 * [Lower-case `static mut` names are linted like other
6193   statics and consts][37162]
6194 * [Fix ICE on some macros in const integer positions
6195    (e.g. `[u8; m!()]`)][36819]
6196 * [Improve error message and snippet for "did you mean `x`"][36798]
6197 * [Add a panic-strategy field to the target specification][36794]
6198 * [Include LLVM version in `--version --verbose`][37200]
6199
6200 Compile-time Optimizations
6201 --------------------------
6202
6203 * [Improve macro expansion performance][37569]
6204 * [Shrink `Expr_::ExprInlineAsm`][37445]
6205 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6206 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6207 * [Avoid more allocations when compiling html5ever][37373]
6208 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6209 * [Avoid some allocations in the macro parser][37318]
6210 * [Use a faster deflate setting][37298]
6211 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6212   during interning of slices][37270]
6213 * [Optimize `write_metadata`][37267]
6214 * [Don't process obligation forest cycles when stalled][37231]
6215 * [Avoid many `CrateConfig` clones][37161]
6216 * [Optimize `Substs::super_fold_with`][37108]
6217 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6218 * [Speed up `plug_leaks`][36917]
6219
6220 Libraries
6221 ---------
6222
6223 * [`println!()`, with no arguments, prints newline][36825].
6224   Previously, an empty string was required to achieve the same.
6225 * [`Wrapping` impls standard binary and unary operators, as well as
6226    the `Sum` and `Product` iterators][37356]
6227 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6228   Vec<T>`][37326]
6229 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6230   `VecDeque` iterators][37315]
6231 * [Improve `SipHasher` performance on small values][37312]
6232 * [Add Iterator trait TrustedLen to enable better FromIterator /
6233   Extend][37306]
6234 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6235 * [`ReadDir` implements `Debug`][37221]
6236 * [Implement `RefUnwindSafe` for atomic types][37178]
6237 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6238 * [Avoid allocations in `Decoder::read_str`][37064]
6239 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6240 * [Impl `Debug` for raw pointers to unsized data][36880]
6241 * [Don't reuse `HashMap` random seeds][37470]
6242 * [The internal memory layout of `HashMap` is more cache-friendly, for
6243   significant improvements in some operations][36692]
6244 * [`HashMap` uses less memory on 32-bit architectures][36595]
6245 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6246
6247 Cargo
6248 -----
6249
6250 * [Expose rustc cfg values to build scripts][cargo/3243]
6251 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6252 * [Fix passing --features when testing multiple packages][cargo/3280]
6253 * [Use a single profile set per workspace][cargo/3249]
6254 * [Load `replace` sections from lock files][cargo/3220]
6255 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6256
6257 Tooling
6258 -------
6259
6260 * [rustup is the recommended Rust installation method][1.14rustup]
6261 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6262   S390x. These are [tier 2] platforms and may have major defects. Follow the
6263   instructions on the website to install, or add the targets to an existing
6264   installation with `rustup target add`. The new target triples are:
6265   - `mips-unknown-linux-gnu`
6266   - `mipsel-unknown-linux-gnu`
6267   - `mips64-unknown-linux-gnuabi64`
6268   - `mips64el-unknown-linux-gnuabi64 `
6269   - `powerpc-unknown-linux-gnu`
6270   - `powerpc64-unknown-linux-gnu`
6271   - `powerpc64le-unknown-linux-gnu`
6272   - `s390x-unknown-linux-gnu `
6273 * This release includes target (std) builds for ARM Linux running MUSL
6274   libc. These are [tier 2] platforms and may have major defects. Add the
6275   following triples to an existing rustup installation with `rustup target add`:
6276   - `arm-unknown-linux-musleabi`
6277   - `arm-unknown-linux-musleabihf`
6278   - `armv7-unknown-linux-musleabihf`
6279 * This release includes [experimental support for WebAssembly][1.14wasm], via
6280   the `wasm32-unknown-emscripten` target. This target is known to have major
6281   defects. Please test, report, and fix.
6282 * rustup no longer installs documentation by default. Run `rustup
6283   component add rust-docs` to install.
6284 * [Fix line stepping in debugger][37310]
6285 * [Enable line number debuginfo in releases][37280]
6286
6287 Misc
6288 ----
6289
6290 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6291 * [Add support for Fuchsia OS][37313]
6292 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6293
6294 Compatibility Notes
6295 -------------------
6296
6297 * [A number of forward-compatibility lints used by the compiler
6298   to gradually introduce language changes have been converted
6299   to deny by default][36894]:
6300   - ["use of inaccessible extern crate erroneously allowed"][36886]
6301   - ["type parameter default erroneously allowed in invalid location"][36887]
6302   - ["detects super or self keywords at the beginning of global path"][36888]
6303   - ["two overlapping inherent impls define an item with the same name
6304     were erroneously allowed"][36889]
6305   - ["floating-point constants cannot be used in patterns"][36890]
6306   - ["constants of struct or enum type can only be used in a pattern if
6307      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6308   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6309 * [Prohibit patterns in trait methods without bodies][37378]
6310 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6311 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6312 * [The `$crate` macro variable is accepted in fewer locations][37213]
6313 * [Impls specifying extra region requirements beyond the trait
6314   they implement are rejected][37167]
6315 * [Enums may not be unsized][37111]. Unsized enums are intended to
6316   work but never have. For now they are forbidden.
6317 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6318
6319 [tier 2]: https://forge.rust-lang.org/platform-support.html
6320 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6321 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6322 [36430]: https://github.com/rust-lang/rust/pull/36430
6323 [36595]: https://github.com/rust-lang/rust/pull/36595
6324 [36595]: https://github.com/rust-lang/rust/pull/36595
6325 [36692]: https://github.com/rust-lang/rust/pull/36692
6326 [36767]: https://github.com/rust-lang/rust/pull/36767
6327 [36794]: https://github.com/rust-lang/rust/pull/36794
6328 [36798]: https://github.com/rust-lang/rust/pull/36798
6329 [36819]: https://github.com/rust-lang/rust/pull/36819
6330 [36822]: https://github.com/rust-lang/rust/pull/36822
6331 [36825]: https://github.com/rust-lang/rust/pull/36825
6332 [36843]: https://github.com/rust-lang/rust/pull/36843
6333 [36880]: https://github.com/rust-lang/rust/pull/36880
6334 [36886]: https://github.com/rust-lang/rust/issues/36886
6335 [36887]: https://github.com/rust-lang/rust/issues/36887
6336 [36888]: https://github.com/rust-lang/rust/issues/36888
6337 [36889]: https://github.com/rust-lang/rust/issues/36889
6338 [36890]: https://github.com/rust-lang/rust/issues/36890
6339 [36891]: https://github.com/rust-lang/rust/issues/36891
6340 [36892]: https://github.com/rust-lang/rust/issues/36892
6341 [36894]: https://github.com/rust-lang/rust/pull/36894
6342 [36917]: https://github.com/rust-lang/rust/pull/36917
6343 [36993]: https://github.com/rust-lang/rust/pull/36993
6344 [37037]: https://github.com/rust-lang/rust/pull/37037
6345 [37064]: https://github.com/rust-lang/rust/pull/37064
6346 [37094]: https://github.com/rust-lang/rust/pull/37094
6347 [37108]: https://github.com/rust-lang/rust/pull/37108
6348 [37111]: https://github.com/rust-lang/rust/pull/37111
6349 [37161]: https://github.com/rust-lang/rust/pull/37161
6350 [37162]: https://github.com/rust-lang/rust/pull/37162
6351 [37167]: https://github.com/rust-lang/rust/pull/37167
6352 [37178]: https://github.com/rust-lang/rust/pull/37178
6353 [37200]: https://github.com/rust-lang/rust/pull/37200
6354 [37213]: https://github.com/rust-lang/rust/pull/37213
6355 [37221]: https://github.com/rust-lang/rust/pull/37221
6356 [37224]: https://github.com/rust-lang/rust/pull/37224
6357 [37230]: https://github.com/rust-lang/rust/pull/37230
6358 [37231]: https://github.com/rust-lang/rust/pull/37231
6359 [37247]: https://github.com/rust-lang/rust/pull/37247
6360 [37267]: https://github.com/rust-lang/rust/pull/37267
6361 [37270]: https://github.com/rust-lang/rust/pull/37270
6362 [37273]: https://github.com/rust-lang/rust/pull/37273
6363 [37280]: https://github.com/rust-lang/rust/pull/37280
6364 [37298]: https://github.com/rust-lang/rust/pull/37298
6365 [37306]: https://github.com/rust-lang/rust/pull/37306
6366 [37310]: https://github.com/rust-lang/rust/pull/37310
6367 [37312]: https://github.com/rust-lang/rust/pull/37312
6368 [37313]: https://github.com/rust-lang/rust/pull/37313
6369 [37315]: https://github.com/rust-lang/rust/pull/37315
6370 [37318]: https://github.com/rust-lang/rust/pull/37318
6371 [37322]: https://github.com/rust-lang/rust/pull/37322
6372 [37326]: https://github.com/rust-lang/rust/pull/37326
6373 [37351]: https://github.com/rust-lang/rust/pull/37351
6374 [37356]: https://github.com/rust-lang/rust/pull/37356
6375 [37367]: https://github.com/rust-lang/rust/pull/37367
6376 [37373]: https://github.com/rust-lang/rust/pull/37373
6377 [37378]: https://github.com/rust-lang/rust/pull/37378
6378 [37389]: https://github.com/rust-lang/rust/pull/37389
6379 [37392]: https://github.com/rust-lang/rust/pull/37392
6380 [37427]: https://github.com/rust-lang/rust/pull/37427
6381 [37439]: https://github.com/rust-lang/rust/pull/37439
6382 [37445]: https://github.com/rust-lang/rust/pull/37445
6383 [37470]: https://github.com/rust-lang/rust/pull/37470
6384 [37569]: https://github.com/rust-lang/rust/pull/37569
6385 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6386 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6387 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6388 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6389 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6390 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6391 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6392
6393
6394 Version 1.13.0 (2016-11-10)
6395 ===========================
6396
6397 Language
6398 --------
6399
6400 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6401   errors, like the `try!` macro, described in [RFC 0243].
6402 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6403 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6404 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6405 * [Fix lifetime rules for 'if' conditions][36029]
6406 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6407
6408 Compiler
6409 --------
6410
6411 * [Add the `-C link-arg` argument][36574]
6412 * [Remove the old AST-based backend from rustc_trans][35764]
6413 * [Don't enable NEON by default on armv7 Linux][35814]
6414 * [Fix debug line number info for macro expansions][35238]
6415 * [Do not emit "class method" debuginfo for types that are not
6416   DICompositeType][36008]
6417 * [Warn about multiple conflicting #[repr] hints][34623]
6418 * [When sizing DST, don't double-count nested struct prefixes][36351]
6419 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6420 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6421 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6422 * [Expand macros without recursing to avoid stack overflows][36214]
6423
6424 Diagnostics
6425 -----------
6426
6427 * [Replace macro backtraces with labeled local uses][35702]
6428 * [Improve error message for misplaced doc comments][33922]
6429 * [Buffer unix and lock windows to prevent message interleaving][35975]
6430 * [Update lifetime errors to specifically note temporaries][36171]
6431 * [Special case a few colors for Windows][36178]
6432 * [Suggest `use self` when such an import resolves][36289]
6433 * [Be more specific when type parameter shadows primitive type][36338]
6434 * Many minor improvements
6435
6436 Compile-time Optimizations
6437 --------------------------
6438
6439 * [Compute and cache HIR hashes at beginning][35854]
6440 * [Don't hash types in loan paths][36004]
6441 * [Cache projections in trans][35761]
6442 * [Optimize the parser's last token handling][36527]
6443 * [Only instantiate #[inline] functions in codegen units referencing
6444   them][36524]. This leads to big improvements in cases where crates export
6445   define many inline functions without using them directly.
6446 * [Lazily allocate TypedArena's first chunk][36592]
6447 * [Don't allocate during default HashSet creation][36734]
6448
6449 Stabilized APIs
6450 ---------------
6451
6452 * [`checked_abs`]
6453 * [`wrapping_abs`]
6454 * [`overflowing_abs`]
6455 * [`RefCell::try_borrow`]
6456 * [`RefCell::try_borrow_mut`]
6457
6458 Libraries
6459 ---------
6460
6461 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6462 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6463   covariant][35354]
6464 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6465 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6466 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6467 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6468 * [Use arc4rand on FreeBSD][35884]
6469 * [memrchr: Correct aligned offset computation][35969]
6470 * [Improve Demangling of Rust Symbols][36059]
6471 * [Use monotonic time in condition variables][35048]
6472 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6473 * [Implement conversion traits for `char`][35755]
6474 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6475 * [Zero first byte of CString on drop][36264]
6476 * [Inherit overflow checks for sum and product][36372]
6477 * [Add missing Eq implementations][36423]
6478 * [Implement `Debug` for `DirEntry`][36631]
6479 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6480   `errno`][36754]
6481 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6482 * [Implement more traits for `std::io::ErrorKind`][35911]
6483 * [Optimize BinaryHeap bounds checking][36072]
6484 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6485   `extend_with_element`][36355]
6486 * [Fix overflow checking in unsigned pow()][34942]
6487
6488 Cargo
6489 -----
6490
6491 * This release includes security fixes to both curl and OpenSSL.
6492 * [Fix transitive doctests when panic=abort][cargo/3021]
6493 * [Add --all-features flag to cargo][cargo/3038]
6494 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6495 * [Don't parse the home directory more than once][cargo/3078]
6496 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6497 * [Update OpenSSL to 1.0.2j][cargo/3121]
6498 * [Add license and license_file to cargo metadata output][cargo/3110]
6499 * [Make crates-io registry URL optional in config; ignore all changes to
6500   source.crates-io][cargo/3089]
6501 * [Don't download dependencies from other platforms][cargo/3123]
6502 * [Build transitive dev-dependencies when needed][cargo/3125]
6503 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6504 * [Avoid updating registry when adding existing deps][cargo/3144]
6505 * [Warn about path overrides that won't work][cargo/3136]
6506 * [Use workspaces during `cargo install`][cargo/3146]
6507 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6508 * [Add --message-format flag][cargo/3000]
6509 * [Pass target environment for rustdoc][cargo/3205]
6510 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6511 * [Update curl and curl-sys][cargo/3241]
6512 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6513
6514 Tooling
6515 -------
6516
6517 * [rustdoc: Add the `--sysroot` argument][36586]
6518 * [rustdoc: Fix a couple of issues with the search results][35655]
6519 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6520 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6521 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6522
6523 Misc
6524 ----
6525
6526 * [Remove unmaintained style guide][35124]
6527 * [Add s390x support][36369]
6528 * [Initial work at Haiku OS support][36727]
6529 * [Add mips-uclibc targets][35734]
6530 * [Crate-ify compiler-rt into compiler-builtins][35021]
6531 * [Add rustc version info (git hash + date) to dist tarball][36213]
6532 * Many documentation improvements
6533
6534 Compatibility Notes
6535 -------------------
6536
6537 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6538 * [Deny (by default) transmuting from fn item types to pointer-sized
6539   types][34923]. Continuing the long transition to zero-sized fn items,
6540   per [RFC 401].
6541 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6542   Part of [RFC 1506].
6543 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6544 * [Fix lifetime rules for 'if' conditions][36029].
6545 * [Inherit overflow checks for sum and product][36372].
6546 * [Forbid user-defined macros named "macro_rules"][36730].
6547
6548 [33922]: https://github.com/rust-lang/rust/pull/33922
6549 [34623]: https://github.com/rust-lang/rust/pull/34623
6550 [34923]: https://github.com/rust-lang/rust/pull/34923
6551 [34942]: https://github.com/rust-lang/rust/pull/34942
6552 [34982]: https://github.com/rust-lang/rust/pull/34982
6553 [35021]: https://github.com/rust-lang/rust/pull/35021
6554 [35048]: https://github.com/rust-lang/rust/pull/35048
6555 [35074]: https://github.com/rust-lang/rust/pull/35074
6556 [35124]: https://github.com/rust-lang/rust/pull/35124
6557 [35234]: https://github.com/rust-lang/rust/pull/35234
6558 [35238]: https://github.com/rust-lang/rust/pull/35238
6559 [35354]: https://github.com/rust-lang/rust/pull/35354
6560 [35559]: https://github.com/rust-lang/rust/pull/35559
6561 [35585]: https://github.com/rust-lang/rust/pull/35585
6562 [35627]: https://github.com/rust-lang/rust/pull/35627
6563 [35655]: https://github.com/rust-lang/rust/pull/35655
6564 [35702]: https://github.com/rust-lang/rust/pull/35702
6565 [35707]: https://github.com/rust-lang/rust/pull/35707
6566 [35728]: https://github.com/rust-lang/rust/pull/35728
6567 [35734]: https://github.com/rust-lang/rust/pull/35734
6568 [35755]: https://github.com/rust-lang/rust/pull/35755
6569 [35761]: https://github.com/rust-lang/rust/pull/35761
6570 [35764]: https://github.com/rust-lang/rust/pull/35764
6571 [35814]: https://github.com/rust-lang/rust/pull/35814
6572 [35854]: https://github.com/rust-lang/rust/pull/35854
6573 [35871]: https://github.com/rust-lang/rust/pull/35871
6574 [35884]: https://github.com/rust-lang/rust/pull/35884
6575 [35911]: https://github.com/rust-lang/rust/pull/35911
6576 [35969]: https://github.com/rust-lang/rust/pull/35969
6577 [35975]: https://github.com/rust-lang/rust/pull/35975
6578 [36004]: https://github.com/rust-lang/rust/pull/36004
6579 [36008]: https://github.com/rust-lang/rust/pull/36008
6580 [36014]: https://github.com/rust-lang/rust/pull/36014
6581 [36029]: https://github.com/rust-lang/rust/pull/36029
6582 [36059]: https://github.com/rust-lang/rust/pull/36059
6583 [36072]: https://github.com/rust-lang/rust/pull/36072
6584 [36101]: https://github.com/rust-lang/rust/pull/36101
6585 [36104]: https://github.com/rust-lang/rust/pull/36104
6586 [36171]: https://github.com/rust-lang/rust/pull/36171
6587 [36173]: https://github.com/rust-lang/rust/pull/36173
6588 [36178]: https://github.com/rust-lang/rust/pull/36178
6589 [36213]: https://github.com/rust-lang/rust/pull/36213
6590 [36214]: https://github.com/rust-lang/rust/pull/36214
6591 [36264]: https://github.com/rust-lang/rust/pull/36264
6592 [36266]: https://github.com/rust-lang/rust/pull/36266
6593 [36289]: https://github.com/rust-lang/rust/pull/36289
6594 [36338]: https://github.com/rust-lang/rust/pull/36338
6595 [36351]: https://github.com/rust-lang/rust/pull/36351
6596 [36355]: https://github.com/rust-lang/rust/pull/36355
6597 [36369]: https://github.com/rust-lang/rust/pull/36369
6598 [36372]: https://github.com/rust-lang/rust/pull/36372
6599 [36423]: https://github.com/rust-lang/rust/pull/36423
6600 [36482]: https://github.com/rust-lang/rust/pull/36482
6601 [36505]: https://github.com/rust-lang/rust/pull/36505
6602 [36524]: https://github.com/rust-lang/rust/pull/36524
6603 [36527]: https://github.com/rust-lang/rust/pull/36527
6604 [36551]: https://github.com/rust-lang/rust/pull/36551
6605 [36574]: https://github.com/rust-lang/rust/pull/36574
6606 [36586]: https://github.com/rust-lang/rust/pull/36586
6607 [36592]: https://github.com/rust-lang/rust/pull/36592
6608 [36631]: https://github.com/rust-lang/rust/pull/36631
6609 [36639]: https://github.com/rust-lang/rust/pull/36639
6610 [36721]: https://github.com/rust-lang/rust/pull/36721
6611 [36727]: https://github.com/rust-lang/rust/pull/36727
6612 [36730]: https://github.com/rust-lang/rust/pull/36730
6613 [36734]: https://github.com/rust-lang/rust/pull/36734
6614 [36754]: https://github.com/rust-lang/rust/pull/36754
6615 [36995]: https://github.com/rust-lang/rust/pull/36995
6616 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6617 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6618 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6619 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6620 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6621 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6622 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6623 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6624 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6625 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6626 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6627 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6628 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6629 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6630 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6631 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6632 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6633 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6634 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6635 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6636 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6637 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6638 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6639 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6640 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6641 [rustup]: https://www.rustup.rs
6642 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6643 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6644 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6645 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6646 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6647 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6648 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6649
6650
6651 Version 1.12.1 (2016-10-20)
6652 ===========================
6653
6654 Regression Fixes
6655 ----------------
6656
6657 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6658 * [Confusion with double negation and booleans][36856]
6659 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6660 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6661 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6662 * [Corrupted memory after updated to 1.12][36936]
6663 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6664 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6665 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6666
6667 [36381]: https://github.com/rust-lang/rust/issues/36381
6668 [36856]: https://github.com/rust-lang/rust/issues/36856
6669 [36875]: https://github.com/rust-lang/rust/issues/36875
6670 [36924]: https://github.com/rust-lang/rust/issues/36924
6671 [36926]: https://github.com/rust-lang/rust/issues/36926
6672 [36936]: https://github.com/rust-lang/rust/issues/36936
6673 [37026]: https://github.com/rust-lang/rust/issues/37026
6674 [37112]: https://github.com/rust-lang/rust/issues/37112
6675 [37153]: https://github.com/rust-lang/rust/issues/37153
6676
6677
6678 Version 1.12.0 (2016-09-29)
6679 ===========================
6680
6681 Highlights
6682 ----------
6683
6684 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6685   This translation pass is far simpler than the previous AST->LLVM pass, and
6686   creates opportunities to perform new optimizations directly on the MIR. It
6687   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6688 * [`rustc` presents a new, more readable error format, along with
6689   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6690   Most common editors supporting Rust have been updated to work with it. It was
6691   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6692
6693 Compiler
6694 --------
6695
6696 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6697   This translation pass is far simpler than the previous AST->LLVM pass, and
6698   creates opportunities to perform new optimizations directly on the MIR. It
6699   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6700 * [Print the Rust target name, not the LLVM target name, with
6701   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6702 * [The computation of `TypeId` is correct in some cases where it was previously
6703   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6704 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6705 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6706   `--print relocation-models`, and `--print code-models` print the available
6707   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6708   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6709 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6710   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6711   These targets produce statically-linked binaries. There are no binary release
6712   builds yet though.
6713
6714 Diagnostics
6715 -----------
6716
6717 * [`rustc` presents a new, more readable error format, along with
6718   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6719   Most common editors supporting Rust have been updated to work with it. It was
6720   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6721 * [In error descriptions, references are now described in plain English,
6722   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6723 * [In error type descriptions, unknown numeric types are named `{integer}` or
6724   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6725 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6726
6727 Language
6728 --------
6729
6730 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6731 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6732 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6733   useful](https://github.com/rust-lang/rust/pull/34908)
6734 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6735   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6736 * [Semicolons are properly required as statement delimiters inside
6737   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6738 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6739
6740 Stabilized APIs
6741 ---------------
6742
6743 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6744 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6745 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6746 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6747 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6748 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6749 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6750 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6751 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6752 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6753   Both on Unix and Windows.
6754 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6755 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6756 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6757 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6758 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6759 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6760 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6761 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6762
6763 Libraries
6764 ---------
6765
6766 * [The `format!` macro and friends now allow a single argument to be formatted
6767   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6768 * [The lifetime bounds on `[T]::binary_search_by` and
6769   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6770 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6771 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6772 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6773 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6774 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6775 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6776 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6777 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6778   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6779 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6780   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6781 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6782 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6783   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6784 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6785 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6786 * [`mpsc::sync_channel` `Receiver`s return any available message before
6787   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6788 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6789 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6790
6791 Cargo
6792 -----
6793
6794 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6795 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6796 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6797 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6798 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6799 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6800 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6801 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6802 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6803 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6804 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6805 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6806 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6807 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6808 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6809 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6810
6811 Performance
6812 -----------
6813
6814 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6815 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6816
6817 Tooling
6818 -------
6819
6820 * [Test binaries now support a `--test-threads` argument to specify the number
6821   of threads used to run tests, and which acts the same as the
6822   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6823 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6824 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6825 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6826 * [Rust releases now come with source packages that can be installed by rustup
6827   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6828   The resulting source code can be used by tools and IDES, located in the
6829   sysroot under `lib/rustlib/src`.
6830
6831 Misc
6832 ----
6833
6834 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6835 * Many minor improvements to the documentation.
6836 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6837
6838 Compatibility Notes
6839 -------------------
6840
6841 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6842   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6843 * [When formatting strings, if "precision" is specified, the "fill",
6844   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6845 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6846
6847
6848 Version 1.11.0 (2016-08-18)
6849 ===========================
6850
6851 Language
6852 --------
6853
6854 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6855 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6856 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6857 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6858
6859 Stabilized APIs
6860 ---------------
6861
6862 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6863 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6864 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6865 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6866 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6867 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6868   (in libcore - previously stabilized in libstd)
6869 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6870   (in libcore - previously stabilized in libstd)
6871 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6872   (in libcore - previously stabilized in libstd)
6873 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6874   (in libcore - previously stabilized in libstd)
6875 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6876 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6877 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6878 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6879
6880 Libraries
6881 ---------
6882
6883 * [The `thread_local!` macro supports multiple definitions in a single
6884    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6885 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6886 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6887   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6888 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6889 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6890 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6891 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6892
6893 Cargo
6894 -----
6895
6896 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6897 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6898 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6899 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6900 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6901   and `-vv` prints warnings for all crates.
6902 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6903 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6904   This provides room for expansion by arbitrary tools.
6905 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6906 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6907 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6908 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6909 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6910 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6911 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6912
6913 Performance
6914 -----------
6915
6916 * [Caching projections speeds up type check dramatically for some
6917   workloads](https://github.com/rust-lang/rust/pull/33816)
6918 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6919   This hasher is faster, but is believed to provide sufficient
6920   protection from collision attacks.
6921 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6922
6923 Rustdoc
6924 -------
6925
6926 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6927 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6928 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6929 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6930 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6931
6932 Tooling
6933 -------
6934
6935 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6936 * [When emitting debug info, rustc emits frame pointers for closures,
6937   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6938 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6939 * Many more errors have been given error codes and extended
6940   explanations
6941 * API documentation continues to be improved, with many new examples
6942
6943 Misc
6944 ----
6945
6946 * [rustc no longer hangs when dependencies recursively re-export
6947   submodules](https://github.com/rust-lang/rust/pull/34542)
6948 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6949 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6950   rewritten](https://github.com/rust-lang/rust/pull/33895)
6951 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6952   No targets use this yet, but it works toward AVR support.
6953
6954 Compatibility Notes
6955 -------------------
6956
6957 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6958 * [The new follow-set rules that place restrictions on `macro_rules!`
6959   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6960   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6961   and has been a warning since 1.10.
6962 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6963   This causes breakage in some corner cases.
6964
6965
6966 Version 1.10.0 (2016-07-07)
6967 ===========================
6968
6969 Language
6970 --------
6971
6972 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6973   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6974 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6975 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6976 * [`panic!` can be converted to a runtime abort with the
6977   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6978   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6979 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6980   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6981   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6982   Note that Cargo does not yet directly support cdylibs.
6983
6984 Stabilized APIs
6985 ---------------
6986
6987 * `os::windows::fs::OpenOptionsExt::access_mode`
6988 * `os::windows::fs::OpenOptionsExt::share_mode`
6989 * `os::windows::fs::OpenOptionsExt::custom_flags`
6990 * `os::windows::fs::OpenOptionsExt::attributes`
6991 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6992 * `os::unix::fs::OpenOptionsExt::custom_flags`
6993 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6994 * `Default for sync::Weak`
6995 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6996 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6997 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6998 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6999 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
7000 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
7001 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
7002 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
7003 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
7004 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
7005 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
7006 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
7007 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
7008 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
7009 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
7010 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
7011 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
7012 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
7013 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
7014 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
7015 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
7016 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
7017 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
7018 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
7019 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
7020 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7021 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7022 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
7023 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
7024 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
7025 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
7026 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
7027 * Read/Write/RawFd impls for `UnixStream`
7028 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
7029 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
7030 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
7031 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
7032 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
7033 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
7034 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
7035 * RawFd impls for `UnixListener`
7036 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
7037 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
7038 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
7039 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
7040 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
7041 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
7042 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
7043 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
7044 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
7045 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
7046 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
7047 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
7048 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
7049 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
7050 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
7051 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
7052 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
7053 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
7054 * RawFd impls for `UnixDatagram`
7055 * `{BTree,Hash}Map::values_mut`
7056 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
7057
7058 Libraries
7059 ---------
7060
7061 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
7062   The semantics of this minor method are subtle and probably not what
7063   most people want.
7064 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
7065 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
7066   will fall back to `/dev/urandom` temporarily to avoid blocking
7067   during early boot](https://github.com/rust-lang/rust/pull/33086).
7068 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
7069 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
7070 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
7071 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
7072 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
7073 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
7074   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
7075
7076 Cargo
7077 -----
7078 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
7079   This controls the runtime behavior of the `panic!` macro
7080   and can be either "unwind" (the default), or "abort".
7081   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
7082 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
7083 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
7084 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
7085   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
7086 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
7087 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
7088 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
7089   By default they are retried twice, which can be customized with the
7090   `net.retry` value in `.cargo/config`.
7091 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
7092 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
7093 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
7094 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
7095   Makes it possible to install multiple crates in parallel.
7096 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
7097 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
7098 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
7099 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
7100 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
7101 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
7102
7103 Performance
7104 -----------
7105
7106 * [rustc memory usage was reduced by refactoring the context used for
7107   type checking](https://github.com/rust-lang/rust/pull/33425).
7108 * [Speed up creation of `HashMap`s by caching the random keys used
7109   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
7110 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
7111 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
7112 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
7113   10x faster than the previous lookup tables.
7114 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
7115
7116 Usability
7117 ---------
7118
7119 * Many incremental improvements to documentation and rustdoc.
7120 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
7121 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
7122 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
7123 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
7124 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
7125 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
7126 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
7127
7128 Misc
7129 ----
7130
7131 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
7132 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
7133 * [`std` no longer prints backtraces on platforms where the running
7134   module must be loaded with `env::current_exe`, which can't be relied
7135   on](https://github.com/rust-lang/rust/pull/33554).
7136 * This release includes std binaries for the i586-unknown-linux-gnu,
7137   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7138   i586 target is for old x86 hardware without SSE2, and the armv7
7139   target is for Android running on modern ARM architectures.
7140 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7141   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7142 * [On Unix the runtime aborts by calling `libc::abort` instead of
7143   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7144 * [Rust is now bootstrapped from the previous release of Rust,
7145   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7146
7147 Compatibility Notes
7148 -------------------
7149
7150 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7151 * [`target_env` for Linux ARM targets is just `gnu`, not
7152   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7153 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7154 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7155 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7156   Affects how macros are parsed.
7157 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7158 * [Feature-gated attributes on macro-generated macro invocations are
7159   now rejected](https://github.com/rust-lang/rust/pull/32791).
7160 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7161   This caused some minor changes to type inference.
7162
7163
7164 Version 1.9.0 (2016-05-26)
7165 ==========================
7166
7167 Language
7168 --------
7169
7170 * The `#[deprecated]` attribute when applied to an API will generate
7171   warnings when used. The warnings may be suppressed with
7172   `#[allow(deprecated)]`. [RFC 1270].
7173 * [`fn` item types are zero sized, and each `fn` names a unique
7174   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7175   `transmute` on a `fn` type will generate a warning for a few cycles,
7176   then will be converted to an error.
7177 * [Field and method resolution understand visibility, so private
7178   fields and methods cannot prevent the proper use of public fields
7179   and methods][1.9fv].
7180 * [The parser considers unicode codepoints in the
7181   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7182
7183 Stabilized APIs
7184 ---------------
7185
7186 * [`std::panic`]
7187 * [`std::panic::catch_unwind`] (renamed from `recover`)
7188 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7189 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7190 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7191 * [`str::is_char_boundary`]
7192 * [`<*const T>::as_ref`]
7193 * [`<*mut T>::as_ref`]
7194 * [`<*mut T>::as_mut`]
7195 * [`AsciiExt::make_ascii_uppercase`]
7196 * [`AsciiExt::make_ascii_lowercase`]
7197 * [`char::decode_utf16`]
7198 * [`char::DecodeUtf16`]
7199 * [`char::DecodeUtf16Error`]
7200 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7201 * [`BTreeSet::take`]
7202 * [`BTreeSet::replace`]
7203 * [`BTreeSet::get`]
7204 * [`HashSet::take`]
7205 * [`HashSet::replace`]
7206 * [`HashSet::get`]
7207 * [`OsString::with_capacity`]
7208 * [`OsString::clear`]
7209 * [`OsString::capacity`]
7210 * [`OsString::reserve`]
7211 * [`OsString::reserve_exact`]
7212 * [`OsStr::is_empty`]
7213 * [`OsStr::len`]
7214 * [`std::os::unix::thread`]
7215 * [`RawPthread`]
7216 * [`JoinHandleExt`]
7217 * [`JoinHandleExt::as_pthread_t`]
7218 * [`JoinHandleExt::into_pthread_t`]
7219 * [`HashSet::hasher`]
7220 * [`HashMap::hasher`]
7221 * [`CommandExt::exec`]
7222 * [`File::try_clone`]
7223 * [`SocketAddr::set_ip`]
7224 * [`SocketAddr::set_port`]
7225 * [`SocketAddrV4::set_ip`]
7226 * [`SocketAddrV4::set_port`]
7227 * [`SocketAddrV6::set_ip`]
7228 * [`SocketAddrV6::set_port`]
7229 * [`SocketAddrV6::set_flowinfo`]
7230 * [`SocketAddrV6::set_scope_id`]
7231 * [`slice::copy_from_slice`]
7232 * [`ptr::read_volatile`]
7233 * [`ptr::write_volatile`]
7234 * [`OpenOptions::create_new`]
7235 * [`TcpStream::set_nodelay`]
7236 * [`TcpStream::nodelay`]
7237 * [`TcpStream::set_ttl`]
7238 * [`TcpStream::ttl`]
7239 * [`TcpStream::set_only_v6`]
7240 * [`TcpStream::only_v6`]
7241 * [`TcpStream::take_error`]
7242 * [`TcpStream::set_nonblocking`]
7243 * [`TcpListener::set_ttl`]
7244 * [`TcpListener::ttl`]
7245 * [`TcpListener::set_only_v6`]
7246 * [`TcpListener::only_v6`]
7247 * [`TcpListener::take_error`]
7248 * [`TcpListener::set_nonblocking`]
7249 * [`UdpSocket::set_broadcast`]
7250 * [`UdpSocket::broadcast`]
7251 * [`UdpSocket::set_multicast_loop_v4`]
7252 * [`UdpSocket::multicast_loop_v4`]
7253 * [`UdpSocket::set_multicast_ttl_v4`]
7254 * [`UdpSocket::multicast_ttl_v4`]
7255 * [`UdpSocket::set_multicast_loop_v6`]
7256 * [`UdpSocket::multicast_loop_v6`]
7257 * [`UdpSocket::set_multicast_ttl_v6`]
7258 * [`UdpSocket::multicast_ttl_v6`]
7259 * [`UdpSocket::set_ttl`]
7260 * [`UdpSocket::ttl`]
7261 * [`UdpSocket::set_only_v6`]
7262 * [`UdpSocket::only_v6`]
7263 * [`UdpSocket::join_multicast_v4`]
7264 * [`UdpSocket::join_multicast_v6`]
7265 * [`UdpSocket::leave_multicast_v4`]
7266 * [`UdpSocket::leave_multicast_v6`]
7267 * [`UdpSocket::take_error`]
7268 * [`UdpSocket::connect`]
7269 * [`UdpSocket::send`]
7270 * [`UdpSocket::recv`]
7271 * [`UdpSocket::set_nonblocking`]
7272
7273 Libraries
7274 ---------
7275
7276 * [`std::sync::Once` is poisoned if its initialization function
7277   fails][1.9o].
7278 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7279 * [Most types implement `fmt::Debug`][1.9db].
7280 * [The default buffer size used by `BufReader` and `BufWriter` was
7281   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7282   used by other languages.
7283 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7284   `Duration` additionally implements `*=` and `/=`][1.9ta].
7285 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7286 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7287 * [`Chain` implements `BufRead`][1.9ch].
7288 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7289
7290 Cargo
7291 -----
7292
7293 * [Cargo can now run concurrently][1.9cc].
7294 * [Top-level overrides allow specific revisions of crates to be
7295   overridden through the entire crate graph][1.9ct].  This is intended
7296   to make upgrades easier for large projects, by allowing crates to be
7297   forked temporarily until they've been upgraded and republished.
7298 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7299 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7300   on the commandline][1.9cf]. `rustc` arguments can also be specified
7301   in the `build.rustflags` configuration key.
7302
7303 Performance
7304 -----------
7305
7306 * [The time complexity of comparing variables for equivalence during type
7307   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7308   to major compilation time improvement in some scenarios.
7309 * [`ToString` is specialized for `str`, giving it the same performance
7310   as `to_owned`][1.9ts].
7311 * [Spawning processes with `Command::output` no longer creates extra
7312   threads][1.9sp].
7313 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7314   for C-like enums][1.9cl].
7315
7316 Misc
7317 ----
7318
7319 * [Passing the `--quiet` flag to a test runner will produce
7320   much-abbreviated output][1.9q].
7321 * The Rust Project now publishes std binaries for the
7322   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7323   `i586-pc-windows-msvc` targets.
7324
7325 Compatibility Notes
7326 -------------------
7327
7328 * [`std::sync::Once` is poisoned if its initialization function
7329   fails][1.9o].
7330 * [It is illegal to define methods with the same name in overlapping
7331   inherent `impl` blocks][1.9sn].
7332 * [`fn` item types are zero sized, and each `fn` names a unique
7333   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7334   `transmute` on a `fn` type will generate a warning for a few cycles,
7335   then will be converted to an error.
7336 * [Improvements to const evaluation may trigger new errors when integer
7337   literals are out of range][1.9ce].
7338
7339
7340 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7341 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7342 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7343 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7344 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7345 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7346 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7347 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7348 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7349 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7350 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7351 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7352 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7353 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7354 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7355 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7356 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7357 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7358 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7359 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7360 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7361 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7362 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7363 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7364 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7365 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7366 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7367 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7368 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7369 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7370 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7371 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7372 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7373 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7374 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7375 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7376 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7377 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7378 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7379 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7380 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7381 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7382 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7383 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7384 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7385 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7386 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7387 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7388 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7389 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7390 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7391 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7392 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7393 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7394 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7395 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7396 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7397 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7398 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7399 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7400 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7401 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7402 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7403 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7404 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7405 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7406 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7407 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7408 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7409 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7410 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7411 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7412 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7413 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7414 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7415 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7416 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7417 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7418 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7419 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7420 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7421 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7422 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7423 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7424 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7425 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7426 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7427 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7428 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7429 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7430 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7431 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7432 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7433 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7434 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7435 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7436 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7437 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7438 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7439 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7440 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7441 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7442 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7443 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7444 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7445 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7446 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7447 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7448 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7449 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7450
7451
7452 Version 1.8.0 (2016-04-14)
7453 ==========================
7454
7455 Language
7456 --------
7457
7458 * Rust supports overloading of compound assignment statements like
7459   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7460   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7461   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7462   traits. [RFC 953].
7463 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7464   addition to the non-braced form, `struct Foo;`. [RFC 218].
7465
7466 Libraries
7467 ---------
7468
7469 * Stabilized APIs:
7470   * [`str::encode_utf16`] (renamed from `utf16_units`)
7471   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7472   * [`Ref::map`]
7473   * [`RefMut::map`]
7474   * [`ptr::drop_in_place`]
7475   * [`time::Instant`]
7476   * [`time::SystemTime`]
7477   * [`Instant::now`]
7478   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7479   * [`Instant::elapsed`]
7480   * [`SystemTime::now`]
7481   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7482   * [`SystemTime::elapsed`]
7483   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7484   * [`SystemTimeError`]
7485   * [`SystemTimeError::duration`]
7486   * Various impls for `SystemTimeError`
7487   * [`UNIX_EPOCH`]
7488   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7489     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7490     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7491 * [The `write!` and `writeln!` macros correctly emit errors if any of
7492   their arguments can't be formatted][1.8w].
7493 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7494 * [The Unix-specific `raw` modules, which contain a number of
7495   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7496   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7497   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7498   across platforms was making it difficult to implement `std`
7499   correctly. Those that need these definitions should use the `libc`
7500   crate. [RFC 1415].
7501 * The Unix-specific `MetadataExt` traits, including
7502   `os::unix::fs::MetadataExt`, which expose values such as inode
7503   numbers [no longer return platform-specific types][1.8r], but
7504   instead return widened integers. [RFC 1415].
7505 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7506 * [Atomic loads and stores are not volatile][1.8a].
7507 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7508
7509 Performance
7510 -----------
7511
7512 * [Inlining hash functions lead to a 3% compile-time improvement in
7513   some workloads][1.8h].
7514 * When using jemalloc, its symbols are [unprefixed so that it
7515   overrides the libc malloc implementation][1.8h]. This means that for
7516   rustc, LLVM is now using jemalloc, which results in a 6%
7517   compile-time improvement on a specific workload.
7518 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7519
7520 Misc
7521 ----
7522
7523 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7524   i686-pc-windows-msvc is now considered a tier-1 platform.
7525 * [The `--print targets` flag prints a list of supported targets][1.8t].
7526 * [The `--print cfg` flag prints the `cfg`s defined for the current
7527   target][1.8cf].
7528 * [`rustc` can be built with an new Cargo-based build system, written
7529   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7530   build system. To enable it configure with `configure --rustbuild`.
7531 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7532   variants while also indicating the total number of missing variants
7533   if more than 3][1.8m].
7534 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7535 * The Rust Project now publishes binary releases of the standard
7536   library for a number of tier-2 targets:
7537   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7538   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7539   `x86_64-rumprun-netbsd`. These can be installed with
7540   tools such as [multirust][1.8mr].
7541
7542 Cargo
7543 -----
7544
7545 * [`cargo init` creates a new Cargo project in the current
7546   directory][1.8ci].  It is otherwise like `cargo new`.
7547 * [Cargo has configuration keys for `-v` and
7548   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7549   `[term]` section of `.cargo/config`.
7550 * [Configuration keys that evaluate to strings or integers can be set
7551   via environment variables][1.8ce]. For example the `build.jobs` key
7552   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7553   precedence over config files.
7554 * [Target-specific dependencies support Rust `cfg` syntax for
7555   describing targets][1.8cfg] so that dependencies for multiple
7556   targets can be specified together. [RFC 1361].
7557 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7558   `RUSTDOC` take precedence over the `build.target-dir`,
7559   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7560 * [The child process tree is killed on Windows when Cargo is
7561   killed][1.8ck].
7562 * [The `build.target` configuration value sets the target platform,
7563   like `--target`][1.8ct].
7564
7565 Compatibility Notes
7566 -------------------
7567
7568 * [Unstable compiler flags have been further restricted][1.8u]. Since
7569   1.0 `-Z` flags have been considered unstable, and other flags that
7570   were considered unstable additionally required passing `-Z
7571   unstable-options` to access. Unlike unstable language and library
7572   features though, these options have been accessible on the stable
7573   release channel. Going forward, *new unstable flags will not be
7574   available on the stable release channel*, and old unstable flags
7575   will warn about their usage. In the future, all unstable flags will
7576   be unavailable on the stable release channel.
7577 * [It is no longer possible to `match` on empty enum variants using
7578   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7579 * The Unix-specific `MetadataExt` traits, including
7580   `os::unix::fs::MetadataExt`, which expose values such as inode
7581   numbers [no longer return platform-specific types][1.8r], but
7582   instead return widened integers. [RFC 1415].
7583 * [Modules sourced from the filesystem cannot appear within arbitrary
7584   blocks, but only within other modules][1.8mf].
7585 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7586 * On Unix, [stack overflow triggers a runtime abort instead of a
7587   SIGSEGV][1.8so].
7588 * [`Command::spawn` and its equivalents return an error if any of
7589   its command-line arguments contain interior `NUL`s][1.8n].
7590 * [Tuple and unit enum variants from other crates are in the type
7591   namespace][1.8tn].
7592 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7593   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7594   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7595   instead of `foo.lib`.
7596
7597
7598 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7599 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7600 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7601 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7602 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7603 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7604 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7605 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7606 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7607 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7608 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7609 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7610 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7611 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7612 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7613 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7614 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7615 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7616 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7617 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7618 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7619 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7620 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7621 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7622 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7623 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7624 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7625 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7626 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7627 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7628 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7629 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7630 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7631 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7632 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7633 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7634 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7635 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7636 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7637 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7638 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7639 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7640 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7641 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7642 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7643 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7644 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7645 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7646 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7647 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7648 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7649 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7650 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7651 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7652 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7653 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7654 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7655 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7656 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7657 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7658
7659
7660 Version 1.7.0 (2016-03-03)
7661 ==========================
7662
7663 Libraries
7664 ---------
7665
7666 * Stabilized APIs
7667   * `Path`
7668     * [`Path::strip_prefix`] (renamed from relative_from)
7669     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7670   * `Ipv4Addr`
7671     * [`Ipv4Addr::is_loopback`]
7672     * [`Ipv4Addr::is_private`]
7673     * [`Ipv4Addr::is_link_local`]
7674     * [`Ipv4Addr::is_multicast`]
7675     * [`Ipv4Addr::is_broadcast`]
7676     * [`Ipv4Addr::is_documentation`]
7677   * `Ipv6Addr`
7678     * [`Ipv6Addr::is_unspecified`]
7679     * [`Ipv6Addr::is_loopback`]
7680     * [`Ipv6Addr::is_multicast`]
7681   * `Vec`
7682     * [`Vec::as_slice`]
7683     * [`Vec::as_mut_slice`]
7684   * `String`
7685     * [`String::as_str`]
7686     * [`String::as_mut_str`]
7687   * Slices
7688     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7689     be the same length
7690     * `<[T]>::`[`sort_by_key`]
7691   * checked, saturated, and overflowing operations
7692     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7693     * [`i32::saturating_mul`]
7694     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7695     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7696     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7697     * [`u32::saturating_mul`]
7698     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7699     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7700     * and checked, saturated, and overflowing operations for other primitive types
7701   * FFI
7702     * [`ffi::IntoStringError`]
7703     * [`CString::into_string`]
7704     * [`CString::into_bytes`]
7705     * [`CString::into_bytes_with_nul`]
7706     * `From<CString> for Vec<u8>`
7707   * `IntoStringError`
7708     * [`IntoStringError::into_cstring`]
7709     * [`IntoStringError::utf8_error`]
7710     * `Error for IntoStringError`
7711   * Hashing
7712     * [`std::hash::BuildHasher`]
7713     * [`BuildHasher::Hasher`]
7714     * [`BuildHasher::build_hasher`]
7715     * [`std::hash::BuildHasherDefault`]
7716     * [`HashMap::with_hasher`]
7717     * [`HashMap::with_capacity_and_hasher`]
7718     * [`HashSet::with_hasher`]
7719     * [`HashSet::with_capacity_and_hasher`]
7720     * [`std::collections::hash_map::RandomState`]
7721     * [`RandomState::new`]
7722 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7723   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7724   from bytes is faster.
7725 * [The performance of `LineWriter` (and thus `io::stdout`) was
7726   improved by using `memchr` to search for newlines][1.7m].
7727 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7728   `f64` variants were stabilized previously.
7729 * [`BTreeMap` was rewritten to use less memory and improve the performance
7730   of insertion and iteration, the latter by as much as 5x][1.7bm].
7731 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7732   covariant over their contained type][1.7bt].
7733 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7734   over their contained type][1.7ll].
7735 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7736   searching methods.
7737 * [`Any` is implemented for unsized types][1.7a].
7738 * [`Hash` is implemented for `Duration`][1.7h].
7739
7740 Misc
7741 ----
7742
7743 * [When running tests with `--test`, rustdoc will pass `--cfg`
7744   arguments to the compiler][1.7dt].
7745 * [The compiler is built with RPATH information by default][1.7rpa].
7746   This means that it will be possible to run `rustc` when installed in
7747   unusual configurations without configuring the dynamic linker search
7748   path explicitly.
7749 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7750   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7751   over `LD_LIBRARY_PATH`.
7752
7753 Cargo
7754 -----
7755
7756 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7757   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7758 * [The `rerun-if-changed` build script directive no longer causes the
7759   build script to incorrectly run twice in certain scenarios][1.7rr].
7760
7761 Compatibility Notes
7762 -------------------
7763
7764 * Soundness fixes to the interactions between associated types and
7765   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7766   code that violates the new rules. This is a significant change that
7767   is known to break existing code, so it has emitted warnings for the
7768   new error cases since 1.4 to give crate authors time to adapt. The
7769   details of what is changing are subtle; read the RFC for more.
7770 * [Several bugs in the compiler's visibility calculations were
7771   fixed][1.7v]. Since this was found to break significant amounts of
7772   code, the new errors will be emitted as warnings for several release
7773   cycles, under the `private_in_public` lint.
7774 * Defaulted type parameters were accidentally accepted in positions
7775   that were not intended. In this release, [defaulted type parameters
7776   appearing outside of type definitions will generate a
7777   warning][1.7d], which will become an error in future releases.
7778 * [Parsing "." as a float results in an error instead of 0][1.7p].
7779   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7780 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7781
7782 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7783 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7784 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7785 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7786 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7787 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7788 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7789 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7790 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7791 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7792 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7793 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7794 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7795 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7796 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7797 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7798 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7799 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7800 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7801 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7802 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7803 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7804 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7805 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7806 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7807 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7808 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7809 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7810 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7811 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7812 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7813 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7814 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7815 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7816 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7817 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7818 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7819 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7820 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7821 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7822 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7823 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7824 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7825 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7826 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7827 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7828 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7829 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7830 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7831 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7832 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7833 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7834 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7835 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7836 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7837 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7838 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7839 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7840 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7841 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7842 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7843 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7844 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7845 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7846 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7847 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7848 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7849 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7850 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7851 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7852 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7853 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7854 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7855 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7856 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7857 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7858 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7859 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7860 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7861
7862
7863 Version 1.6.0 (2016-01-21)
7864 ==========================
7865
7866 Language
7867 --------
7868
7869 * The `#![no_std]` attribute causes a crate to not be linked to the
7870   standard library, but only the [core library][1.6co], as described
7871   in [RFC 1184]. The core library defines common types and traits but
7872   has no platform dependencies whatsoever, and is the basis for Rust
7873   software in environments that cannot support a full port of the
7874   standard library, such as operating systems. Most of the core
7875   library is now stable.
7876
7877 Libraries
7878 ---------
7879
7880 * Stabilized APIs:
7881   [`Read::read_exact`],
7882   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7883   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7884   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7885   [`os::unix::fs::DirBuilderExt`],
7886   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7887   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7888   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7889   [`collections::hash_map::Drain`],
7890   [`collections::hash_map::HashMap::drain`],
7891   [`collections::hash_set::Drain`],
7892   [`collections::hash_set::HashSet::drain`],
7893   [`collections::binary_heap::Drain`],
7894   [`collections::binary_heap::BinaryHeap::drain`],
7895   [`Vec::extend_from_slice`] (renamed from `push_all`),
7896   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7897   [`RwLock::into_inner`],
7898   [`Iterator::min_by_key`] (renamed from `min_by`),
7899   [`Iterator::max_by_key`] (renamed from `max_by`).
7900 * The [core library][1.6co] is stable, as are most of its APIs.
7901 * [The `assert_eq!` macro supports arguments that don't implement
7902   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7903   `assert!`.
7904 * Several timer functions that take duration in milliseconds [are
7905   deprecated in favor of those that take `Duration`][1.6ms]. These
7906   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7907   `thread::park_timeout_ms`.
7908 * The algorithm by which `Vec` reserves additional elements was
7909   [tweaked to not allocate excessive space][1.6a] while still growing
7910   exponentially.
7911 * `From` conversions are [implemented from integers to floats][1.6f]
7912   in cases where the conversion is lossless. Thus they are not
7913   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7914   or `f64`. They are also not implemented for `isize` and `usize`
7915   because the implementations would be platform-specific. `From` is
7916   also implemented from `f32` to `f64`.
7917 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7918 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7919 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7920 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7921   improvements.
7922 * Sorting slices that are already sorted [is 50% faster in some
7923   cases][1.6s].
7924
7925 Cargo
7926 -----
7927
7928 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7929 * Cargo build scripts can specify their dependencies by emitting the
7930   [`rerun-if-changed`][1.6rr] key.
7931 * crates.io will reject publication of crates with dependencies that
7932   have a wildcard version constraint. Crates with wildcard
7933   dependencies were seen to cause a variety of problems, as described
7934   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7935   warning.
7936 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7937   release folder.  A variety of artifacts that Cargo failed to clean
7938   are now correctly deleted.
7939
7940 Misc
7941 ----
7942
7943 * The `unreachable_code` lint [warns when a function call's argument
7944   diverges][1.6dv].
7945 * The parser indicates [failures that may be caused by
7946   confusingly-similar Unicode characters][1.6uc]
7947 * Certain macro errors [are reported at definition time][1.6m], not
7948   expansion.
7949
7950 Compatibility Notes
7951 -------------------
7952
7953 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7954   environment variable when locating crates. This was a pre-cargo
7955   feature for integrating with the package manager that was
7956   accidentally never removed.
7957 * [A number of bugs were fixed in the privacy checker][1.6p] that
7958   could cause previously-accepted code to break.
7959 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7960 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7961   struct pattern syntax (`Foo(..)`) can no longer be used to match
7962   unit structs. This is a warning now, but will become an error in
7963   future releases. Patterns that share the same name as a const are
7964   now an error.
7965 * A bug was fixed that causes [rustc not to apply default type
7966   parameters][1.6xc] when resolving certain method implementations of
7967   traits defined in other crates.
7968
7969 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7970 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7971 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7972 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7973 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7974 [1.6co]: http://doc.rust-lang.org/core/index.html
7975 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7976 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7977 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7978 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7979 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7980 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7981 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7982 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7983 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7984 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7985 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7986 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7987 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7988 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7989 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7990 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7991 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7992 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7993 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7994 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7995 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7996 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7997 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7998 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7999 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
8000 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
8001 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
8002 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
8003 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
8004 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
8005 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
8006 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
8007 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
8008 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
8009 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
8010 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
8011 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
8012 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
8013 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
8014 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
8015 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
8016
8017
8018 Version 1.5.0 (2015-12-10)
8019 ==========================
8020
8021 * ~700 changes, numerous bugfixes
8022
8023 Highlights
8024 ----------
8025
8026 * Stabilized APIs:
8027   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
8028   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
8029   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
8030   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
8031   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
8032   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
8033   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
8034   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
8035   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
8036   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
8037   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
8038   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
8039   [`Path::read_link`], [`Path::symlink_metadata`],
8040   [`Utf8Error::valid_up_to`], [`Vec::resize`],
8041   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
8042   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
8043   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
8044   [`slice::split_first_mut`], [`slice::split_first`],
8045   [`slice::split_last_mut`], [`slice::split_last`],
8046   [`char::from_u32_unchecked`], [`fs::canonicalize`],
8047   [`str::MatchIndices`], [`str::RMatchIndices`],
8048   [`str::match_indices`], [`str::rmatch_indices`],
8049   [`str::slice_mut_unchecked`], [`string::ParseError`].
8050 * Rust applications hosted on crates.io can be installed locally to
8051   `~/.cargo/bin` with the [`cargo install`] command. Among other
8052   things this makes it easier to augment Cargo with new subcommands:
8053   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
8054   invoked as `cargo foo`.
8055 * Crates with wildcard (`*`) dependencies will [emit warnings when
8056   published][1.5w]. In 1.6 it will no longer be possible to publish
8057   crates with wildcard dependencies.
8058
8059 Breaking Changes
8060 ----------------
8061
8062 * The rules determining when a particular lifetime must outlive
8063   a particular value (known as '[dropck]') have been [modified
8064   to not rely on parametricity][1.5p].
8065 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
8066   and `Arc`][1.5a]. Because these smart pointer types implement
8067   `Deref`, this causes breakage in cases where the interior type
8068   contains methods of the same name.
8069 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
8070   that they could drop their content. Soundness fix.
8071 * All method invocations are [properly checked][1.5wf1] for
8072   [well-formedness][1.5wf2]. Soundness fix.
8073 * Traits whose supertraits contain `Self` are [not object
8074   safe][1.5o]. Soundness fix.
8075 * Target specifications support a [`no_default_libraries`][1.5nd]
8076   setting that controls whether `-nodefaultlibs` is passed to the
8077   linker, and in turn the `is_like_windows` setting no longer affects
8078   the `-nodefaultlibs` flag.
8079 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
8080 * The `#[inline]` and `#[repr]` attributes [can only appear
8081   in valid locations][1.5at].
8082 * Native libraries linked from the local crate are [passed to
8083   the linker before native libraries from upstream crates][1.5nl].
8084 * Two rarely-used attributes, `#[no_debug]` and
8085   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
8086 * Negation of unsigned integers, which has been a warning for
8087   several releases, [is now behind a feature gate and will
8088   generate errors][1.5nu].
8089 * The parser accidentally accepted visibility modifiers on
8090   enum variants, a bug [which has been fixed][1.5ev].
8091 * [A bug was fixed that allowed `use` statements to import unstable
8092   features][1.5use].
8093
8094 Language
8095 --------
8096
8097 * When evaluating expressions at compile-time that are not
8098   compile-time constants (const-evaluating expressions in non-const
8099   contexts), incorrect code such as overlong bitshifts and arithmetic
8100   overflow will [generate a warning instead of an error][1.5ce],
8101   delaying the error until runtime. This will allow the
8102   const-evaluator to be expanded in the future backwards-compatibly.
8103 * The `improper_ctypes` lint [no longer warns about using `isize` and
8104   `usize` in FFI][1.5ict].
8105
8106 Libraries
8107 ---------
8108
8109 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
8110   invariant][1.5c].
8111 * `Default` is [implemented for mutable slices][1.5d].
8112 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
8113 * There are now `From` conversions [between floating point
8114   types][1.5f] where the conversions are lossless.
8115 * There are now `From` conversions [between integer types][1.5i] where
8116   the conversions are lossless.
8117 * [`fs::Metadata` implements `Clone`][1.5fs].
8118 * The `parse` method [accepts a leading "+" when parsing
8119   integers][1.5pi].
8120 * [`AsMut` is implemented for `Vec`][1.5am].
8121 * The `clone_from` implementations for `String` and `BinaryHeap` [have
8122   been optimized][1.5cf] and no longer rely on the default impl.
8123 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
8124   `unsafe extern "C"` function types now [implement `Clone`,
8125   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
8126   `fmt::Debug` for up to 12 arguments][1.5fp].
8127 * [Dropping `Vec`s is much faster in unoptimized builds when the
8128   element types don't implement `Drop`][1.5dv].
8129 * A bug that caused in incorrect behavior when [combining `VecDeque`
8130   with zero-sized types][1.5vdz] was resolved.
8131 * [`PartialOrd` for slices is faster][1.5po].
8132
8133 Miscellaneous
8134 -------------
8135
8136 * [Crate metadata size was reduced by 20%][1.5md].
8137 * [Improvements to code generation reduced the size of libcore by 3.3
8138   MB and rustc's memory usage by 18MB][1.5m].
8139 * [Improvements to deref translation increased performance in
8140   unoptimized builds][1.5dr].
8141 * Various errors in trait resolution [are deduplicated to only be
8142   reported once][1.5te].
8143 * Rust has preliminary [support for rumprun kernels][1.5rr].
8144 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8145
8146 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8147 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8148 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8149 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8150 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8151 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8152 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8153 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8154 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8155 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8156 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8157 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8158 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8159 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8160 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8161 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8162 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8163 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8164 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8165 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8166 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8167 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8168 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8169 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8170 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8171 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8172 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8173 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8174 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8175 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8176 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8177 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8178 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8179 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8180 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8181 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8182 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8183 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8184 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8185 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8186 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8187 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8188 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8189 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8190 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8191 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8192 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8193 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8194 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8195 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8196 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8197 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8198 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8199 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8200 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8201 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8202 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8203 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8204 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8205 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8206 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8207 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8208 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8209 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8210 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8211 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8212 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8213 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8214 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8215 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8216 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8217 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8218 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8219 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8220 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8221 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8222 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8223 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8224 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8225 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8226 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8227 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8228 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8229 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8230 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8231 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8232 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8233 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8234 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8235
8236 Version 1.4.0 (2015-10-29)
8237 ==========================
8238
8239 * ~1200 changes, numerous bugfixes
8240
8241 Highlights
8242 ----------
8243
8244 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8245   GNU) are now supported and recommended for use.
8246
8247 Breaking Changes
8248 ----------------
8249
8250 * [Several changes have been made to fix type soundness and improve
8251   the behavior of associated types][sound]. See [RFC 1214]. Although
8252   we have mostly introduced these changes as warnings this release, to
8253   become errors next release, there are still some scenarios that will
8254   see immediate breakage.
8255 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8256   line breaks in addition to `\n`][crlf].
8257 * [Loans of `'static` lifetime extend to the end of a function][stat].
8258 * [`str::parse` no longer introduces avoidable rounding error when
8259   parsing floating point numbers. Together with earlier changes to
8260   float formatting/output, "round trips" like f.to_string().parse()
8261   now preserve the value of f exactly. Additionally, leading plus
8262   signs are now accepted][fp3].
8263
8264
8265 Language
8266 --------
8267
8268 * `use` statements that import multiple items [can now rename
8269   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8270 * [Binops work correctly on fat pointers][binfat].
8271 * `pub extern crate`, which does not behave as expected, [issues a
8272   warning][pec] until a better solution is found.
8273
8274 Libraries
8275 ---------
8276
8277 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8278   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8279   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8280   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8281   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8282   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8283   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8284   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8285   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8286   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8287   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8288   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8289   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8290   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8291   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8292   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8293   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8294   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8295   [`thread::sleep`].
8296 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8297   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8298   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8299   `f64::from_str_radix`.
8300 * [Reverse-searching strings is faster with the 'two-way'
8301   algorithm][s].
8302 * [`std::io::copy` allows `?Sized` arguments][cc].
8303 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8304   [override `count`, `nth` and `last` with an O(1)
8305   implementation][it].
8306 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8307 * [`IntoRawFd` has been added to the Unix-specific prelude,
8308   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8309   prelude][pr].
8310 * [`Extend<String>` and `FromIterator<String` are both implemented for
8311   `String`][es].
8312 * [`IntoIterator` is implemented for references to `Option` and
8313   `Result`][into2].
8314 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8315   Copy`][ext] as part of [RFC 839]. This will cause type inference
8316   breakage in rare situations.
8317 * [`BinaryHeap` implements `Debug`][bh2].
8318 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8319   arrays][bm].
8320 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8321   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8322 * [String comparison is faster][faststr].
8323 * `&mut T` where `T: std::fmt::Write` [also implements
8324   `std::fmt::Write`][mutw].
8325 * [A stable regression in `VecDeque::push_back` and other
8326   capacity-altering methods that caused panics for zero-sized types
8327   was fixed][vd].
8328 * [Function pointers implement traits for up to 12 parameters][fp2].
8329
8330 Miscellaneous
8331 -------------
8332
8333 * The compiler [no longer uses the 'morestack' feature to prevent
8334   stack overflow][mm]. Instead it uses guard pages and stack
8335   probes (though stack probes are not yet implemented on any platform
8336   but Windows).
8337 * [The compiler matches traits faster when projections are involved][p].
8338 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8339   `usize`][ffi].
8340 * [Cargo now displays useful information about what its doing during
8341   `cargo update`][cu].
8342
8343 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8344 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8345 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8346 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8347 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8348 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8349 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8350 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8351 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8352 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8353 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8354 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8355 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8356 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8357 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8358 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8359 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8360 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8361 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8362 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8363 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8364 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8365 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8366 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8367 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8368 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8369 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8370 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8371 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8372 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8373 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8374 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8375 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8376 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8377 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8378 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8379 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8380 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8381 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8382 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8383 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8384 [bh2]: https://github.com/rust-lang/rust/pull/28156
8385 [binfat]: https://github.com/rust-lang/rust/pull/28270
8386 [bm]: https://github.com/rust-lang/rust/pull/28197
8387 [cc]: https://github.com/rust-lang/rust/pull/27531
8388 [crlf]: https://github.com/rust-lang/rust/pull/28034
8389 [cu]: https://github.com/rust-lang/cargo/pull/1931
8390 [d]: https://github.com/rust-lang/rust/pull/27825
8391 [dep]: https://github.com/rust-lang/rust/pull/28339
8392 [es]: https://github.com/rust-lang/rust/pull/27956
8393 [ext]: https://github.com/rust-lang/rust/pull/28094
8394 [faststr]: https://github.com/rust-lang/rust/pull/28338
8395 [ffi]: https://github.com/rust-lang/rust/pull/28779
8396 [fp]: https://github.com/rust-lang/rust/pull/28268
8397 [fp2]: https://github.com/rust-lang/rust/pull/28560
8398 [fp3]: https://github.com/rust-lang/rust/pull/27307
8399 [i]: https://github.com/rust-lang/rust/pull/27451
8400 [into2]: https://github.com/rust-lang/rust/pull/28039
8401 [it]: https://github.com/rust-lang/rust/pull/27652
8402 [mm]: https://github.com/rust-lang/rust/pull/27338
8403 [mutw]: https://github.com/rust-lang/rust/pull/28368
8404 [sound]: https://github.com/rust-lang/rust/pull/27641
8405 [p]: https://github.com/rust-lang/rust/pull/27866
8406 [pec]: https://github.com/rust-lang/rust/pull/28486
8407 [pr]: https://github.com/rust-lang/rust/pull/27896
8408 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8409 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8410 [s]: https://github.com/rust-lang/rust/pull/27474
8411 [stab]: https://github.com/rust-lang/rust/pull/28339
8412 [stat]: https://github.com/rust-lang/rust/pull/28321
8413 [vd]: https://github.com/rust-lang/rust/pull/28494
8414
8415 Version 1.3.0 (2015-09-17)
8416 ==============================
8417
8418 * ~900 changes, numerous bugfixes
8419
8420 Highlights
8421 ----------
8422
8423 * The [new object lifetime defaults][nold] have been [turned
8424   on][nold2] after a cycle of warnings about the change. Now types
8425   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8426   being interpreted as `&'a Box<Trait+'a>` to `&'a
8427   Box<Trait+'static>`.
8428 * [The Rustonomicon][nom] is a new book in the official documentation
8429   that dives into writing unsafe Rust.
8430 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8431   timekeeping is employed by other std APIs, as well as out-of-tree
8432   time crates.
8433
8434 Breaking Changes
8435 ----------------
8436
8437 * The [new object lifetime defaults][nold] have been [turned
8438   on][nold2] after a cycle of warnings about the change.
8439 * There is a known [regression][lr] in how object lifetime elision is
8440   interpreted, the proper solution for which is undetermined.
8441 * The `#[prelude_import]` attribute, an internal implementation
8442   detail, was accidentally stabilized previously. [It has been put
8443   behind the `prelude_import` feature gate][pi]. This change is
8444   believed to break no existing code.
8445 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8446   [more sane for dynamically sized types][dst3]. Code that relied on
8447   the previous behavior is thought to be broken.
8448 * The `dropck` rules, which checks that destructors can't access
8449   destroyed values, [have been updated][dropck] to match the
8450   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8451   cause some previously-compiling code to no longer build.
8452
8453 Language
8454 --------
8455
8456 * The [new object lifetime defaults][nold] have been [turned
8457   on][nold2] after a cycle of warnings about the change.
8458 * Semicolons may [now follow types and paths in
8459   macros](https://github.com/rust-lang/rust/pull/27000).
8460 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8461   [more sane for dynamically sized types][dst3]. Code that relied on
8462   the previous behavior is not known to exist, and suspected to be
8463   broken.
8464 * `'static` variables [may now be recursive][st].
8465 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8466   implementations correctly.
8467 * The `dropck` rules, which checks that destructors can't access
8468   destroyed values, [have been updated][dropck] to match the
8469   [RFC][dropckrfc].
8470
8471 Libraries
8472 ---------
8473
8474 * The [`Duration`] API, [has been stabilized][ds], as well as the
8475   `std::time` module, which presently contains only `Duration`.
8476 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8477 * The owned C string, [`CString`], implements [`Borrow`] and the
8478   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8479   these allow C strings to be borrowed and cloned in generic code.
8480 * [`CStr`] implements [`Debug`].
8481 * [`AtomicPtr`] implements [`Debug`].
8482 * [`Error`] trait objects [can be downcast to their concrete types][e]
8483   in many common configurations, using the [`is`], [`downcast`],
8484   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8485   [`Any`] trait.
8486 * Searching for substrings now [employs the two-way algorithm][search]
8487   instead of doing a naive search. This gives major speedups to a
8488   number of methods, including [`contains`][sc], [`find`][sf],
8489   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8490   [`ends_with`][sew] are also faster.
8491 * The performance of `PartialEq` for slices is [much faster][ps].
8492 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8493   is overridden and optimized by the implementations for scalars.
8494 * The [`Hasher`] trait now has a number of specialized `write_*`
8495   methods for primitive types, for efficiency.
8496 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8497   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8498   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8499   of [`std::error::Error::cause`][iec] also delegates to the inner
8500   error.
8501 * [`process::Child`][pc] gained the [`id`] method, which returns a
8502   `u32` representing the platform-specific process identifier.
8503 * The [`connect`] method on slices is deprecated, replaced by the new
8504   [`join`] method (note that both of these are on the *unstable*
8505   [`SliceConcatExt`] trait, but through the magic of the prelude are
8506   available to stable code anyway).
8507 * The [`Div`] operator is implemented for [`Wrapping`] types.
8508 * [`DerefMut` is implemented for `String`][dms].
8509 * Performance of SipHash (the default hasher for `HashMap`) is
8510   [better for long data][sh].
8511 * [`AtomicPtr`] implements [`Send`].
8512 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8513   are now [specialized to use uninitialized buffers for increased
8514   performance][rte].
8515 * Lifetime parameters of foreign functions [are now resolved
8516   properly][f].
8517
8518 Misc
8519 ----
8520
8521 * Rust can now, with some coercion, [produce programs that run on
8522   Windows XP][xp], though XP is not considered a supported platform.
8523 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8524   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8525   recommended for use in 1.3, though should be fully-functional
8526   in the [64-bit 1.4 beta][b14].
8527 * On Fedora-based systems installation will [properly configure the
8528   dynamic linker][fl].
8529 * The compiler gained many new extended error descriptions, which can
8530   be accessed with the `--explain` flag.
8531 * The `dropck` pass, which checks that destructors can't access
8532   destroyed values, [has been rewritten][dropck]. This fixes some
8533   soundness holes, and as such will cause some previously-compiling
8534   code to no longer build.
8535 * `rustc` now uses [LLVM to write archive files where possible][ar].
8536   Eventually this will eliminate the compiler's dependency on the ar
8537   utility.
8538 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8539   supported FreeBSD on x86_64).
8540 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8541   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8542   more strict.
8543 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8544   will kill the process instead of leaking][nlp].
8545
8546 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8547 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8548 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8549 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8550 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8551 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8552 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8553 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8554 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8555 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8556 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8557 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8558 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8559 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8560 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8561 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8562 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8563 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8564 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8565 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8566 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8567 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8568 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8569 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8570 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8571 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8572 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8573 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8574 [ar]: https://github.com/rust-lang/rust/pull/26926
8575 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8576 [dms]: https://github.com/rust-lang/rust/pull/26241
8577 [dropck]: https://github.com/rust-lang/rust/pull/27261
8578 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8579 [ds]: https://github.com/rust-lang/rust/pull/26818
8580 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8581 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8582 [dst3]: https://github.com/rust-lang/rust/pull/27351
8583 [e]: https://github.com/rust-lang/rust/pull/24793
8584 [f]: https://github.com/rust-lang/rust/pull/26588
8585 [fb]: https://github.com/rust-lang/rust/pull/26959
8586 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8587 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8588 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8589 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8590 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8591 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8592 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8593 [lic]: https://github.com/rust-lang/rust/pull/26583
8594 [lnu]: https://github.com/rust-lang/rust/pull/27026
8595 [lr]: https://github.com/rust-lang/rust/issues/27248
8596 [lum]: https://github.com/rust-lang/rust/pull/26378
8597 [lur]: https://github.com/rust-lang/rust/pull/26783
8598 [nlp]: https://github.com/rust-lang/rust/pull/27176
8599 [nold2]: https://github.com/rust-lang/rust/pull/27045
8600 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8601 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8602 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8603 [pi]: https://github.com/rust-lang/rust/pull/26699
8604 [ps]: https://github.com/rust-lang/rust/pull/26884
8605 [rte]: https://github.com/rust-lang/rust/pull/26950
8606 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8607 [search]: https://github.com/rust-lang/rust/pull/26327
8608 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8609 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8610 [sh]: https://github.com/rust-lang/rust/pull/27280
8611 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8612 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8613 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8614 [st]: https://github.com/rust-lang/rust/pull/26630
8615 [win1]: https://github.com/rust-lang/rust/pull/26569
8616 [win2]: https://github.com/rust-lang/rust/pull/26741
8617 [win3]: https://github.com/rust-lang/rust/pull/26741
8618 [win4]: https://github.com/rust-lang/rust/pull/27210
8619 [xp]: https://github.com/rust-lang/rust/pull/26569
8620
8621 Version 1.2.0 (2015-08-07)
8622 ==========================
8623
8624 * ~1200 changes, numerous bugfixes
8625
8626 Highlights
8627 ----------
8628
8629 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8630   like `Rc` to contain types without a fixed size, arrays and trait
8631   objects, finally enabling use of `Rc<[T]>` and completing the
8632   implementation of DST.
8633 * [Parallel codegen][parcodegen] is now working again, which can
8634   substantially speed up large builds in debug mode; It also gets
8635   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8636   jobs). It's not enabled by default, but will be "in the near
8637   future". It can be activated with the `-C codegen-units=N` flag to
8638   `rustc`.
8639 * This is the first release with [experimental support for linking
8640   with the MSVC linker and lib C on Windows (instead of using the GNU
8641   variants via MinGW)][win]. It is yet recommended only for the most
8642   intrepid Rustaceans.
8643 * Benchmark compilations are showing a 30% improvement in
8644   bootstrapping over 1.1.
8645
8646 Breaking Changes
8647 ----------------
8648
8649 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8650   unicode case mapping, which is a previously-planned change in
8651   behavior and considered a bugfix.
8652 * [`mem::align_of`] now specifies [the *minimum alignment* for
8653   T][align], which is usually the alignment programs are interested
8654   in, and the same value reported by clang's
8655   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8656   break real code.
8657 * [The `#[packed]` attribute is no longer silently accepted by the
8658   compiler][packed]. This attribute did nothing and code that
8659   mentioned it likely did not work as intended.
8660 * Associated type defaults are [now behind the
8661   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8662   defaults *did not work*, but could be mentioned syntactically. As
8663   such this breakage has minimal impact.
8664
8665 Language
8666 --------
8667
8668 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8669   matching against dereferenceable values.
8670
8671 Libraries
8672 ---------
8673
8674 * The [`Extend`] trait, which grows a collection from an iterator, is
8675   implemented over iterators of references, for `String`, `Vec`,
8676   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8677   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8678 * The [`iter::once`] function returns an iterator that yields a single
8679   element, and [`iter::empty`] returns an iterator that yields no
8680   elements.
8681 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8682   over substring matches.
8683 * [`Cell`] and [`RefCell`] both implement `Eq`.
8684 * A number of methods for wrapping arithmetic are added to the
8685   integral types, [`wrapping_div`], [`wrapping_rem`],
8686   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8687   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8688   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8689   type.. It is illegal for the default arithmetic operations in Rust
8690   to overflow; the desire to wrap must be explicit.
8691 * The `{:#?}` formatting specifier [displays the alternate,
8692   pretty-printed][debugfmt] form of the `Debug` formatter. This
8693   feature was actually introduced prior to 1.0 with little
8694   fanfare.
8695 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8696   for writing data to formatted strings, similar to [`io::Write`].
8697 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8698   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8699   are used by code generators to emit implementations of [`Debug`].
8700 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8701   methods that convert case, following Unicode case mapping.
8702 * It is now easier to handle poisoned locks. The [`PoisonError`]
8703   type, returned by failing lock operations, exposes `into_inner`,
8704   `get_ref`, and `get_mut`, which all give access to the inner lock
8705   guard, and allow the poisoned lock to continue to operate. The
8706   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8707   poisoned lock without attempting to take the lock.
8708 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8709   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8710   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8711   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8712   `ChildStderr`.
8713 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8714   malformed input.
8715
8716 Misc
8717 ----
8718
8719 * `rustc` employs smarter heuristics for guessing at [typos].
8720 * `rustc` emits more efficient code for [no-op conversions between
8721   unsafe pointers][nop].
8722 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8723   resulting in faster compile times and smaller code.
8724
8725 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8726 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8727 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8728 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8729 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8730 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8731 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8732 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8733 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8734 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8735 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8736 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8737 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8738 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8739 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8740 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8741 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8742 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8743 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8744 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8745 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8746 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8747 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8748 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8749 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8750 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8751 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8752 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8753 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8754 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8755 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8756 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8757 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8758 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8759 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8760 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8761 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8762 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8763 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8764 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8765 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8766 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8767 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8768 [align]: https://github.com/rust-lang/rust/pull/25646
8769 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8770 [typos]: https://github.com/rust-lang/rust/pull/26087
8771 [nop]: https://github.com/rust-lang/rust/pull/26336
8772 [fat]: https://github.com/rust-lang/rust/pull/26411
8773 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8774 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8775 [packed]: https://github.com/rust-lang/rust/pull/25541
8776 [ad]: https://github.com/rust-lang/rust/pull/27382
8777 [win]: https://github.com/rust-lang/rust/pull/25350
8778
8779 Version 1.1.0 (2015-06-25)
8780 =========================
8781
8782 * ~850 changes, numerous bugfixes
8783
8784 Highlights
8785 ----------
8786
8787 * The [`std::fs` module has been expanded][fs] to expand the set of
8788   functionality exposed:
8789   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8790     don't incur a syscall on some platforms.
8791   * A `symlink_metadata` function has been added.
8792   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8793     access to all underlying information.
8794 * The compiler now contains extended explanations of many errors. When an error
8795   with an explanation occurs the compiler suggests using the `--explain` flag
8796   to read the explanation. Error explanations are also [available online][err-index].
8797 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8798   well as other work, the time to bootstrap the compiler decreased by
8799   32%.
8800
8801 Libraries
8802 ---------
8803
8804 * The [`str::split_whitespace`] method splits a string on unicode
8805   whitespace boundaries.
8806 * On both Windows and Unix, new extension traits provide conversion of
8807   I/O types to and from the underlying system handles. On Unix, these
8808   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8809   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8810   `TcpListener`, and `UpdSocket`. Further implementations for
8811   `std::process` will be stabilized later.
8812 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8813   Windows, symlinks can be created with
8814   `std::os::windows::symlink_dir` and
8815   `std::os::windows::symlink_file`.
8816 * The `mpsc::Receiver` type can now be converted into an iterator with
8817   `into_iter` on the [`IntoIterator`] trait.
8818 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8819   implementation of the [`From`] trait.
8820 * The `Debug` implementation for `RangeFull` [creates output that is
8821   more consistent with other implementations][rf].
8822 * [`Debug` is implemented for `File`][file].
8823 * The `Default` implementation for `Arc` [no longer requires `Sync +
8824   Send`][arc].
8825 * [The `Iterator` methods `count`, `nth`, and `last` have been
8826   overridden for slices to have O(1) performance instead of O(n)][si].
8827 * Incorrect handling of paths on Windows has been improved in both the
8828   compiler and the standard library.
8829 * [`AtomicPtr` gained a `Default` implementation][ap].
8830 * In accordance with Rust's policy on arithmetic overflow `abs` now
8831   [panics on overflow when debug assertions are enabled][abs].
8832 * The [`Cloned`] iterator, which was accidentally left unstable for
8833   1.0 [has been stabilized][c].
8834 * The [`Incoming`] iterator, which iterates over incoming TCP
8835   connections, and which was accidentally unnamable in 1.0, [is now
8836   properly exported][inc].
8837 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8838   `sift_up` or `sift_down` panic][bh].
8839 * The [`split_off`] method of `LinkedList` [no longer corrupts
8840   the list in certain scenarios][ll].
8841
8842 Misc
8843 ----
8844
8845 * Type checking performance [has improved notably][sk] with
8846   [multiple improvements][pre].
8847 * The compiler [suggests code changes][ch] for more errors.
8848 * rustc and it's build system have experimental support for [building
8849   toolchains against MUSL][m] instead of glibc on Linux.
8850 * The compiler defines the `target_env` cfg value, which is used for
8851   distinguishing toolchains that are otherwise for the same
8852   platform. Presently this is set to `gnu` for common GNU Linux
8853   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8854 * The [`cargo rustc`][crc] command invokes a build with custom flags
8855   to rustc.
8856 * [Android executables are always position independent][pie].
8857 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8858   with `Drop`][drop].
8859
8860 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8861 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8862 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8863 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8864 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8865 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8866 [rf]: https://github.com/rust-lang/rust/pull/24491
8867 [err-index]: https://doc.rust-lang.org/error-index.html
8868 [sk]: https://github.com/rust-lang/rust/pull/24615
8869 [pre]: https://github.com/rust-lang/rust/pull/25323
8870 [file]: https://github.com/rust-lang/rust/pull/24598
8871 [ch]: https://github.com/rust-lang/rust/pull/24683
8872 [arc]: https://github.com/rust-lang/rust/pull/24695
8873 [si]: https://github.com/rust-lang/rust/pull/24701
8874 [ap]: https://github.com/rust-lang/rust/pull/24834
8875 [m]: https://github.com/rust-lang/rust/pull/24777
8876 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8877 [crc]: https://github.com/rust-lang/cargo/pull/1568
8878 [pie]: https://github.com/rust-lang/rust/pull/24953
8879 [abs]: https://github.com/rust-lang/rust/pull/25441
8880 [c]: https://github.com/rust-lang/rust/pull/25496
8881 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8882 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8883 [inc]: https://github.com/rust-lang/rust/pull/25522
8884 [bh]: https://github.com/rust-lang/rust/pull/25856
8885 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8886 [ll]: https://github.com/rust-lang/rust/pull/26022
8887 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8888 [drop]: https://github.com/rust-lang/rust/pull/24935
8889
8890 Version 1.0.0 (2015-05-15)
8891 ========================
8892
8893 * ~1500 changes, numerous bugfixes
8894
8895 Highlights
8896 ----------
8897
8898 * The vast majority of the standard library is now `#[stable]`. It is
8899   no longer possible to use unstable features with a stable build of
8900   the compiler.
8901 * Many popular crates on [crates.io] now work on the stable release
8902   channel.
8903 * Arithmetic on basic integer types now [checks for overflow in debug
8904   builds][overflow].
8905
8906 Language
8907 --------
8908
8909 * Several [restrictions have been added to trait coherence][coh] in
8910   order to make it easier for upstream authors to change traits
8911   without breaking downstream code.
8912 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8913   improve error messages and macro behavior. For example, `0b1234` is
8914   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8915 * Trait bounds [are always invariant][inv], eliminating the need for
8916   the `PhantomFn` and `MarkerTrait` lang items, which have been
8917   removed.
8918 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8919   "foo" as bar` syntax has been replaced with `extern crate foo as
8920   bar`, and Cargo now automatically translates "-" in *package* names
8921   to underscore for the crate name.
8922 * [Lifetime shadowing is an error][lt].
8923 * [`Send` no longer implies `'static`][send-rfc].
8924 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8925   `MyType::default()`.
8926 * Primitive types [now have inherent methods][prim-inherent],
8927   obviating the need for extension traits like `SliceExt`.
8928 * Methods with `Self: Sized` in their `where` clause are [considered
8929   object-safe][self-sized], allowing many extension traits like
8930   `IteratorExt` to be merged into the traits they extended.
8931 * You can now [refer to associated types][assoc-where] whose
8932   corresponding trait bounds appear only in a `where` clause.
8933 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8934   like `Send` and `Sync` are now library-defined.
8935 * A [Reflect trait][reflect] was introduced, which means that
8936   downcasting via the `Any` trait is effectively limited to concrete
8937   types. This helps retain the potentially-important "parametricity"
8938   property: generic code cannot behave differently for different type
8939   arguments except in minor ways.
8940 * The `unsafe_destructor` feature is now deprecated in favor of the
8941   [new `dropck`][dropck]. This change is a major reduction in unsafe
8942   code.
8943
8944 Libraries
8945 ---------
8946
8947 * The `thread_local` module [has been renamed to `std::thread`][th].
8948 * The methods of `IteratorExt` [have been moved to the `Iterator`
8949   trait itself][ie].
8950 * Several traits that implement Rust's conventions for type
8951   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8952   [centralized in the `std::convert` module][con].
8953 * The `FromError` trait [was removed in favor of `From`][fe].
8954 * The basic sleep function [has moved to
8955   `std::thread::sleep_ms`][slp].
8956 * The `splitn` function now takes an `n` parameter that represents the
8957   number of items yielded by the returned iterator [instead of the
8958   number of 'splits'][spl].
8959 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8960 * [Derived implementations of `PartialOrd` now order enums according
8961   to their explicitly-assigned discriminants][po].
8962 * [Methods for searching strings are generic over `Pattern`s][pat],
8963   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8964   some others.
8965 * [In method resolution, object methods are resolved before inherent
8966   methods][meth].
8967 * [`String::from_str` has been deprecated in favor of the `From` impl,
8968   `String::from`][sf].
8969 * [`io::Error` implements `Sync`][ios].
8970 * [The `words` method on `&str` has been replaced with
8971   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8972   a word?'
8973 * The new path and IO modules are complete and `#[stable]`. This
8974   was the major library focus for this cycle.
8975 * The path API was [revised][path-normalize] to normalize `.`,
8976   adjusting the tradeoffs in favor of the most common usage.
8977 * A large number of remaining APIs in `std` were also stabilized
8978   during this cycle; about 75% of the non-deprecated API surface
8979   is now stable.
8980 * The new [string pattern API][string-pattern] landed, which makes
8981   the string slice API much more internally consistent and flexible.
8982 * A new set of [generic conversion traits][conversion] replaced
8983   many existing ad hoc traits.
8984 * Generic numeric traits were [completely removed][num-traits]. This
8985   was made possible thanks to inherent methods for primitive types,
8986   and the removal gives maximal flexibility for designing a numeric
8987   hierarchy in the future.
8988 * The `Fn` traits are now related via [inheritance][fn-inherit]
8989   and provide ergonomic [blanket implementations][fn-blanket].
8990 * The `Index` and `IndexMut` traits were changed to
8991   [take the index by value][index-value], enabling code like
8992   `hash_map["string"]` to work.
8993 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8994   `Copy` data is known to be `Clone` as well.
8995
8996 Misc
8997 ----
8998
8999 * Many errors now have extended explanations that can be accessed with
9000   the `--explain` flag to `rustc`.
9001 * Many new examples have been added to the standard library
9002   documentation.
9003 * rustdoc has received a number of improvements focused on completion
9004   and polish.
9005 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
9006 * Much headway was made on ecosystem-wide CI, making it possible
9007   to [compare builds for breakage][ci-compare].
9008
9009
9010 [crates.io]: http://crates.io
9011 [clo]: https://github.com/rust-lang/rust/pull/24034
9012 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
9013 [con]: https://github.com/rust-lang/rust/pull/23875
9014 [cr]: https://github.com/rust-lang/rust/pull/23419
9015 [fe]: https://github.com/rust-lang/rust/pull/23879
9016 [ie]: https://github.com/rust-lang/rust/pull/23300
9017 [inv]: https://github.com/rust-lang/rust/pull/23938
9018 [ios]: https://github.com/rust-lang/rust/pull/24133
9019 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
9020 [lt]: https://github.com/rust-lang/rust/pull/24057
9021 [meth]: https://github.com/rust-lang/rust/pull/24056
9022 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
9023 [po]: https://github.com/rust-lang/rust/pull/24270
9024 [sf]: https://github.com/rust-lang/rust/pull/24517
9025 [slp]: https://github.com/rust-lang/rust/pull/23949
9026 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
9027 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
9028 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
9029 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
9030 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
9031 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
9032 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
9033 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
9034 [self-sized]: https://github.com/rust-lang/rust/pull/22301
9035 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
9036 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
9037 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
9038 [reflect]: https://github.com/rust-lang/rust/pull/23712
9039 [conversion]: https://github.com/rust-lang/rfcs/pull/529
9040 [num-traits]: https://github.com/rust-lang/rust/pull/23549
9041 [index-value]: https://github.com/rust-lang/rust/pull/23601
9042 [dropck]: https://github.com/rust-lang/rfcs/pull/769
9043 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
9044 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
9045 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
9046 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
9047 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
9048
9049
9050 Version 1.0.0-alpha.2 (2015-02-20)
9051 =====================================
9052
9053 * ~1300 changes, numerous bugfixes
9054
9055 * Highlights
9056
9057     * The various I/O modules were [overhauled][io-rfc] to reduce
9058       unnecessary abstractions and provide better interoperation with
9059       the underlying platform. The old `io` module remains temporarily
9060       at `std::old_io`.
9061     * The standard library now [participates in feature gating][feat],
9062       so use of unstable libraries now requires a `#![feature(...)]`
9063       attribute. The impact of this change is [described on the
9064       forum][feat-forum]. [RFC][feat-rfc].
9065
9066 * Language
9067
9068     * `for` loops [now operate on the `IntoIterator` trait][into],
9069       which eliminates the need to call `.iter()`, etc. to iterate
9070       over collections. There are some new subtleties to remember
9071       though regarding what sort of iterators various types yield, in
9072       particular that `for foo in bar { }` yields values from a move
9073       iterator, destroying the original collection. [RFC][into-rfc].
9074     * Objects now have [default lifetime bounds][obj], so you don't
9075       have to write `Box<Trait+'static>` when you don't care about
9076       storing references. [RFC][obj-rfc].
9077     * In types that implement `Drop`, [lifetimes must outlive the
9078       value][drop]. This will soon make it possible to safely
9079       implement `Drop` for types where `#[unsafe_destructor]` is now
9080       required. Read the [gorgeous RFC][drop-rfc] for details.
9081     * The fully qualified <T as Trait>::X syntax lets you set the Self
9082       type for a trait method or associated type. [RFC][ufcs-rfc].
9083     * References to types that implement `Deref<U>` now [automatically
9084       coerce to references][deref] to the dereferenced type `U`,
9085       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
9086       should eliminate many unsightly uses of `&*`, as when converting
9087       from references to vectors into references to
9088       slices. [RFC][deref-rfc].
9089     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
9090       `|:|`) is obsolete and closure kind is inferred from context.
9091     * [`Self` is a keyword][Self].
9092
9093 * Libraries
9094
9095     * The `Show` and `String` formatting traits [have been
9096       renamed][fmt] to `Debug` and `Display` to more clearly reflect
9097       their related purposes. Automatically getting a string
9098       conversion to use with `format!("{:?}", something_to_debug)` is
9099       now written `#[derive(Debug)]`.
9100     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
9101       OsStr}`, provide strings in platform-specific encodings for easier
9102       interop with system APIs. [RFC][osstr-rfc].
9103     * The `boxed::into_raw` and `Box::from_raw` functions [convert
9104       between `Box<T>` and `*mut T`][boxraw], a common pattern for
9105       creating raw pointers.
9106
9107 * Tooling
9108
9109     * Certain long error messages of the form 'expected foo found bar'
9110       are now [split neatly across multiple
9111       lines][multiline]. Examples in the PR.
9112     * On Unix Rust can be [uninstalled][un] by running
9113       `/usr/local/lib/rustlib/uninstall.sh`.
9114     * The `#[rustc_on_unimplemented]` attribute, requiring the
9115       'on_unimplemented' feature, lets rustc [display custom error
9116       messages when a trait is expected to be implemented for a type
9117       but is not][onun].
9118
9119 * Misc
9120
9121     * Rust is tested against a [LALR grammar][lalr], which parses
9122       almost all the Rust files that rustc does.
9123
9124 [boxraw]: https://github.com/rust-lang/rust/pull/21318
9125 [close]: https://github.com/rust-lang/rust/pull/21843
9126 [deref]: https://github.com/rust-lang/rust/pull/21351
9127 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
9128 [drop]: https://github.com/rust-lang/rust/pull/21972
9129 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
9130 [feat]: https://github.com/rust-lang/rust/pull/21248
9131 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
9132 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
9133 [fmt]: https://github.com/rust-lang/rust/pull/21457
9134 [into]: https://github.com/rust-lang/rust/pull/20790
9135 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9136 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9137 [lalr]: https://github.com/rust-lang/rust/pull/21452
9138 [multiline]: https://github.com/rust-lang/rust/pull/19870
9139 [obj]: https://github.com/rust-lang/rust/pull/22230
9140 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9141 [onun]: https://github.com/rust-lang/rust/pull/20889
9142 [osstr]: https://github.com/rust-lang/rust/pull/21488
9143 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9144 [Self]: https://github.com/rust-lang/rust/pull/22158
9145 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9146 [un]: https://github.com/rust-lang/rust/pull/22256
9147
9148
9149 Version 1.0.0-alpha (2015-01-09)
9150 ==================================
9151
9152   * ~2400 changes, numerous bugfixes
9153
9154   * Highlights
9155
9156     * The language itself is considered feature complete for 1.0,
9157       though there will be many usability improvements and bugfixes
9158       before the final release.
9159     * Nearly 50% of the public API surface of the standard library has
9160       been declared 'stable'. Those interfaces are unlikely to change
9161       before 1.0.
9162     * The long-running debate over integer types has been
9163       [settled][ints]: Rust will ship with types named `isize` and
9164       `usize`, rather than `int` and `uint`, for pointer-sized
9165       integers. Guidelines will be rolled out during the alpha cycle.
9166     * Most crates that are not `std` have been moved out of the Rust
9167       distribution into the Cargo ecosystem so they can evolve
9168       separately and don't need to be stabilized as quickly, including
9169       'time', 'getopts', 'num', 'regex', and 'term'.
9170     * Documentation continues to be expanded with more API coverage, more
9171       examples, and more in-depth explanations. The guides have been
9172       consolidated into [The Rust Programming Language][trpl].
9173     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9174     * All official Rust binary installers now come with [Cargo], the
9175       Rust package manager.
9176
9177 * Language
9178
9179     * Closures have been [completely redesigned][unboxed] to be
9180       implemented in terms of traits, can now be used as generic type
9181       bounds and thus monomorphized and inlined, or via an opaque
9182       pointer (boxed) as in the old system. The new system is often
9183       referred to as 'unboxed' closures.
9184     * Traits now support [associated types][assoc], allowing families
9185       of related types to be defined together and used generically in
9186       powerful ways.
9187     * Enum variants are [namespaced by their type names][enum].
9188     * [`where` clauses][where] provide a more versatile and attractive
9189       syntax for specifying generic bounds, though the previous syntax
9190       remains valid.
9191     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9192       numeric types.
9193     * Rust [no longer has a runtime][rt] of any description, and only
9194       supports OS threads, not green threads.
9195     * At long last, Rust has been overhauled for 'dynamically-sized
9196       types' ([DST]), which integrates 'fat pointers' (object types,
9197       arrays, and `str`) more deeply into the type system, making it
9198       more consistent.
9199     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9200       `..j` that produce range types and which, when combined with the
9201       `Index` operator and multidispatch, leads to a convenient slice
9202       notation, `[i..j]`.
9203     * The new range syntax revealed an ambiguity in the fixed-length
9204       array syntax, so now fixed length arrays [are written `[T;
9205       N]`][arrays].
9206     * The `Copy` trait is no longer implemented automatically. Unsafe
9207       pointers no longer implement `Sync` and `Send` so types
9208       containing them don't automatically either. `Sync` and `Send`
9209       are now 'unsafe traits' so one can "forcibly" implement them via
9210       `unsafe impl` if a type confirms to the requirements for them
9211       even though the internals do not (e.g. structs containing unsafe
9212       pointers like `Arc`). These changes are intended to prevent some
9213       footguns and are collectively known as [opt-in built-in
9214       traits][oibit] (though `Sync` and `Send` will soon become pure
9215       library types unknown to the compiler).
9216     * Operator traits now take their operands [by value][ops], and
9217       comparison traits can use multidispatch to compare one type
9218       against multiple other types, allowing e.g. `String` to be
9219       compared with `&str`.
9220     * `if let` and `while let` are no longer feature-gated.
9221     * Rust has adopted a more [uniform syntax for escaping unicode
9222       characters][unicode].
9223     * `macro_rules!` [has been declared stable][mac]. Though it is a
9224       flawed system it is sufficiently popular that it must be usable
9225       for 1.0. Effort has gone into [future-proofing][mac-future] it
9226       in ways that will allow other macro systems to be developed in
9227       parallel, and won't otherwise impact the evolution of the
9228       language.
9229     * The prelude has been [pared back significantly][prelude] such
9230       that it is the minimum necessary to support the most pervasive
9231       code patterns, and through [generalized where clauses][where]
9232       many of the prelude extension traits have been consolidated.
9233     * Rust's rudimentary reflection [has been removed][refl], as it
9234       incurred too much code generation for little benefit.
9235     * [Struct variants][structvars] are no longer feature-gated.
9236     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9237       known as 'higher-ranked trait bounds', this crucially allows
9238       unboxed closures to work.
9239     * Macros invocations surrounded by parens or square brackets and
9240       not terminated by a semicolon are [parsed as
9241       expressions][macros], which makes expressions like `vec![1i32,
9242       2, 3].len()` work as expected.
9243     * Trait objects now implement their traits automatically, and
9244       traits that can be coerced to objects now must be [object
9245       safe][objsafe].
9246     * Automatically deriving traits is now done with `#[derive(...)]`
9247       not `#[deriving(...)]` for [consistency with other naming
9248       conventions][derive].
9249     * Importing the containing module or enum at the same time as
9250       items or variants they contain is [now done with `self` instead
9251       of `mod`][self], as in use `foo::{self, bar}`
9252     * Glob imports are no longer feature-gated.
9253     * The `box` operator and `box` patterns have been feature-gated
9254       pending a redesign. For now unique boxes should be allocated
9255       like other containers, with `Box::new`.
9256
9257 * Libraries
9258
9259     * A [series][coll1] of [efforts][coll2] to establish
9260       [conventions][coll3] for collections types has resulted in API
9261       improvements throughout the standard library.
9262     * New [APIs for error handling][err] provide ergonomic interop
9263       between error types, and [new conventions][err-conv] describe
9264       more clearly the recommended error handling strategies in Rust.
9265     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9266       it is easier to discuss failure in the context of error handling
9267       without making clarifications as to whether you are referring to
9268       the 'fail' macro or failure more generally.
9269     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9270       syscall when available.
9271     * The 'serialize' crate has been renamed 'rustc-serialize' and
9272       moved out of the distribution to Cargo. Although it is widely
9273       used now, it is expected to be superseded in the near future.
9274     * The `Show` formatter, typically implemented with
9275       `#[derive(Show)]` is [now requested with the `{:?}`
9276       specifier][show] and is intended for use by all types, for uses
9277       such as `println!` debugging. The new `String` formatter must be
9278       implemented by hand, uses the `{}` specifier, and is intended
9279       for full-fidelity conversions of things that can logically be
9280       represented as strings.
9281
9282 * Tooling
9283
9284     * [Flexible target specification][flex] allows rustc's code
9285       generation to be configured to support otherwise-unsupported
9286       platforms.
9287     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9288       respective debuggers with Rust-appropriate pretty-printing.
9289     * The Windows installation of Rust is distributed with the
9290       MinGW components currently required to link binaries on that
9291       platform.
9292
9293 * Misc
9294
9295     * Nullable enum optimizations have been extended to more types so
9296       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9297       space than the inner types themselves.
9298     * Work has begun on supporting AArch64.
9299
9300 [Cargo]: https://crates.io
9301 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9302 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9303 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9304 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9305 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9306 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9307 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9308 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9309 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9310 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9311 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9312 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9313 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9314 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9315 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9316 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9317 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9318 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9319 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9320 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9321 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9322 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9323 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9324 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9325 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9326 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9327 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9328 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9329 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9330 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9331 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9332 [trpl]: https://doc.rust-lang.org/book/index.html
9333 [rbe]: http://rustbyexample.com/
9334
9335
9336 Version 0.12.0 (2014-10-09)
9337 =============================
9338
9339   * ~1900 changes, numerous bugfixes
9340
9341   * Highlights
9342
9343     * The introductory documentation (now called The Rust Guide) has
9344       been completely rewritten, as have a number of supplementary
9345       guides.
9346     * Rust's package manager, Cargo, continues to improve and is
9347       sometimes considered to be quite awesome.
9348     * Many API's in `std` have been reviewed and updated for
9349       consistency with the in-development Rust coding
9350       guidelines. The standard library documentation tracks
9351       stabilization progress.
9352     * Minor libraries have been moved out-of-tree to the rust-lang org
9353       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9354       be installed with Cargo.
9355     * Lifetime elision allows lifetime annotations to be left off of
9356       function declarations in many common scenarios.
9357     * Rust now works on 64-bit Windows.
9358
9359   * Language
9360     * Indexing can be overloaded with the `Index` and `IndexMut`
9361       traits.
9362     * The `if let` construct takes a branch only if the `let` pattern
9363       matches, currently behind the 'if_let' feature gate.
9364     * 'where clauses', a more flexible syntax for specifying trait
9365       bounds that is more aesthetic, have been added for traits and
9366       free functions. Where clauses will in the future make it
9367       possible to constrain associated types, which would be
9368       impossible with the existing syntax.
9369     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9370       the 'slicing_syntax' feature gate, and can be overloaded with
9371       the `Slice` or `SliceMut` traits.
9372     * The syntax for matching of sub-slices has been changed to use a
9373       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9374       consistency with other uses of `..` and to future-proof
9375       potential additional uses of the syntax.
9376     * The syntax for matching inclusive ranges in patterns has changed
9377       from `0..3` to `0...4` to be consistent with the exclusive range
9378       syntax for slicing.
9379     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9380       c]`) has been put behind the 'advanced_slice_patterns' feature
9381       gate and may be removed in the future.
9382     * Components of tuples and tuple structs can be extracted using
9383       the `value.0` syntax, currently behind the `tuple_indexing`
9384       feature gate.
9385     * The `#[crate_id]` attribute is no longer supported; versioning
9386       is handled by the package manager.
9387     * Renaming crate imports are now written `extern crate foo as bar`
9388       instead of `extern crate bar = foo`.
9389     * Renaming use statements are now written `use foo as bar` instead
9390       of `use bar = foo`.
9391     * `let` and `match` bindings and argument names in macros are now
9392       hygienic.
9393     * The new, more efficient, closure types ('unboxed closures') have
9394       been added under a feature gate, 'unboxed_closures'. These will
9395       soon replace the existing closure types, once higher-ranked
9396       trait lifetimes are added to the language.
9397     * `move` has been added as a keyword, for indicating closures
9398       that capture by value.
9399     * Mutation and assignment is no longer allowed in pattern guards.
9400     * Generic structs and enums can now have trait bounds.
9401     * The `Share` trait is now called `Sync` to free up the term
9402       'shared' to refer to 'shared reference' (the default reference
9403       type.
9404     * Dynamically-sized types have been mostly implemented,
9405       unifying the behavior of fat-pointer types with the rest of the
9406       type system.
9407     * As part of dynamically-sized types, the `Sized` trait has been
9408       introduced, which qualifying types implement by default, and
9409       which type parameters expect by default. To specify that a type
9410       parameter does not need to be sized, write `<Sized? T>`. Most
9411       types are `Sized`, notable exceptions being unsized arrays
9412       (`[T]`) and trait types.
9413     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9414     * Lifetime bounds can now be applied to type parameters and object
9415       types.
9416     * The old, reference counted GC type, `Gc<T>` which was once
9417       denoted by the `@` sigil, has finally been removed. GC will be
9418       revisited in the future.
9419
9420   * Libraries
9421     * Library documentation has been improved for a number of modules.
9422     * Bit-vectors, collections::bitv has been modernized.
9423     * The url crate is deprecated in favor of
9424       http://github.com/servo/rust-url, which can be installed with
9425       Cargo.
9426     * Most I/O stream types can be cloned and subsequently closed from
9427       a different thread.
9428     * A `std::time::Duration` type has been added for use in I/O
9429       methods that rely on timers, as well as in the 'time' crate's
9430       `Timespec` arithmetic.
9431     * The runtime I/O abstraction layer that enabled the green thread
9432       scheduler to do non-thread-blocking I/O has been removed, along
9433       with the libuv-based implementation employed by the green thread
9434       scheduler. This will greatly simplify the future I/O work.
9435     * `collections::btree` has been rewritten to have a more
9436       idiomatic and efficient design.
9437
9438   * Tooling
9439     * rustdoc output now indicates the stability levels of API's.
9440     * The `--crate-name` flag can specify the name of the crate
9441       being compiled, like `#[crate_name]`.
9442     * The `-C metadata` specifies additional metadata to hash into
9443       symbol names, and `-C extra-filename` specifies additional
9444       information to put into the output filename, for use by the
9445       package manager for versioning.
9446     * debug info generation has continued to improve and should be
9447       more reliable under both gdb and lldb.
9448     * rustc has experimental support for compiling in parallel
9449       using the `-C codegen-units` flag.
9450     * rustc no longer encodes rpath information into binaries by
9451       default.
9452
9453   * Misc
9454     * Stack usage has been optimized with LLVM lifetime annotations.
9455     * Official Rust binaries on Linux are more compatible with older
9456       kernels and distributions, built on CentOS 5.10.
9457
9458
9459 Version 0.11.0 (2014-07-02)
9460 ==========================
9461
9462   * ~1700 changes, numerous bugfixes
9463
9464   * Language
9465     * ~[T] has been removed from the language. This type is superseded by
9466       the Vec<T> type.
9467     * ~str has been removed from the language. This type is superseded by
9468       the String type.
9469     * ~T has been removed from the language. This type is superseded by the
9470       Box<T> type.
9471     * @T has been removed from the language. This type is superseded by the
9472       standard library's std::gc::Gc<T> type.
9473     * Struct fields are now all private by default.
9474     * Vector indices and shift amounts are both required to be a `uint`
9475       instead of any integral type.
9476     * Byte character, byte string, and raw byte string literals are now all
9477       supported by prefixing the normal literal with a `b`.
9478     * Multiple ABIs are no longer allowed in an ABI string
9479     * The syntax for lifetimes on closures/procedures has been tweaked
9480       slightly: `<'a>|A, B|: 'b + K -> T`
9481     * Floating point modulus has been removed from the language; however it
9482       is still provided by a library implementation.
9483     * Private enum variants are now disallowed.
9484     * The `priv` keyword has been removed from the language.
9485     * A closure can no longer be invoked through a &-pointer.
9486     * The `use foo, bar, baz;` syntax has been removed from the language.
9487     * The transmute intrinsic no longer works on type parameters.
9488     * Statics now allow blocks/items in their definition.
9489     * Trait bounds are separated from objects with + instead of : now.
9490     * Objects can no longer be read while they are mutably borrowed.
9491     * The address of a static is now marked as insignificant unless the
9492       #[inline(never)] attribute is placed it.
9493     * The #[unsafe_destructor] attribute is now behind a feature gate.
9494     * Struct literals are no longer allowed in ambiguous positions such as
9495       if, while, match, and for..in.
9496     * Declaration of lang items and intrinsics are now feature-gated by
9497       default.
9498     * Integral literals no longer default to `int`, and floating point
9499       literals no longer default to `f64`. Literals must be suffixed with an
9500       appropriate type if inference cannot determine the type of the
9501       literal.
9502     * The Box<T> type is no longer implicitly borrowed to &mut T.
9503     * Procedures are now required to not capture borrowed references.
9504
9505   * Libraries
9506     * The standard library is now a "facade" over a number of underlying
9507       libraries. This means that development on the standard library should
9508       be speedier due to smaller crates, as well as a clearer line between
9509       all dependencies.
9510     * A new library, libcore, lives under the standard library's facade
9511       which is Rust's "0-assumption" library, suitable for embedded and
9512       kernel development for example.
9513     * A regex crate has been added to the standard distribution. This crate
9514       includes statically compiled regular expressions.
9515     * The unwrap/unwrap_err methods on Result require a Show bound for
9516       better error messages.
9517     * The return types of the std::comm primitives have been centralized
9518       around the Result type.
9519     * A number of I/O primitives have gained the ability to time out their
9520       operations.
9521     * A number of I/O primitives have gained the ability to close their
9522       reading/writing halves to cancel pending operations.
9523     * Reverse iterator methods have been removed in favor of `rev()` on
9524       their forward-iteration counterparts.
9525     * A bitflags! macro has been added to enable easy interop with C and
9526       management of bit flags.
9527     * A debug_assert! macro is now provided which is disabled when
9528       `--cfg ndebug` is passed to the compiler.
9529     * A graphviz crate has been added for creating .dot files.
9530     * The std::cast module has been migrated into std::mem.
9531     * The std::local_data api has been migrated from freestanding functions
9532       to being based on methods.
9533     * The Pod trait has been renamed to Copy.
9534     * jemalloc has been added as the default allocator for types.
9535     * The API for allocating memory has been changed to use proper alignment
9536       and sized deallocation
9537     * Connecting a TcpStream or binding a TcpListener is now based on a
9538       string address and a u16 port. This allows connecting to a hostname as
9539       opposed to an IP.
9540     * The Reader trait now contains a core method, read_at_least(), which
9541       correctly handles many repeated 0-length reads.
9542     * The process-spawning API is now centered around a builder-style
9543       Command struct.
9544     * The :? printing qualifier has been moved from the standard library to
9545       an external libdebug crate.
9546     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9547       have been renamed to Eq/Ord.
9548     * The select/plural methods have been removed from format!. The escapes
9549       for { and } have also changed from \{ and \} to {{ and }},
9550       respectively.
9551     * The TaskBuilder API has been re-worked to be a true builder, and
9552       extension traits for spawning native/green tasks have been added.
9553
9554   * Tooling
9555     * All breaking changes to the language or libraries now have their
9556       commit message annotated with `[breaking-change]` to allow for easy
9557       discovery of breaking changes.
9558     * The compiler will now try to suggest how to annotate lifetimes if a
9559       lifetime-related error occurs.
9560     * Debug info continues to be improved greatly with general bug fixes and
9561       better support for situations like link time optimization (LTO).
9562     * Usage of syntax extensions when cross-compiling has been fixed.
9563     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9564       -fdata-sections and --gc-sections has been enabled by default
9565     * The compiler is now stricter about where it will load module files
9566       from when a module is declared via `mod foo;`.
9567     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9568       Syntax extensions are now discovered via a "plugin registrar" type
9569       which will be extended in the future to other various plugins.
9570     * Lints have been restructured to allow for dynamically loadable lints.
9571     * A number of rustdoc improvements:
9572       * The HTML output has been visually redesigned.
9573       * Markdown is now powered by hoedown instead of sundown.
9574       * Searching heuristics have been greatly improved.
9575       * The search index has been reduced in size by a great amount.
9576       * Cross-crate documentation via `pub use` has been greatly improved.
9577       * Primitive types are now hyperlinked and documented.
9578     * Documentation has been moved from static.rust-lang.org/doc to
9579       doc.rust-lang.org
9580     * A new sandbox, play.rust-lang.org, is available for running and
9581       sharing rust code examples on-line.
9582     * Unused attributes are now more robustly warned about.
9583     * The dead_code lint now warns about unused struct fields.
9584     * Cross-compiling to iOS is now supported.
9585     * Cross-compiling to mipsel is now supported.
9586     * Stability attributes are now inherited by default and no longer apply
9587       to intra-crate usage, only inter-crate usage.
9588     * Error message related to non-exhaustive match expressions have been
9589       greatly improved.
9590
9591
9592 Version 0.10 (2014-04-03)
9593 =========================
9594
9595   * ~1500 changes, numerous bugfixes
9596
9597   * Language
9598     * A new RFC process is now in place for modifying the language.
9599     * Patterns with `@`-pointers have been removed from the language.
9600     * Patterns with unique vectors (`~[T]`) have been removed from the
9601       language.
9602     * Patterns with unique strings (`~str`) have been removed from the
9603       language.
9604     * `@str` has been removed from the language.
9605     * `@[T]` has been removed from the language.
9606     * `@self` has been removed from the language.
9607     * `@Trait` has been removed from the language.
9608     * Headers on `~` allocations which contain `@` boxes inside the type for
9609       reference counting have been removed.
9610     * The semantics around the lifetimes of temporary expressions have changed,
9611       see #3511 and #11585 for more information.
9612     * Cross-crate syntax extensions are now possible, but feature gated. See
9613       #11151 for more information. This includes both `macro_rules!` macros as
9614       well as syntax extensions such as `format!`.
9615     * New lint modes have been added, and older ones have been turned on to be
9616       warn-by-default.
9617       * Unnecessary parentheses
9618       * Uppercase statics
9619       * Camel Case types
9620       * Uppercase variables
9621       * Publicly visible private types
9622       * `#[deriving]` with raw pointers
9623     * Unsafe functions can no longer be coerced to closures.
9624     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9625     * The `#[simd]` attribute is now behind a feature gate.
9626     * Visibility is no longer allowed on `extern crate` statements, and
9627       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9628     * Trailing commas are now allowed in argument lists and tuple patterns.
9629     * The `do` keyword has been removed, it is now a reserved keyword.
9630     * Default type parameters have been implemented, but are feature gated.
9631     * Borrowed variables through captures in closures are now considered soundly.
9632     * `extern mod` is now `extern crate`
9633     * The `Freeze` trait has been removed.
9634     * The `Share` trait has been added for types that can be shared among
9635       threads.
9636     * Labels in macros are now hygienic.
9637     * Expression/statement macro invocations can be delimited with `{}` now.
9638     * Treatment of types allowed in `static mut` locations has been tweaked.
9639     * The `*` and `.` operators are now overloadable through the `Deref` and
9640       `DerefMut` traits.
9641     * `~Trait` and `proc` no longer have `Send` bounds by default.
9642     * Partial type hints are now supported with the `_` type marker.
9643     * An `Unsafe` type was introduced for interior mutability. It is now
9644       considered undefined to transmute from `&T` to `&mut T` without using the
9645       `Unsafe` type.
9646     * The #[linkage] attribute was implemented for extern statics/functions.
9647     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9648     * `Pod` was renamed to `Copy`.
9649
9650   * Libraries
9651     * The `libextra` library has been removed. It has now been decomposed into
9652       component libraries with smaller and more focused nuggets of
9653       functionality. The full list of libraries can be found on the
9654       documentation index page.
9655     * std: `std::condition` has been removed. All I/O errors are now propagated
9656       through the `Result` type. In order to assist with error handling, a
9657       `try!` macro for unwrapping errors with an early return and a lint for
9658       unused results has been added. See #12039 for more information.
9659     * std: The `vec` module has been renamed to `slice`.
9660     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9661       This will become the only growable vector in the future.
9662     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9663       are now found at `std::io::BufferedReader` instead of
9664       `std::io::buffered::BufferedReader`.
9665     * std: `print` and `println` are no longer in the prelude, the `print!` and
9666       `println!` macros are intended to be used instead.
9667     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9668       attempts to statically prevent cycles.
9669     * std: The standard distribution is adopting the policy of pushing failure
9670       to the user rather than failing in libraries. Many functions (such as
9671       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9672     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9673       deriving mode: `#[deriving(Show)]`.
9674     * std: `ToStr` is now implemented for all types implementing `Show`.
9675     * std: The formatting trait methods now take `&self` instead of `&T`
9676     * std: The `invert()` method on iterators has been renamed to `rev()`
9677     * std: `std::num` has seen a reduction in the genericity of its traits,
9678       consolidating functionality into a few core traits.
9679     * std: Backtraces are now printed on task failure if the environment
9680       variable `RUST_BACKTRACE` is present.
9681     * std: Naming conventions for iterators have been standardized. More details
9682       can be found on the wiki's style guide.
9683     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9684       still implement the function.
9685     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9686     * std: `assert_approx_eq!` has been removed
9687     * std: The `e` and `E` formatting specifiers for floats have been added to
9688       print them in exponential notation.
9689     * std: The `Times` trait has been removed
9690     * std: Indications of variance and opting out of builtin bounds is done
9691       through marker types in `std::kinds::marker` now
9692     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9693       `#[deriving(Hash)]` is now possible.
9694     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9695     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9696     * std: `Chan::new` is now `channel()`.
9697     * std: A new synchronous channel type has been implemented.
9698     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9699     * std: `hashmap` and `trie` have been moved to `libcollections`
9700     * std: `run` has been rolled into `io::process`
9701     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9702     * std: The equality and comparison traits have seen some reorganization.
9703     * std: `rand` has moved to `librand`.
9704     * std: `to_{lower,upper}case` has been implemented for `char`.
9705     * std: Logging has been moved to `liblog`.
9706     * collections: `HashMap` has been rewritten for higher performance and less
9707       memory usage.
9708     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9709       it can be booted manually. The runtime guide has more information and
9710       examples.
9711     * native: All I/O functionality except signals has been implemented.
9712     * green: Task spawning with `libgreen` has been optimized with stack caching
9713       and various trimming of code.
9714     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9715     * sync: The `extra::sync` module has been updated to modern rust (and moved
9716       to the `sync` library), tweaking and improving various interfaces while
9717       dropping redundant functionality.
9718     * sync: A new `Barrier` type has been added to the `sync` library.
9719     * sync: An efficient mutex for native and green tasks has been implemented.
9720     * serialize: The `base64` module has seen some improvement. It treats
9721       newlines better, has non-string error values, and has seen general
9722       cleanup.
9723     * fourcc: A `fourcc!` macro was introduced
9724     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9725       hexadecimal literal.
9726
9727   * Tooling
9728     * `rustpkg` has been deprecated and removed from the main repository. Its
9729       replacement, `cargo`, is under development.
9730     * Nightly builds of rust are now available
9731     * The memory usage of rustc has been improved many times throughout this
9732       release cycle.
9733     * The build process supports disabling rpath support for the rustc binary
9734       itself.
9735     * Code generation has improved in some cases, giving more information to the
9736       LLVM optimization passes to enable more extensive optimizations.
9737     * Debuginfo compatibility with lldb on OSX has been restored.
9738     * The master branch is now gated on an android bot, making building for
9739       android much more reliable.
9740     * Output flags have been centralized into one `--emit` flag.
9741     * Crate type flags have been centralized into one `--crate-type` flag.
9742     * Codegen flags have been consolidated behind a `-C` flag.
9743     * Linking against outdated crates now has improved error messages.
9744     * Error messages with lifetimes will often suggest how to annotate the
9745       function to fix the error.
9746     * Many more types are documented in the standard library, and new guides
9747       were written.
9748     * Many `rustdoc` improvements:
9749       * code blocks are syntax highlighted.
9750       * render standalone markdown files.
9751       * the --test flag tests all code blocks by default.
9752       * exported macros are displayed.
9753       * re-exported types have their documentation inlined at the location of the
9754         first re-export.
9755       * search works across crates that have been rendered to the same output
9756         directory.
9757
9758
9759 Version 0.9 (2014-01-09)
9760 ==========================
9761
9762    * ~1800 changes, numerous bugfixes
9763
9764    * Language
9765       * The `float` type has been removed. Use `f32` or `f64` instead.
9766       * A new facility for enabling experimental features (feature gating) has
9767         been added, using the crate-level `#[feature(foo)]` attribute.
9768       * Managed boxes (@) are now behind a feature gate
9769         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9770         standard library's `Gc` or `Rc` types instead.
9771       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9772       * Jumping back to the top of a loop is now done with `continue` instead of
9773         `loop`.
9774       * Strings can no longer be mutated through index assignment.
9775       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9776         hash delimiters, as in `r###"foo"###`.
9777       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9778         called once.
9779       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9780       * `@fn`s have been removed.
9781       * `do` only works with procs in order to make it obvious what the cost
9782         of `do` is.
9783       * Single-element tuple-like structs can no longer be dereferenced to
9784         obtain the inner value. A more comprehensive solution for overloading
9785         the dereference operator will be provided in the future.
9786       * The `#[link(...)]` attribute has been replaced with
9787         `#[crate_id = "name#vers"]`.
9788       * Empty `impl`s must be terminated with empty braces and may not be
9789         terminated with a semicolon.
9790       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9791         no longer has any special meaning.
9792       * The old `fmt!` string formatting macro has been removed.
9793       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9794         `print!` and `println!`.
9795       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9796       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9797         `extern mod foo = "bar"` instead.
9798       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9799       * Macros can have attributes.
9800       * Macros can expand to items with attributes.
9801       * Macros can expand to multiple items.
9802       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9803       * Comments may be nested.
9804       * Values automatically coerce to trait objects they implement, without
9805         an explicit `as`.
9806       * Enum discriminants are no longer an entire word but as small as needed to
9807         contain all the variants. The `repr` attribute can be used to override
9808         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9809         `#[repr(C)]` to match C enums.
9810       * Non-string literals are not allowed in attributes (they never worked).
9811       * The FFI now supports variadic functions.
9812       * Octal numeric literals, as in `0o7777`.
9813       * The `concat!` syntax extension performs compile-time string concatenation.
9814       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9815         removed as Rust no longer uses segmented stacks.
9816       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9817       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9818         not `*`; ignoring remaining fields of a struct is also done with `..`,
9819         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9820       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9821       * `rustc` supports the "system" calling convention, which defaults to the
9822         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9823         "C" elsewhere.
9824       * The `type_overflow` lint (default: warn) checks literals for overflow.
9825       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9826       * The `attribute_usage` lint (default: warn) warns about unknown
9827         attributes.
9828       * The `unknown_features` lint (default: warn) warns about unknown
9829         feature gates.
9830       * The `dead_code` lint (default: warn) checks for dead code.
9831       * Rust libraries can be linked statically to one another
9832       * `#[link_args]` is behind the `link_args` feature gate.
9833       * Native libraries are now linked with `#[link(name = "foo")]`
9834       * Native libraries can be statically linked to a rust crate
9835         (`#[link(name = "foo", kind = "static")]`).
9836       * Native OS X frameworks are now officially supported
9837         (`#[link(name = "foo", kind = "framework")]`).
9838       * The `#[thread_local]` attribute creates thread-local (not task-local)
9839         variables. Currently behind the `thread_local` feature gate.
9840       * The `return` keyword may be used in closures.
9841       * Types that can be copied via a memcpy implement the `Pod` kind.
9842       * The `cfg` attribute can now be used on struct fields and enum variants.
9843
9844    * Libraries
9845       * std: The `option` and `result` API's have been overhauled to make them
9846         simpler, more consistent, and more composable.
9847       * std: The entire `std::io` module has been replaced with one that is
9848         more comprehensive and that properly interfaces with the underlying
9849         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9850         implemented.
9851       * std: `io::util` contains a number of useful implementations of
9852         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9853         `ZeroReader`, `TeeReader`.
9854       * std: The reference counted pointer type `extra::rc` moved into std.
9855       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9856         just a wrapper around it).
9857       * std: The `Either` type has been removed.
9858       * std: `fmt::Default` can be implemented for any type to provide default
9859         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9860       * std: The `rand` API continues to be tweaked.
9861       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9862         on failure in gdb, is now named `rust_fail`.
9863       * std: The `each_key` and `each_value` methods on `HashMap` have been
9864         replaced by the `keys` and `values` iterators.
9865       * std: Functions dealing with type size and alignment have moved from the
9866         `sys` module to the `mem` module.
9867       * std: The `path` module was written and API changed.
9868       * std: `str::from_utf8` has been changed to cast instead of allocate.
9869       * std: `starts_with` and `ends_with` methods added to vectors via the
9870         `ImmutableEqVector` trait, which is in the prelude.
9871       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9872         if the index is out of bounds.
9873       * std: Task failure no longer propagates between tasks, as the model was
9874         complex, expensive, and incompatible with thread-based tasks.
9875       * std: The `Any` type can be used for dynamic typing.
9876       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9877         `task::try`.
9878       * std: Methods that produce iterators generally do not have an `_iter`
9879         suffix now.
9880       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9881         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9882       * std: `util::ignore` renamed to `prelude::drop`.
9883       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9884         trait.
9885       * std: `vec::raw` has seen a lot of cleanup and API changes.
9886       * std: The standard library no longer includes any C++ code, and very
9887         minimal C, eliminating the dependency on libstdc++.
9888       * std: Runtime scheduling and I/O functionality has been factored out into
9889         extensible interfaces and is now implemented by two different crates:
9890         libnative, for native threading and I/O; and libgreen, for green threading
9891         and I/O. This paves the way for using the standard library in more limited
9892         embedded environments.
9893       * std: The `comm` module has been rewritten to be much faster, have a
9894         simpler, more consistent API, and to work for both native and green
9895         threading.
9896       * std: All libuv dependencies have been moved into the rustuv crate.
9897       * native: New implementations of runtime scheduling on top of OS threads.
9898       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9899         and other I/O.
9900       * green: The green thread scheduler and message passing types are almost
9901         entirely lock-free.
9902       * extra: The `flatpipes` module had bitrotted and was removed.
9903       * extra: All crypto functions have been removed and Rust now has a policy of
9904         not reimplementing crypto in the standard library. In the future crypto
9905         will be provided by external crates with bindings to established libraries.
9906       * extra: `c_vec` has been modernized.
9907       * extra: The `sort` module has been removed. Use the `sort` method on
9908         mutable slices.
9909
9910    * Tooling
9911       * The `rust` and `rusti` commands have been removed, due to lack of
9912         maintenance.
9913       * `rustdoc` was completely rewritten.
9914       * `rustdoc` can test code examples in documentation.
9915       * `rustpkg` can test packages with the argument, 'test'.
9916       * `rustpkg` supports arbitrary dependencies, including C libraries.
9917       * `rustc`'s support for generating debug info is improved again.
9918       * `rustc` has better error reporting for unbalanced delimiters.
9919       * `rustc`'s JIT support was removed due to bitrot.
9920       * Executables and static libraries can be built with LTO (-Z lto)
9921       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9922         build tools.
9923
9924
9925 Version 0.8 (2013-09-26)
9926 ============================
9927
9928    * ~2200 changes, numerous bugfixes
9929
9930    * Language
9931       * The `for` loop syntax has changed to work with the `Iterator` trait.
9932       * At long last, unwinding works on Windows.
9933       * Default methods are ready for use.
9934       * Many trait inheritance bugs fixed.
9935       * Owned and borrowed trait objects work more reliably.
9936       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9937       * rustc can omit emission of code for the `debug!` macro if it is passed
9938         `--cfg ndebug`
9939       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9940         for foo.rs, then foo/mod.rs, and will generate an error when both are
9941         present.
9942       * Strings no longer contain trailing nulls. The new `std::c_str` module
9943         provides new mechanisms for converting to C strings.
9944       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9945       * The FFI has been overhauled such that foreign functions are called directly,
9946         instead of through a stack-switching wrapper.
9947       * Calling a foreign function must be done through a Rust function with the
9948         `#[fixed_stack_segment]` attribute.
9949       * The `externfn!` macro can be used to declare both a foreign function and
9950         a `#[fixed_stack_segment]` wrapper at once.
9951       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9952       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9953       * `priv` is disallowed everywhere except for struct fields and enum variants.
9954       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9955       * `ref` bindings in irrefutable patterns work correctly now.
9956       * `char` is now prevented from containing invalid code points.
9957       * Casting to `bool` is no longer allowed.
9958       * `\0` is now accepted as an escape in chars and strings.
9959       * `yield` is a reserved keyword.
9960       * `typeof` is a reserved keyword.
9961       * Crates may be imported by URL with `extern mod foo = "url";`.
9962       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9963       * Static vectors can be initialized with repeating elements,
9964         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9965       * Static structs can be initialized with functional record update,
9966         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9967       * `cfg!` can be used to conditionally execute code based on the crate
9968         configuration, similarly to `#[cfg(...)]`.
9969       * The `unnecessary_qualification` lint detects unneeded module
9970         prefixes (default: allow).
9971       * Arithmetic operations have been implemented on the SIMD types in
9972         `std::unstable::simd`.
9973       * Exchange allocation headers were removed, reducing memory usage.
9974       * `format!` implements a completely new, extensible, and higher-performance
9975         string formatting system. It will replace `fmt!`.
9976       * `print!` and `println!` write formatted strings (using the `format!`
9977         extension) to stdout.
9978       * `write!` and `writeln!` write formatted strings (using the `format!`
9979         extension) to the new Writers in `std::rt::io`.
9980       * The library section in which a function or static is placed may
9981         be specified with `#[link_section = "..."]`.
9982       * The `proto!` syntax extension for defining bounded message protocols
9983         was removed.
9984       * `macro_rules!` is hygienic for `let` declarations.
9985       * The `#[export_name]` attribute specifies the name of a symbol.
9986       * `unreachable!` can be used to indicate unreachable code, and fails
9987         if executed.
9988
9989    * Libraries
9990       * std: Transitioned to the new runtime, written in Rust.
9991       * std: Added an experimental I/O library, `rt::io`, based on the new
9992         runtime.
9993       * std: A new generic `range` function was added to the prelude, replacing
9994         `uint::range` and friends.
9995       * std: `range_rev` no longer exists. Since range is an iterator it can be
9996         reversed with `range(lo, hi).invert()`.
9997       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9998         renamed to `unwrap_or`.
9999       * std: The `iterator` module was renamed to `iter`.
10000       * std: Integral types now support the `checked_add`, `checked_sub`, and
10001         `checked_mul` operations for detecting overflow.
10002       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
10003         consistency.
10004       * std: Methods are standardizing on conventions for casting methods:
10005         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
10006         and cheap casts.
10007       * std: The `CString` type in `c_str` provides new ways to convert to and
10008         from C strings.
10009       * std: `DoubleEndedIterator` can yield elements in two directions.
10010       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
10011         two splices.
10012       * std: `str::from_bytes` renamed to `str::from_utf8`.
10013       * std: `pop_opt` and `shift_opt` methods added to vectors.
10014       * std: The task-local data interface no longer uses @, and keys are
10015         no longer function pointers.
10016       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
10017       * std: Added `SharedPort` to `comm`.
10018       * std: `Eq` has a default method for `ne`; only `eq` is required
10019         in implementations.
10020       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
10021         is required in implementations.
10022       * std: `is_utf8` performance is improved, impacting many string functions.
10023       * std: `os::MemoryMap` provides cross-platform mmap.
10024       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
10025         are not 'in-bounds' are considered undefined.
10026       * std: Many freestanding functions in `vec` removed in favor of methods.
10027       * std: Many freestanding functions on scalar types removed in favor of
10028         methods.
10029       * std: Many options to task builders were removed since they don't make
10030         sense in the new scheduler design.
10031       * std: More containers implement `FromIterator` so can be created by the
10032         `collect` method.
10033       * std: More complete atomic types in `unstable::atomics`.
10034       * std: `comm::PortSet` removed.
10035       * std: Mutating methods in the `Set` and `Map` traits have been moved into
10036         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
10037         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
10038         default implementations.
10039       * std: Various `from_str` functions were removed in favor of a generic
10040         `from_str` which is available in the prelude.
10041       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
10042       * extra: `dlist`, the doubly-linked list was modernized.
10043       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
10044       * extra: Added `glob` module, replacing `std::os::glob`.
10045       * extra: `rope` was removed.
10046       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
10047       * extra: `net`, and `timer` were removed. The experimental replacements
10048         are `std::rt::io::net` and `std::rt::io::timer`.
10049       * extra: Iterators implemented for `SmallIntMap`.
10050       * extra: Iterators implemented for `Bitv` and `BitvSet`.
10051       * extra: `SmallIntSet` removed. Use `BitvSet`.
10052       * extra: Performance of JSON parsing greatly improved.
10053       * extra: `semver` updated to SemVer 2.0.0.
10054       * extra: `term` handles more terminals correctly.
10055       * extra: `dbg` module removed.
10056       * extra: `par` module removed.
10057       * extra: `future` was cleaned up, with some method renames.
10058       * extra: Most free functions in `getopts` were converted to methods.
10059
10060    * Other
10061       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
10062       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
10063         similarly to gcc's `--march` flag.
10064       * rustc's performance compiling small crates is much better.
10065       * rustpkg has received many improvements.
10066       * rustpkg supports git tags as package IDs.
10067       * rustpkg builds into target-specific directories so it can be used for
10068         cross-compiling.
10069       * The number of concurrent test tasks is controlled by the environment
10070         variable RUST_TEST_TASKS.
10071       * The test harness can now report metrics for benchmarks.
10072       * All tools have man pages.
10073       * Programs compiled with `--test` now support the `-h` and `--help` flags.
10074       * The runtime uses jemalloc for allocations.
10075       * Segmented stacks are temporarily disabled as part of the transition to
10076         the new runtime. Stack overflows are possible!
10077       * A new documentation backend, rustdoc_ng, is available for use. It is
10078         still invoked through the normal `rustdoc` command.
10079
10080
10081 Version 0.7 (2013-07-03)
10082 =======================
10083
10084    * ~2000 changes, numerous bugfixes
10085
10086    * Language
10087       * `impl`s no longer accept a visibility qualifier. Put them on methods
10088         instead.
10089       * The borrow checker has been rewritten with flow-sensitivity, fixing
10090         many bugs and inconveniences.
10091       * The `self` parameter no longer implicitly means `&'self self`,
10092         and can be explicitly marked with a lifetime.
10093       * Overloadable compound operators (`+=`, etc.) have been temporarily
10094         removed due to bugs.
10095       * The `for` loop protocol now requires `for`-iterators to return `bool`
10096         so they compose better.
10097       * The `Durable` trait is replaced with the `'static` bounds.
10098       * Trait default methods work more often.
10099       * Structs with the `#[packed]` attribute have byte alignment and
10100         no padding between fields.
10101       * Type parameters bound by `Copy` must now be copied explicitly with
10102         the `copy` keyword.
10103       * It is now illegal to move out of a dereferenced unsafe pointer.
10104       * `Option<~T>` is now represented as a nullable pointer.
10105       * `@mut` does dynamic borrow checks correctly.
10106       * The `main` function is only detected at the topmost level of the crate.
10107         The `#[main]` attribute is still valid anywhere.
10108       * Struct fields may no longer be mutable. Use inherited mutability.
10109       * The `#[no_send]` attribute makes a type that would otherwise be
10110         `Send`, not.
10111       * The `#[no_freeze]` attribute makes a type that would otherwise be
10112         `Freeze`, not.
10113       * Unbounded recursion will abort the process after reaching the limit
10114         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
10115       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
10116         are never implicitly copyable.
10117       * `#[static_assert]` makes compile-time assertions about static bools.
10118       * At long last, 'argument modes' no longer exist.
10119       * The rarely used `use mod` statement no longer exists.
10120
10121    * Syntax extensions
10122       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
10123         argument list.
10124       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
10125         `Rand`, `Zero` and `ToStr` can all be automatically derived with
10126         `#[deriving(...)]`.
10127       * The `bytes!` macro returns a vector of bytes for string, u8, char,
10128         and unsuffixed integer literals.
10129
10130    * Libraries
10131       * The `core` crate was renamed to `std`.
10132       * The `std` crate was renamed to `extra`.
10133       * More and improved documentation.
10134       * std: `iterator` module for external iterator objects.
10135       * Many old-style (internal, higher-order function) iterators replaced by
10136         implementations of `Iterator`.
10137       * std: Many old internal vector and string iterators,
10138         incl. `any`, `all`. removed.
10139       * std: The `finalize` method of `Drop` renamed to `drop`.
10140       * std: The `drop` method now takes `&mut self` instead of `&self`.
10141       * std: The prelude no longer re-exports any modules, only types and traits.
10142       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10143         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10144       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10145         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10146       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10147         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10148       * std: Many types implement `Clone`.
10149       * std: `path` type renamed to `Path`.
10150       * std: `mut` module and `Mut` type removed.
10151       * std: Many standalone functions removed in favor of methods and iterators
10152         in `vec`, `str`. In the future methods will also work as functions.
10153       * std: `reinterpret_cast` removed. Use `transmute`.
10154       * std: ascii string handling in `std::ascii`.
10155       * std: `Rand` is implemented for ~/@.
10156       * std: `run` module for spawning processes overhauled.
10157       * std: Various atomic types added to `unstable::atomic`.
10158       * std: Various types implement `Zero`.
10159       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10160       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10161       * std: Added `os::mkdir_recursive`.
10162       * std: Added `os::glob` function performs filesystems globs.
10163       * std: `FuzzyEq` renamed to `ApproxEq`.
10164       * std: `Map` now defines `pop` and `swap` methods.
10165       * std: `Cell` constructors converted to static methods.
10166       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10167       * extra: `flate` module moved from `std` to `extra`.
10168       * extra: `fileinput` module for iterating over a series of files.
10169       * extra: `Complex` number type and `complex` module.
10170       * extra: `Rational` number type and `rational` module.
10171       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10172       * extra: `term` uses terminfo now, is more correct.
10173       * extra: `arc` functions converted to methods.
10174       * extra: Implementation of fixed output size variations of SHA-2.
10175
10176    * Tooling
10177       * `unused_variables` lint mode for unused variables (default: warn).
10178       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10179         (default: warn).
10180       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10181         (default: warn).
10182       * `dead_assignment` lint mode for unread variables (default: warn).
10183       * `unnecessary_allocation` lint mode detects some heap allocations that are
10184         immediately borrowed so could be written without allocating (default: warn).
10185       * `missing_doc` lint mode (default: allow).
10186       * `unreachable_code` lint mode (default: warn).
10187       * The `rusti` command has been rewritten and a number of bugs addressed.
10188       * rustc outputs in color on more terminals.
10189       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10190       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10191       * Compiling with `-g` will make the binary record information about
10192         dynamic borrowcheck failures for debugging.
10193       * rustdoc has a nicer stylesheet.
10194       * Various improvements to rustdoc.
10195       * Improvements to rustpkg (see the detailed release notes).
10196
10197
10198 Version 0.6 (2013-04-03)
10199 ========================
10200
10201    * ~2100 changes, numerous bugfixes
10202
10203    * Syntax changes
10204       * The self type parameter in traits is now spelled `Self`
10205       * The `self` parameter in trait and impl methods must now be explicitly
10206         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10207       * Static methods no longer require the `static` keyword and instead
10208         are distinguished by the lack of a `self` parameter
10209       * Replaced the `Durable` trait with the `'static` lifetime
10210       * The old closure type syntax with the trailing sigil has been
10211         removed in favor of the more consistent leading sigil
10212       * `super` is a keyword, and may be prefixed to paths
10213       * Trait bounds are separated with `+` instead of whitespace
10214       * Traits are implemented with `impl Trait for Type`
10215         instead of `impl Type: Trait`
10216       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10217       * The `export` keyword has finally been removed
10218       * The `move` keyword has been removed (see "Semantic changes")
10219       * The interior mutability qualifier on vectors, `[mut T]`, has been
10220         removed. Use `&mut [T]`, etc.
10221       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10222       * `fail` is no longer a keyword. Use `fail!()`
10223       * `assert` is no longer a keyword. Use `assert!()`
10224       * `log` is no longer a keyword. use `debug!`, etc.
10225       * 1-tuples may be represented as `(T,)`
10226       * Struct fields may no longer be `mut`. Use inherited mutability,
10227         `@mut T`, `core::mut` or `core::cell`
10228       * `extern mod { ... }` is no longer valid syntax for foreign
10229         function modules. Use extern blocks: `extern { ... }`
10230       * Newtype enums removed. Use tuple-structs.
10231       * Trait implementations no longer support visibility modifiers
10232       * Pattern matching over vectors improved and expanded
10233       * `const` renamed to `static` to correspond to lifetime name,
10234         and make room for future `static mut` unsafe mutable globals.
10235       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10236       * `Clone` implementations can be automatically generated with
10237         `#[deriving(Clone)]`
10238       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10239         instead of `foo as Bar`.
10240       * Fixed length vector types are now written as `[int, .. 3]`
10241         instead of `[int * 3]`.
10242       * Fixed length vector types can express the length as a constant
10243         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10244
10245    * Semantic changes
10246       * Types with owned pointers or custom destructors move by default,
10247         eliminating the `move` keyword
10248       * All foreign functions are considered unsafe
10249       * &mut is now unaliasable
10250       * Writes to borrowed @mut pointers are prevented dynamically
10251       * () has size 0
10252       * The name of the main function can be customized using #[main]
10253       * The default type of an inferred closure is &fn instead of @fn
10254       * `use` statements may no longer be "chained" - they cannot import
10255         identifiers imported by previous `use` statements
10256       * `use` statements are crate relative, importing from the "top"
10257         of the crate by default. Paths may be prefixed with `super::`
10258         or `self::` to change the search behavior.
10259       * Method visibility is inherited from the implementation declaration
10260       * Structural records have been removed
10261       * Many more types can be used in static items, including enums
10262         'static-lifetime pointers and vectors
10263       * Pattern matching over vectors improved and expanded
10264       * Typechecking of closure types has been overhauled to
10265         improve inference and eliminate unsoundness
10266       * Macros leave scope at the end of modules, unless that module is
10267         tagged with #[macro_escape]
10268
10269    * Libraries
10270       * Added big integers to `std::bigint`
10271       * Removed `core::oldcomm` module
10272       * Added pipe-based `core::comm` module
10273       * Numeric traits have been reorganized under `core::num`
10274       * `vec::slice` finally returns a slice
10275       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10276       * Containers reorganized around traits in `core::container`
10277       * `core::dvec` removed, `~[T]` is a drop-in replacement
10278       * `core::send_map` renamed to `core::hashmap`
10279       * `std::map` removed; replaced with `core::hashmap`
10280       * `std::treemap` reimplemented as an owned balanced tree
10281       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10282       * `core::trie` added as a fast ordered map for integer keys
10283       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10284       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10285         overload the comparison operators, whereas `TotalOrd` is used
10286         by certain container types
10287
10288    * Other
10289       * Replaced the 'cargo' package manager with 'rustpkg'
10290       * Added all-purpose 'rust' tool
10291       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10292       * rustc now *attempts* to offer spelling suggestions
10293       * Improved support for ARM and Android
10294       * Preliminary MIPS backend
10295       * Improved foreign function ABI implementation for x86, x86_64
10296       * Various memory usage improvements
10297       * Rust code may be embedded in foreign code under limited circumstances
10298       * Inline assembler supported by new asm!() syntax extension.
10299
10300
10301 Version 0.5 (2012-12-21)
10302 ===========================
10303
10304    * ~900 changes, numerous bugfixes
10305
10306    * Syntax changes
10307       * Removed `<-` move operator
10308       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10309       * Removed old fixed length vector syntax - `[T]/N`
10310       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10311       * Macros may now expand to items and statements
10312       * `a.b()` is always parsed as a method call, never as a field projection
10313       * `Eq` and `IterBytes` implementations can be automatically generated
10314         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10315       * Removed the special crate language for `.rc` files
10316       * Function arguments may consist of any irrefutable pattern
10317
10318    * Semantic changes
10319       * `&` and `~` pointers may point to objects
10320       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10321       * Enum variants may be structs
10322       * Destructors can be added to all nominal types with the Drop trait
10323       * Structs and nullary enum variants may be constants
10324       * Values that cannot be implicitly copied are now automatically moved
10325         without writing `move` explicitly
10326       * `&T` may now be coerced to `*T`
10327       * Coercions happen in `let` statements as well as function calls
10328       * `use` statements now take crate-relative paths
10329       * The module and type namespaces have been merged so that static
10330         method names can be resolved under the trait in which they are
10331         declared
10332
10333    * Improved support for language features
10334       * Trait inheritance works in many scenarios
10335       * More support for explicit self arguments in methods - `self`, `&self`
10336         `@self`, and `~self` all generally work as expected
10337       * Static methods work in more situations
10338       * Experimental: Traits may declare default methods for the implementations
10339         to use
10340
10341    * Libraries
10342       * New condition handling system in `core::condition`
10343       * Timsort added to `std::sort`
10344       * New priority queue, `std::priority_queue`
10345       * Pipes for serializable types, `std::flatpipes'
10346       * Serialization overhauled to be trait-based
10347       * Expanded `getopts` definitions
10348       * Moved futures to `std`
10349       * More functions are pure now
10350       * `core::comm` renamed to `oldcomm`. Still deprecated
10351       * `rustdoc` and `cargo` are libraries now
10352
10353    * Misc
10354       * Added a preliminary REPL, `rusti`
10355       * License changed from MIT to dual MIT/APL2
10356
10357
10358 Version 0.4 (2012-10-15)
10359 ==========================
10360
10361    * ~2000 changes, numerous bugfixes
10362
10363    * Syntax
10364       * All keywords are now strict and may not be used as identifiers anywhere
10365       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10366         'of', 'with', 'to', 'class'.
10367       * Classes are replaced with simpler structs
10368       * Explicit method self types
10369       * `ret` became `return` and `alt` became `match`
10370       * `import` is now `use`; `use is now `extern mod`
10371       * `extern mod { ... }` is now `extern { ... }`
10372       * `use mod` is the recommended way to import modules
10373       * `pub` and `priv` replace deprecated export lists
10374       * The syntax of `match` pattern arms now uses fat arrow (=>)
10375       * `main` no longer accepts an args vector; use `os::args` instead
10376
10377    * Semantics
10378       * Trait implementations are now coherent, ala Haskell typeclasses
10379       * Trait methods may be static
10380       * Argument modes are deprecated
10381       * Borrowed pointers are much more mature and recommended for use
10382       * Strings and vectors in the static region are stored in constant memory
10383       * Typestate was removed
10384       * Resolution rewritten to be more reliable
10385       * Support for 'dual-mode' data structures (freezing and thawing)
10386
10387    * Libraries
10388       * Most binary operators can now be overloaded via the traits in
10389         `core::ops'
10390       * `std::net::url` for representing URLs
10391       * Sendable hash maps in `core::send_map`
10392       * `core::task' gained a (currently unsafe) task-local storage API
10393
10394    * Concurrency
10395       * An efficient new intertask communication primitive called the pipe,
10396         along with a number of higher-level channel types, in `core::pipes`
10397       * `std::arc`, an atomically reference counted, immutable, shared memory
10398         type
10399       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10400       * Futures are now based on pipes and sendable
10401       * More robust linked task failure
10402       * Improved task builder API
10403
10404    * Other
10405       * Improved error reporting
10406       * Preliminary JIT support
10407       * Preliminary work on precise GC
10408       * Extensive architectural improvements to rustc
10409       * Begun a transition away from buggy C++-based reflection (shape) code to
10410         Rust-based (visitor) code
10411       * All hash functions and tables converted to secure, randomized SipHash
10412
10413
10414 Version 0.3  (2012-07-12)
10415 ========================
10416
10417    * ~1900 changes, numerous bugfixes
10418
10419    * New coding conveniences
10420       * Integer-literal suffix inference
10421       * Per-item control over warnings, errors
10422       * #[cfg(windows)] and #[cfg(unix)] attributes
10423       * Documentation comments
10424       * More compact closure syntax
10425       * 'do' expressions for treating higher-order functions as
10426         control structures
10427       * *-patterns (wildcard extended to all constructor fields)
10428
10429    * Semantic cleanup
10430       * Name resolution pass and exhaustiveness checker rewritten
10431       * Region pointers and borrow checking supersede alias
10432         analysis
10433       * Init-ness checking is now provided by a region-based liveness
10434         pass instead of the typestate pass; same for last-use analysis
10435       * Extensive work on region pointers
10436
10437    * Experimental new language features
10438       * Slices and fixed-size, interior-allocated vectors
10439       * #!-comments for lang versioning, shell execution
10440       * Destructors and iface implementation for classes;
10441         type-parameterized classes and class methods
10442       * 'const' type kind for types that can be used to implement
10443         shared-memory concurrency patterns
10444
10445    * Type reflection
10446
10447    * Removal of various obsolete features
10448       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10449                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10450
10451       * Constructs: do-while loops ('do' repurposed), fn binding,
10452                     resources (replaced by destructors)
10453
10454    * Compiler reorganization
10455       * Syntax-layer of compiler split into separate crate
10456       * Clang (from LLVM project) integrated into build
10457       * Typechecker split into sub-modules
10458
10459    * New library code
10460       * New time functions
10461       * Extension methods for many built-in types
10462       * Arc: atomic-refcount read-only / exclusive-use shared cells
10463       * Par: parallel map and search routines
10464       * Extensive work on libuv interface
10465       * Much vector code moved to libraries
10466       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10467         #include, #include_str, #include_bin
10468
10469    * Tool improvements
10470       * Cargo automatically resolves dependencies
10471
10472
10473 Version 0.2  (2012-03-29)
10474 =========================
10475
10476    * >1500 changes, numerous bugfixes
10477
10478    * New docs and doc tooling
10479
10480    * New port: FreeBSD x86_64
10481
10482    * Compilation model enhancements
10483       * Generics now specialized, multiply instantiated
10484       * Functions now inlined across separate crates
10485
10486    * Scheduling, stack and threading fixes
10487       * Noticeably improved message-passing performance
10488       * Explicit schedulers
10489       * Callbacks from C
10490       * Helgrind clean
10491
10492    * Experimental new language features
10493       * Operator overloading
10494       * Region pointers
10495       * Classes
10496
10497    * Various language extensions
10498       * C-callback function types: 'crust fn ...'
10499       * Infinite-loop construct: 'loop { ... }'
10500       * Shorten 'mutable' to 'mut'
10501       * Required mutable-local qualifier: 'let mut ...'
10502       * Basic glob-exporting: 'export foo::*;'
10503       * Alt now exhaustive, 'alt check' for runtime-checked
10504       * Block-function form of 'for' loop, with 'break' and 'ret'.
10505
10506    * New library code
10507       * AST quasi-quote syntax extension
10508       * Revived libuv interface
10509       * New modules: core::{future, iter}, std::arena
10510       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10511       * Extensive cleanup, regularization in libstd, libcore
10512
10513
10514 Version 0.1  (2012-01-20)
10515 ===============================
10516
10517    * Most language features work, including:
10518       * Unique pointers, unique closures, move semantics
10519       * Interface-constrained generics
10520       * Static interface dispatch
10521       * Stack growth
10522       * Multithread task scheduling
10523       * Typestate predicates
10524       * Failure unwinding, destructors
10525       * Pattern matching and destructuring assignment
10526       * Lightweight block-lambda syntax
10527       * Preliminary macro-by-example
10528
10529    * Compiler works with the following configurations:
10530       * Linux: x86 and x86_64 hosts and targets
10531       * macOS: x86 and x86_64 hosts and targets
10532       * Windows: x86 hosts and targets
10533
10534    * Cross compilation / multi-target configuration supported.
10535
10536    * Preliminary API-documentation and package-management tools included.
10537
10538 Known issues:
10539
10540    * Documentation is incomplete.
10541
10542    * Performance is below intended target.
10543
10544    * Standard library APIs are subject to extensive change, reorganization.
10545
10546    * Language-level versioning is not yet operational - future code will
10547      break unexpectedly.