]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Update RELEASES.md
[rust.git] / RELEASES.md
1 Version 1.54.0 (2021-06-29)
2 ============================
3
4 Language
5 -----------------------
6
7 - [You can now use macros for values in key-value attributes.][83366]
8   While a seemingly minor addition on its own, this enables a lot of
9   powerful functionality when combined correctly. Most notably you can
10   now include external documentation in your crate by writing the following.
11   ```rust
12   #![doc = include_str!("README.md")]
13   ```
14   You can also use this to include auto-generated modules:
15   ```rust
16   #[path = concat!(env!("OUT_DIR"), "/generated.rs")]
17   mod generated;
18   ```
19
20 - [You can now cast between unsized slice types (and types which contain
21   unsized slices) in `const fn`.][85078]
22 - [TODO: stabilize member constraints][84701]
23
24 Compiler
25 -----------------------
26
27 - [Rustc will now search for custom JSON targets in
28   `/lib/rustlib/<target-triple>/target.json` where `/` is the "sysroot"
29   directory.][83800] You can find your sysroot directory by running
30   `rustc --print sysroot`.
31 - [Added `wasm` as a `target_family` for WebAssembly platforms.][84072]
32 - [You can now use `#[target_feature]` on safe functions when targeting
33   WebAssembly platforms.][84988]
34 - [Improved debugger output for enums on Windows MSVC platforms.][85292]
35 - [Added tier 3\* support for `bpfel-unknown-none`
36    and `bpfeb-unknown-none`.][79608]
37 - [Added tier 3 support for `powerpc64le-unknown-freebsd`.][83572]
38
39 Libraries
40 -----------------------
41
42 - [You can now explicitly import the prelude of different editions
43   through `std::prelude`. (e.g. `use std::prelude::rust_2021::*;`)][86294]
44 - [`panic::panic_any` will now `#[track_caller]`.][85745]
45 - [Added `OutOfMemory` as a variant of `io::ErrorKind`.][84744]
46 - [ `proc_macro::Literal` now implements `FromStr`.][84717]
47 - [TODO: Bump stdarch submodule][83278]
48
49 Stabilized APIs
50 ---------------
51
52 - [`BTreeMap::into_keys`]
53 - [`BTreeMap::into_values`]
54 - [`HashMap::into_keys`]
55 - [`HashMap::into_values`]
56 - [`MaybeUninit::assume_init_mut`]
57 - [`MaybeUninit::assume_init_ref`]
58 - [`arch::wasm32`]
59 - [`arch::x86::_bittest`]
60 - [`arch::x86::_bittestandcomplement`]
61 - [`arch::x86::_bittestandset`]
62 - [`arch::x86_64::_bittest`]
63 - [`arch::x86_64::_bittestandcomplement64`]
64 - [`arch::x86_64::_bittestandcomplement`]
65 - [`arch::x86_64::_bittestandreset64`]
66 - [`arch::x86_64::_bittestandset64`]
67 - [`arch::x86_64::_bittestandset`]
68 - [`ops::ControlFlow`]
69 - [`VecDeque::binary_search`]
70 - [`VecDeque::binary_search_by`]
71 - [`VecDeque::binary_search_by_key`]
72 - [`VecDeque::partition_point`]
73
74 Cargo
75 -----------------------
76
77 - [Added the `--prune <spec>` option to `cargo-tree` to remove a package from
78   the dependency graph.][cargo/9520]
79 - [Added the `--depth` option to `cargo-tree` to print only to a certain depth
80   in the tree ][cargo/9499]
81 - [Added the `no-proc-macro` value to `cargo-tree --edges` to hide procedural
82   macro dependencies.][cargo/9488]
83 - [A new environment variable named `CARGO_TARGET_TMPDIR` is available.][cargo/9375]
84   This variable points to a directory that integration tests and benches
85   can use as a "scratchpad" for testing filesystem operations.
86 - [Configure hosts separately from targets when --target is specified.][cargo/9322]
87 - [Respect Cargo.toml `[package.exclude]` even not in a git repo.][cargo/9186]
88
89 [79608]: https://github.com/rust-lang/rust/pull/79608
90 [84988]: https://github.com/rust-lang/rust/pull/84988
91 [84701]: https://github.com/rust-lang/rust/pull/84701
92 [84072]: https://github.com/rust-lang/rust/pull/84072
93 [86294]: https://github.com/rust-lang/rust/pull/86294
94 [85745]: https://github.com/rust-lang/rust/pull/85745
95 [84744]: https://github.com/rust-lang/rust/pull/84744
96 [85078]: https://github.com/rust-lang/rust/pull/85078
97 [84717]: https://github.com/rust-lang/rust/pull/84717
98 [83800]: https://github.com/rust-lang/rust/pull/83800
99 [83366]: https://github.com/rust-lang/rust/pull/83366
100 [83278]: https://github.com/rust-lang/rust/pull/83278
101 [85292]: https://github.com/rust-lang/rust/pull/85292
102 [83572]: https://github.com/rust-lang/rust/pull/83572
103 [cargo/9520]: https://github.com/rust-lang/cargo/pull/9520
104 [cargo/9499]: https://github.com/rust-lang/cargo/pull/9499
105 [cargo/9488]: https://github.com/rust-lang/cargo/pull/9488
106 [cargo/9375]: https://github.com/rust-lang/cargo/pull/9375
107 [cargo/9322]: https://github.com/rust-lang/cargo/pull/9322
108 [cargo/9186]: https://github.com/rust-lang/cargo/pull/9186
109 [`arch::x86::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittest.html
110 [`arch::x86::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandcomplement.html
111 [`arch::x86::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86/fn._bittestandset.html
112 [`arch::x86_64::_bittest`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittest.html
113 [`arch::x86_64::_bittestandcomplement64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement64.html
114 [`arch::x86_64::_bittestandcomplement`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandcomplement.html
115 [`arch::x86_64::_bittestandreset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandreset64.html
116 [`arch::x86_64::_bittestandset64`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset64.html
117 [`arch::x86_64::_bittestandset`]: https://doc.rust-lang.org/stable/core/arch/x86_64/fn._bittestandset.html
118 [`BTreeMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_keys
119 [`BTreeMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.into_values
120 [`HashMap::into_keys`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_keys
121 [`HashMap::into_values`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.into_values
122 [`MaybeUninit::assume_init_ref`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html#method.assume_init_ref
123 [`MaybeUninit::assume_init_mut`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html#method.assume_init_mut
124 [`arch::wasm32`]: https://doc.rust-lang.org/core/arch/wasm32/index.html
125 [`ops::ControlFlow`]: https://doc.rust-lang.org/std/ops/enum.ControlFlow.html
126 [`VecDeque::binary_search`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search
127 [`VecDeque::binary_search_by`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by
128
129 [`VecDeque::binary_search_by_key`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.binary_search_by_key
130
131 [`VecDeque::partition_point`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.partition_point
132
133 Version 1.53.0 (2021-06-17)
134 ============================
135
136 Language
137 -----------------------
138 - [You can now use unicode for identifiers.][83799] This allows multilingual
139   identifiers but still doesn't allow glyphs that are not considered characters
140   such as `◆` or `🦀`. More specifically you can now use any identifier that
141   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
142   is the same standard as languages like Python, however Rust uses NFC
143   normalization which may be different from other languages.
144 - [You can now specify "or patterns" inside pattern matches.][79278]
145   Previously you could only use `|` (OR) on complete patterns. E.g.
146   ```rust
147   let x = Some(2u8);
148   // Before
149   matches!(x, Some(1) | Some(2));
150   // Now
151   matches!(x, Some(1 | 2));
152   ```
153 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
154   has the same semantics as the `:pat` matcher. This is to allow `:pat`
155   to change semantics to being a pattern fragment in a future edition.
156
157 Compiler
158 -----------------------
159 - [Updated the minimum external LLVM version to LLVM 10.][83387]
160 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
161 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
162
163 \* Refer to Rust's [platform support page][platform-support-doc] for more
164 information on Rust's tiered platform support.
165
166 Libraries
167 -----------------------
168 - [Abort messages will now forward to `android_set_abort_message` on
169   Android platforms when available.][81469]
170 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
171 - [Arrays of any length now implement `IntoIterator`.][84147]
172   Currently calling `.into_iter()` as a method on an array will
173   return `impl Iterator<Item=&T>`, but this may change in a
174   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
175   directly on arrays will provide `impl Iterator<Item=T>` as expected.
176 - [`leading_zeros`, and `trailing_zeros` are now available on all
177   `NonZero` integer types.][84082]
178 - [`{f32, f64}::from_str` now parse and print special values
179   (`NaN`, `-0`) according to IEEE RFC 754.][78618]
180 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
181 - [Add the `BITS` associated constant to all numeric types.][82565]
182
183 Stabilised APIs
184 ---------------
185 - [`AtomicBool::fetch_update`]
186 - [`AtomicPtr::fetch_update`]
187 - [`BTreeMap::retain`]
188 - [`BTreeSet::retain`]
189 - [`BufReader::seek_relative`]
190 - [`DebugStruct::non_exhaustive`]
191 - [`Duration::MAX`]
192 - [`Duration::ZERO`]
193 - [`Duration::is_zero`]
194 - [`Duration::saturating_add`]
195 - [`Duration::saturating_mul`]
196 - [`Duration::saturating_sub`]
197 - [`ErrorKind::Unsupported`]
198 - [`Option::insert`]
199 - [`Ordering::is_eq`]
200 - [`Ordering::is_ge`]
201 - [`Ordering::is_gt`]
202 - [`Ordering::is_le`]
203 - [`Ordering::is_lt`]
204 - [`Ordering::is_ne`]
205 - [`OsStr::is_ascii`]
206 - [`OsStr::make_ascii_lowercase`]
207 - [`OsStr::make_ascii_uppercase`]
208 - [`OsStr::to_ascii_lowercase`]
209 - [`OsStr::to_ascii_uppercase`]
210 - [`Peekable::peek_mut`]
211 - [`Rc::decrement_strong_count`]
212 - [`Rc::increment_strong_count`]
213 - [`Vec::extend_from_within`]
214 - [`array::from_mut`]
215 - [`array::from_ref`]
216 - [`cmp::max_by_key`]
217 - [`cmp::max_by`]
218 - [`cmp::min_by_key`]
219 - [`cmp::min_by`]
220 - [`f32::is_subnormal`]
221 - [`f64::is_subnormal`]
222
223 Cargo
224 -----------------------
225 - [Cargo now supports git repositories where the default `HEAD` branch is not
226   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
227   which can handle default branches correctly.
228 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
229 - [The `authors` field is no longer included in `Cargo.toml` for new
230   projects.][cargo/9282]
231
232 Rustdoc
233 -----------------------
234 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
235   without hyperlinks.][81764]
236
237 Compatibility Notes
238 -------------------
239 - [Implement token-based handling of attributes during expansion][82608]
240 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
241   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
242   to confusion and potential security vulnerabilities and [is no
243   longer recommended][ietf6943].
244 - [The added `BITS` constant may conflict with external definitions.][85667]
245   In particular, this was known to be a problem in the `lexical-core` crate,
246   but they have published fixes for semantic versions 0.4 through 0.7. To
247   update this dependency alone, use `cargo update -p lexical-core`.
248 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
249
250 Internal Only
251 -------------
252 These changes provide no direct user facing benefits, but represent significant
253 improvements to the internals and overall performance of rustc and
254 related tools.
255
256 - [Rework the `std::sys::windows::alloc` implementation.][83065]
257 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
258 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
259 - [Rework rustdoc const type][82873]
260
261 [85667]: https://github.com/rust-lang/rust/pull/85667
262 [83386]: https://github.com/rust-lang/rust/pull/83386
263 [82771]: https://github.com/rust-lang/rust/pull/82771
264 [84147]: https://github.com/rust-lang/rust/pull/84147
265 [84082]: https://github.com/rust-lang/rust/pull/84082
266 [83799]: https://github.com/rust-lang/rust/pull/83799
267 [83681]: https://github.com/rust-lang/rust/pull/83681
268 [83652]: https://github.com/rust-lang/rust/pull/83652
269 [83387]: https://github.com/rust-lang/rust/pull/83387
270 [82873]: https://github.com/rust-lang/rust/pull/82873
271 [82864]: https://github.com/rust-lang/rust/pull/82864
272 [82608]: https://github.com/rust-lang/rust/pull/82608
273 [82565]: https://github.com/rust-lang/rust/pull/82565
274 [80525]: https://github.com/rust-lang/rust/pull/80525
275 [79278]: https://github.com/rust-lang/rust/pull/79278
276 [78618]: https://github.com/rust-lang/rust/pull/78618
277 [77704]: https://github.com/rust-lang/rust/pull/77704
278 [83941]: https://github.com/rust-lang/rust/pull/83941
279 [83065]: https://github.com/rust-lang/rust/pull/83065
280 [81764]: https://github.com/rust-lang/rust/pull/81764
281 [81469]: https://github.com/rust-lang/rust/pull/81469
282 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
283 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
284 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
285 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
286 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
287 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
288 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
289 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
290 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
291 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
292 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
293 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
294 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
295 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
296 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
297 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
298 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
299 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
300 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
301 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
302 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
303 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
304 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
305 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
306 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
307 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
308 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
309 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
310 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
311 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
312 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
313 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
314 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
315 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
316 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
317 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
318 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
319 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
320 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
321 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
322 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
323 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
324
325
326 Version 1.52.1 (2021-05-10)
327 ============================
328
329 This release disables incremental compilation, unless the user has explicitly
330 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
331
332 This is due to the widespread, and frequently occuring, breakage encountered by
333 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
334 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
335 newly added incremental verification are still present in past stable versions,
336 and are not yet fixed on any channel. These bugs can lead to miscompilation of
337 Rust binaries.
338
339 These problems only affect incremental builds, so release builds with Cargo
340 should not be affected unless the user has explicitly opted into incremental.
341 Debug and check builds are affected.
342
343 See [84970] for more details.
344
345 [84970]: https://github.com/rust-lang/rust/issues/84970
346
347 Version 1.52.0 (2021-05-06)
348 ============================
349
350 Language
351 --------
352 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
353   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
354   is allowed by default, and may become a warning or hard error in a
355   future edition.
356 - [You can now cast mutable references to arrays to a pointer of the same type as
357   the element.][81479]
358
359 Compiler
360 --------
361 - [Upgraded the default LLVM to LLVM 12.][81451]
362
363 Added tier 3\* support for the following targets.
364
365 - [`s390x-unknown-linux-musl`][82166]
366 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
367 - [`powerpc-unknown-openbsd`][82733]
368
369 \* Refer to Rust's [platform support page][platform-support-doc] for more
370 information on Rust's tiered platform support.
371
372 Libraries
373 ---------
374 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
375 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
376 - [`Arc<impl Error>` now implements `error::Error`.][80553]
377 - [All integer division and remainder operations are now `const`.][80962]
378
379 Stabilised APIs
380 -------------
381 - [`Arguments::as_str`]
382 - [`char::MAX`]
383 - [`char::REPLACEMENT_CHARACTER`]
384 - [`char::UNICODE_VERSION`]
385 - [`char::decode_utf16`]
386 - [`char::from_digit`]
387 - [`char::from_u32_unchecked`]
388 - [`char::from_u32`]
389 - [`slice::partition_point`]
390 - [`str::rsplit_once`]
391 - [`str::split_once`]
392
393 The following previously stable APIs are now `const`.
394
395 - [`char::len_utf8`]
396 - [`char::len_utf16`]
397 - [`char::to_ascii_uppercase`]
398 - [`char::to_ascii_lowercase`]
399 - [`char::eq_ignore_ascii_case`]
400 - [`u8::to_ascii_uppercase`]
401 - [`u8::to_ascii_lowercase`]
402 - [`u8::eq_ignore_ascii_case`]
403
404 Rustdoc
405 -------
406 - [Rustdoc lints are now treated as a tool lint, meaning that
407   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
408   Using the old style is still allowed, and will become a warning in
409   a future release.
410 - [Rustdoc now supports argument files.][82261]
411 - [Rustdoc now generates smart punctuation for documentation.][79423]
412 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
413   ```markdown
414   - [x] Complete
415   - [ ] Todo
416   ```
417
418 Misc
419 ----
420 - [You can now pass multiple filters to tests.][81356] E.g.
421   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
422 - [Rustup now distributes PDB symbols for the `std` library on Windows,
423   allowing you to see `std` symbols when debugging.][82218]
424
425 Internal Only
426 -------------
427 These changes provide no direct user facing benefits, but represent significant
428 improvements to the internals and overall performance of rustc and
429 related tools.
430
431 - [Check the result cache before the DepGraph when ensuring queries][81855]
432 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
433 - [Only store a LocalDefId in some HIR nodes][81611]
434 - [Store HIR attributes in a side table][79519]
435
436 Compatibility Notes
437 -------------------
438 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
439 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
440 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
441 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
442   languages in code blocks.][78429]
443 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
444 - [Changes in how proc macros handle whitespace may lead to panics when used
445   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
446 - [Turn `#[derive]` into a regular macro attribute][79078]
447
448 [84136]: https://github.com/rust-lang/rust/issues/84136
449 [80763]: https://github.com/rust-lang/rust/pull/80763
450 [82166]: https://github.com/rust-lang/rust/pull/82166
451 [82121]: https://github.com/rust-lang/rust/pull/82121
452 [81879]: https://github.com/rust-lang/rust/pull/81879
453 [82261]: https://github.com/rust-lang/rust/pull/82261
454 [82218]: https://github.com/rust-lang/rust/pull/82218
455 [82216]: https://github.com/rust-lang/rust/pull/82216
456 [82202]: https://github.com/rust-lang/rust/pull/82202
457 [81855]: https://github.com/rust-lang/rust/pull/81855
458 [81766]: https://github.com/rust-lang/rust/pull/81766
459 [81744]: https://github.com/rust-lang/rust/pull/81744
460 [81611]: https://github.com/rust-lang/rust/pull/81611
461 [81479]: https://github.com/rust-lang/rust/pull/81479
462 [81451]: https://github.com/rust-lang/rust/pull/81451
463 [81356]: https://github.com/rust-lang/rust/pull/81356
464 [80962]: https://github.com/rust-lang/rust/pull/80962
465 [80553]: https://github.com/rust-lang/rust/pull/80553
466 [80527]: https://github.com/rust-lang/rust/pull/80527
467 [79519]: https://github.com/rust-lang/rust/pull/79519
468 [79423]: https://github.com/rust-lang/rust/pull/79423
469 [79208]: https://github.com/rust-lang/rust/pull/79208
470 [78429]: https://github.com/rust-lang/rust/pull/78429
471 [82733]: https://github.com/rust-lang/rust/pull/82733
472 [82594]: https://github.com/rust-lang/rust/pull/82594
473 [79078]: https://github.com/rust-lang/rust/pull/79078
474 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
475 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
476 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
477 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
478 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
479 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
480 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
481 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
482 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
483 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
484 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
485 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
486 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
487 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
488 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
489 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
490 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
491 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
492 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
493 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
494 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
495 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
496
497 Version 1.51.0 (2021-03-25)
498 ============================
499
500 Language
501 --------
502 - [You can now parameterize items such as functions, traits, and `struct`s by constant
503   values in addition to by types and lifetimes.][79135] Also known as "const generics"
504   E.g. you can now write the following. Note: Only values of primitive integers,
505   `bool`, or `char` types are currently permitted.
506   ```rust
507   struct GenericArray<T, const LENGTH: usize> {
508       inner: [T; LENGTH]
509   }
510
511   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
512       const fn last(&self) -> Option<&T> {
513           if LENGTH == 0 {
514               None
515           } else {
516               Some(&self.inner[LENGTH - 1])
517           }
518       }
519   }
520   ```
521
522
523 Compiler
524 --------
525
526 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
527   This option controls whether debug information is split across multiple files
528   or packed into a single file. **Note** This option is unstable on other platforms.
529 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
530   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
531 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
532 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
533
534 \* Refer to Rust's [platform support page][platform-support-doc] for more
535 information on Rust's tiered platform support.
536
537 Libraries
538 ---------
539
540 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
541 - [`str` now implements `AsMut<str>`.][80279]
542 - [`u64` and `u128` now implement `From<char>`.][79502]
543 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
544 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
545 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
546 - [`io::Empty` now implements `io::Seek`.][78044]
547 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
548   `T: ?Sized` types.][80764]
549 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
550
551
552 Stabilized APIs
553 ---------------
554
555 - [`Arc::decrement_strong_count`]
556 - [`Arc::increment_strong_count`]
557 - [`Once::call_once_force`]
558 - [`Peekable::next_if_eq`]
559 - [`Peekable::next_if`]
560 - [`Seek::stream_position`]
561 - [`array::IntoIter`]
562 - [`panic::panic_any`]
563 - [`ptr::addr_of!`]
564 - [`ptr::addr_of_mut!`]
565 - [`slice::fill_with`]
566 - [`slice::split_inclusive_mut`]
567 - [`slice::split_inclusive`]
568 - [`slice::strip_prefix`]
569 - [`slice::strip_suffix`]
570 - [`str::split_inclusive`]
571 - [`sync::OnceState`]
572 - [`task::Wake`]
573 - [`VecDeque::range`]
574 - [`VecDeque::range_mut`]
575
576 Cargo
577 -----
578 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
579   codegen option.][cargo/9112]
580 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
581   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
582   to avoid unifying features of dependencies where that unification could be unwanted.
583   Such as using the same dependency with a `std` feature in a build scripts and
584   proc-macros, while using the `no-std` feature in the final binary. See the
585   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
586
587 Rustdoc
588 -------
589
590 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
591 - [You can now provide a `--default-theme` flag which sets the default theme to use for
592   documentation.][79642]
593
594 Various improvements to intra-doc links:
595
596 - [You can link to non-path primitives such as `slice`.][80181]
597 - [You can link to associated items.][74489]
598 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
599
600 Misc
601 ----
602 - [You can now pass `--include-ignored` to tests (e.g. with
603   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
604
605 Compatibility Notes
606 -------------------
607
608 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
609 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
610   could fail.][80579]
611 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
612   for the distributed artifacts.][81521]
613     - `armv5te-unknown-linux-gnueabi`
614     - `sparc64-unknown-linux-gnu`
615     - `thumbv7neon-unknown-linux-gnueabihf`
616     - `armv7-unknown-linux-gnueabi`
617     - `x86_64-unknown-linux-gnux32`
618 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
619
620 Internal Only
621 -------------
622
623 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
624
625 [79135]: https://github.com/rust-lang/rust/pull/79135
626 [74489]: https://github.com/rust-lang/rust/pull/74489
627 [76934]: https://github.com/rust-lang/rust/pull/76934
628 [79570]: https://github.com/rust-lang/rust/pull/79570
629 [80181]: https://github.com/rust-lang/rust/pull/80181
630 [79642]: https://github.com/rust-lang/rust/pull/79642
631 [80945]: https://github.com/rust-lang/rust/pull/80945
632 [80279]: https://github.com/rust-lang/rust/pull/80279
633 [80053]: https://github.com/rust-lang/rust/pull/80053
634 [79502]: https://github.com/rust-lang/rust/pull/79502
635 [75180]: https://github.com/rust-lang/rust/pull/75180
636 [79135]: https://github.com/rust-lang/rust/pull/79135
637 [81521]: https://github.com/rust-lang/rust/pull/81521
638 [80968]: https://github.com/rust-lang/rust/pull/80968
639 [80959]: https://github.com/rust-lang/rust/pull/80959
640 [80718]: https://github.com/rust-lang/rust/pull/80718
641 [80653]: https://github.com/rust-lang/rust/pull/80653
642 [80579]: https://github.com/rust-lang/rust/pull/80579
643 [79998]: https://github.com/rust-lang/rust/pull/79998
644 [78044]: https://github.com/rust-lang/rust/pull/78044
645 [81455]: https://github.com/rust-lang/rust/pull/81455
646 [80764]: https://github.com/rust-lang/rust/pull/80764
647 [80749]: https://github.com/rust-lang/rust/pull/80749
648 [80662]: https://github.com/rust-lang/rust/pull/80662
649 [79134]: https://github.com/rust-lang/rust/pull/79134
650 [80966]: https://github.com/rust-lang/rust/pull/80966
651 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
652 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
653 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
654 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
655 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
656 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
657 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
658 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
659 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
660 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
661 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
662 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
663 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
664 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
665 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
666 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
667 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
668 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
669 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
670 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
671 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
672 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
673 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
674
675 Version 1.50.0 (2021-02-11)
676 ============================
677
678 Language
679 -----------------------
680 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
681   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
682 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
683
684 Compiler
685 -----------------------
686 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
687 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
688 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
689 - [Dropped support for all cloudabi targets.][78439]
690
691 \* Refer to Rust's [platform support page][platform-support-doc] for more
692 information on Rust's tiered platform support.
693
694 Libraries
695 -----------------------
696
697 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
698 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
699 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
700   This value cannot be a valid file descriptor, and now means `Option<File>` takes
701   up the same amount of space as `File`.
702
703 Stabilized APIs
704 ---------------
705
706 - [`bool::then`]
707 - [`btree_map::Entry::or_insert_with_key`]
708 - [`f32::clamp`]
709 - [`f64::clamp`]
710 - [`hash_map::Entry::or_insert_with_key`]
711 - [`Ord::clamp`]
712 - [`RefCell::take`]
713 - [`slice::fill`]
714 - [`UnsafeCell::get_mut`]
715
716 The following previously stable methods are now `const`.
717
718 - [`IpAddr::is_ipv4`]
719 - [`IpAddr::is_ipv6`]
720 - [`IpAddr::is_unspecified`]
721 - [`IpAddr::is_loopback`]
722 - [`IpAddr::is_multicast`]
723 - [`Ipv4Addr::octets`]
724 - [`Ipv4Addr::is_loopback`]
725 - [`Ipv4Addr::is_private`]
726 - [`Ipv4Addr::is_link_local`]
727 - [`Ipv4Addr::is_multicast`]
728 - [`Ipv4Addr::is_broadcast`]
729 - [`Ipv4Addr::is_documentation`]
730 - [`Ipv4Addr::to_ipv6_compatible`]
731 - [`Ipv4Addr::to_ipv6_mapped`]
732 - [`Ipv6Addr::segments`]
733 - [`Ipv6Addr::is_unspecified`]
734 - [`Ipv6Addr::is_loopback`]
735 - [`Ipv6Addr::is_multicast`]
736 - [`Ipv6Addr::to_ipv4`]
737 - [`Layout::size`]
738 - [`Layout::align`]
739 - [`Layout::from_size_align`]
740 - `pow` for all integer types.
741 - `checked_pow` for all integer types.
742 - `saturating_pow` for all integer types.
743 - `wrapping_pow` for all integer types.
744 - `next_power_of_two` for all unsigned integer types.
745 - `checked_next_power_of_two` for all unsigned integer types.
746
747 Cargo
748 -----------------------
749
750 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
751   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
752 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
753   contents of that directory for changes.][cargo/8973]
754 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
755
756 Misc
757 ----
758
759 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
760 - [Running tests will now print the total time taken to execute.][75752]
761
762 Compatibility Notes
763 -------------------
764
765 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
766   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
767 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
768   unhygenic `macro_rules!` macros.][79472]
769 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
770   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
771 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
772 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
773   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
774 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
775
776 [74989]: https://github.com/rust-lang/rust/pull/74989
777 [79261]: https://github.com/rust-lang/rust/pull/79261
778 [79896]: https://github.com/rust-lang/rust/pull/79896
779 [79484]: https://github.com/rust-lang/rust/pull/79484
780 [79472]: https://github.com/rust-lang/rust/pull/79472
781 [79270]: https://github.com/rust-lang/rust/pull/79270
782 [79003]: https://github.com/rust-lang/rust/pull/79003
783 [78864]: https://github.com/rust-lang/rust/pull/78864
784 [78636]: https://github.com/rust-lang/rust/pull/78636
785 [78439]: https://github.com/rust-lang/rust/pull/78439
786 [78343]: https://github.com/rust-lang/rust/pull/78343
787 [78296]: https://github.com/rust-lang/rust/pull/78296
788 [78068]: https://github.com/rust-lang/rust/pull/78068
789 [75752]: https://github.com/rust-lang/rust/pull/75752
790 [74699]: https://github.com/rust-lang/rust/pull/74699
791 [78142]: https://github.com/rust-lang/rust/pull/78142
792 [77484]: https://github.com/rust-lang/rust/pull/77484
793 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
794 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
795 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
796 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
797 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
798 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
799 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
800 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
801 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
802 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
803 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
804 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
805 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
806 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
807 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
808 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
809 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
810 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
811 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
812 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
813 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
814 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
815 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
816 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
817 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
818 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
819 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
820 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
821 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
822 [`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
823 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
824 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
825 [`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
826 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
827
828
829 Version 1.49.0 (2020-12-31)
830 ============================
831
832 Language
833 -----------------------
834
835 - [Unions can now implement `Drop`, and you can now have a field in a union
836   with `ManuallyDrop<T>`.][77547]
837 - [You can now cast uninhabited enums to integers.][76199]
838 - [You can now bind by reference and by move in patterns.][76119] This
839   allows you to selectively borrow individual components of a type. E.g.
840   ```rust
841   #[derive(Debug)]
842   struct Person {
843       name: String,
844       age: u8,
845   }
846
847   let person = Person {
848       name: String::from("Alice"),
849       age: 20,
850   };
851
852   // `name` is moved out of person, but `age` is referenced.
853   let Person { name, ref age } = person;
854   println!("{} {}", name, age);
855   ```
856
857 Compiler
858 -----------------------
859
860 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
861 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
862 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
863 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
864 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
865 - [Output from threads spawned in tests is now captured.][78227]
866 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
867
868 \* Refer to Rust's [platform support page][platform-support-doc] for more
869 information on Rust's tiered platform support.
870
871 Libraries
872 -----------------------
873
874 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
875 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
876
877 Stabilized APIs
878 ---------------
879
880 - [`slice::select_nth_unstable`]
881 - [`slice::select_nth_unstable_by`]
882 - [`slice::select_nth_unstable_by_key`]
883
884 The following previously stable methods are now `const`.
885
886 - [`Poll::is_ready`]
887 - [`Poll::is_pending`]
888
889 Cargo
890 -----------------------
891 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
892 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
893 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
894   variable will be set if the crate being built is one the user selected to build, either
895   with `-p` or through defaults.
896 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
897
898
899 Compatibility Notes
900 -------------------
901
902 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
903 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
904 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
905   Previously such invalid or unused attributes could be ignored.
906 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
907   read [this post about the changes][rustdoc-ws-post] for more details.
908 - [Trait bounds are no longer inferred for associated types.][79904]
909
910 Internal Only
911 -------------
912 These changes provide no direct user facing benefits, but represent significant
913 improvements to the internals and overall performance of rustc and
914 related tools.
915
916 - [rustc's internal crates are now compiled using the `initial-exec` Thread
917   Local Storage model.][78201]
918 - [Calculate visibilities once in resolve.][78077]
919 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
920 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
921
922
923 [75991]: https://github.com/rust-lang/rust/pull/75991
924 [78951]: https://github.com/rust-lang/rust/pull/78951
925 [78848]: https://github.com/rust-lang/rust/pull/78848
926 [78746]: https://github.com/rust-lang/rust/pull/78746
927 [78376]: https://github.com/rust-lang/rust/pull/78376
928 [78228]: https://github.com/rust-lang/rust/pull/78228
929 [78227]: https://github.com/rust-lang/rust/pull/78227
930 [78201]: https://github.com/rust-lang/rust/pull/78201
931 [78109]: https://github.com/rust-lang/rust/pull/78109
932 [78077]: https://github.com/rust-lang/rust/pull/78077
933 [77997]: https://github.com/rust-lang/rust/pull/77997
934 [77703]: https://github.com/rust-lang/rust/pull/77703
935 [77547]: https://github.com/rust-lang/rust/pull/77547
936 [77015]: https://github.com/rust-lang/rust/pull/77015
937 [76199]: https://github.com/rust-lang/rust/pull/76199
938 [76119]: https://github.com/rust-lang/rust/pull/76119
939 [75914]: https://github.com/rust-lang/rust/pull/75914
940 [79004]: https://github.com/rust-lang/rust/pull/79004
941 [78676]: https://github.com/rust-lang/rust/pull/78676
942 [79904]: https://github.com/rust-lang/rust/issues/79904
943 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
944 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
945 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
946 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
947 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
948 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
949 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
950 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
951 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
952 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
953 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
954
955 Version 1.48.0 (2020-11-19)
956 ==========================
957
958 Language
959 --------
960
961 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
962   is still rejected *semantically*, but can now be parsed by procedural macros.
963
964 Compiler
965 --------
966 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
967   `rustc` whether to link its own C runtime and libraries or to rely on a external
968   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
969 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
970   Note: If you're using cargo you must explicitly pass the `--target` flag.
971 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
972
973 \* Refer to Rust's [platform support page][platform-support-doc] for more
974 information on Rust's tiered platform support.
975
976 Libraries
977 ---------
978 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
979   and `&Stderr`.][76275]
980 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
981 - [The `matches!` macro now supports having a trailing comma.][74880]
982 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
983 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
984
985 Stabilized APIs
986 ---------------
987 - [`slice::as_ptr_range`]
988 - [`slice::as_mut_ptr_range`]
989 - [`VecDeque::make_contiguous`]
990 - [`future::pending`]
991 - [`future::ready`]
992
993 The following previously stable methods are now `const fn`'s:
994
995 - [`Option::is_some`]
996 - [`Option::is_none`]
997 - [`Option::as_ref`]
998 - [`Result::is_ok`]
999 - [`Result::is_err`]
1000 - [`Result::as_ref`]
1001 - [`Ordering::reverse`]
1002 - [`Ordering::then`]
1003
1004 Cargo
1005 -----
1006
1007 Rustdoc
1008 -------
1009 - [You can now link to items in `rustdoc` using the intra-doc link
1010   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
1011   a link to `std::future`'s documentation. See ["Linking to items by
1012   name"][intradoc-links] for more information.
1013 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
1014   when searching through `rustdoc`'s UI.][75740]
1015
1016 Compatibility Notes
1017 -------------------
1018 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
1019   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
1020   promoted to `'static` lifetime any more inside `const fn`s.
1021 - [Associated type bindings on trait objects are now verified to meet the bounds
1022   declared on the trait when checking that they implement the trait.][27675]
1023 - [When trait bounds on associated types or opaque types are ambiguous, the
1024   compiler no longer makes an arbitrary choice on which bound to use.][54121]
1025 - [Fixed recursive nonterminals not being expanded in macros during
1026   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
1027   correctly handling recursive nonterminal tokens.
1028 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
1029 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
1030   in places where they have no effect.][73461]
1031 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
1032   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
1033 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
1034   disallow zero-initialization.][71274]
1035 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
1036 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
1037   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
1038   see the [`catch_unwind`] documentation for further information.
1039
1040
1041
1042 Internal Only
1043 -------------
1044 These changes provide no direct user facing benefits, but represent significant
1045 improvements to the internals and overall performance of rustc and
1046 related tools.
1047
1048 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
1049   You can continue building with `make` by setting `ninja=false` in
1050   your `config.toml`.
1051 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
1052 - [Made `ensure_sufficient_stack()` non-generic][76680]
1053
1054 [78143]: https://github.com/rust-lang/rust/issues/78143
1055 [76680]: https://github.com/rust-lang/rust/pull/76680/
1056 [76030]: https://github.com/rust-lang/rust/pull/76030/
1057 [70212]: https://github.com/rust-lang/rust/pull/70212/
1058 [27675]: https://github.com/rust-lang/rust/issues/27675/
1059 [54121]: https://github.com/rust-lang/rust/issues/54121/
1060 [71274]: https://github.com/rust-lang/rust/pull/71274/
1061 [77386]: https://github.com/rust-lang/rust/pull/77386/
1062 [77153]: https://github.com/rust-lang/rust/pull/77153/
1063 [77055]: https://github.com/rust-lang/rust/pull/77055/
1064 [76275]: https://github.com/rust-lang/rust/pull/76275/
1065 [76310]: https://github.com/rust-lang/rust/pull/76310/
1066 [76420]: https://github.com/rust-lang/rust/pull/76420/
1067 [76158]: https://github.com/rust-lang/rust/pull/76158/
1068 [75857]: https://github.com/rust-lang/rust/pull/75857/
1069 [75585]: https://github.com/rust-lang/rust/pull/75585/
1070 [75740]: https://github.com/rust-lang/rust/pull/75740/
1071 [75502]: https://github.com/rust-lang/rust/pull/75502/
1072 [74880]: https://github.com/rust-lang/rust/pull/74880/
1073 [74922]: https://github.com/rust-lang/rust/pull/74922/
1074 [74430]: https://github.com/rust-lang/rust/pull/74430/
1075 [74194]: https://github.com/rust-lang/rust/pull/74194/
1076 [73461]: https://github.com/rust-lang/rust/pull/73461/
1077 [73166]: https://github.com/rust-lang/rust/pull/73166/
1078 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
1079 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
1080 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
1081 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
1082 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
1083 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
1084 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
1085 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
1086 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
1087 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
1088 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
1089 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
1090 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
1091 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
1092 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
1093
1094
1095 Version 1.47.0 (2020-10-08)
1096 ==========================
1097
1098 Language
1099 --------
1100 - [Closures will now warn when not used.][74869]
1101
1102 Compiler
1103 --------
1104 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
1105   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
1106   platforms.
1107 - [Upgraded to LLVM 11.][73526]
1108 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
1109 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
1110 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
1111
1112 \* Refer to Rust's [platform support page][platform-support-doc] for more
1113 information on Rust's tiered platform support.
1114
1115 Libraries
1116 ---------
1117 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
1118 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
1119   those of length less than 33.][74060]
1120 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
1121 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
1122   `PartialEq`, and `PartialOrd`.][73583]
1123
1124 Stabilized APIs
1125 ---------------
1126 - [`Ident::new_raw`]
1127 - [`Range::is_empty`]
1128 - [`RangeInclusive::is_empty`]
1129 - [`Result::as_deref`]
1130 - [`Result::as_deref_mut`]
1131 - [`Vec::leak`]
1132 - [`pointer::offset_from`]
1133 - [`f32::TAU`]
1134 - [`f64::TAU`]
1135
1136 The following previously stable APIs have now been made const.
1137
1138 - [The `new` method for all `NonZero` integers.][73858]
1139 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1140   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1141   methods for all integers.][73858]
1142 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1143   signed integers.][73858]
1144 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1145   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1146   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1147   `is_ascii_control` methods for `char` and `u8`.][73858]
1148
1149 Cargo
1150 -----
1151 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1152   You can override this by setting the following in your `Cargo.toml`.
1153   ```toml
1154   [profile.release.build-override]
1155   opt-level = 3
1156   ```
1157 - [`cargo-help` will now display man pages for commands rather just the
1158   `--help` text.][cargo/8456]
1159 - [`cargo-metadata` now emits a `test` field indicating if a target has
1160   tests enabled.][cargo/8478]
1161 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1162 - [`cargo-publish` will now use an alternative registry by default if it's the
1163   only registry specified in `package.publish`.][cargo/8571]
1164
1165 Misc
1166 ----
1167 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1168   type based search.][75366]
1169 - [Added the Ayu theme to rustdoc.][71237]
1170
1171 Compatibility Notes
1172 -------------------
1173 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1174 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1175 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1176   help to preserve more span information.][73084] These changes may cause
1177   compiliation errors if your macro was unhygenic or didn't correctly handle
1178   `Delimiter::None`.
1179 - [Moved support for the CloudABI target to tier 3.][75568]
1180 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1181 - [Added the `rustc-docs` component.][75560] This allows you to install
1182   and read the documentation for the compiler internal APIs. (Currently only
1183   available for `x86_64-unknown-linux-gnu`.)
1184
1185 Internal Only
1186 --------
1187
1188 - [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.
1189
1190 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1191 [75048]: https://github.com/rust-lang/rust/pull/75048/
1192 [74163]: https://github.com/rust-lang/rust/pull/74163/
1193 [71237]: https://github.com/rust-lang/rust/pull/71237/
1194 [74869]: https://github.com/rust-lang/rust/pull/74869/
1195 [73858]: https://github.com/rust-lang/rust/pull/73858/
1196 [75716]: https://github.com/rust-lang/rust/pull/75716/
1197 [75908]: https://github.com/rust-lang/rust/pull/75908/
1198 [75516]: https://github.com/rust-lang/rust/pull/75516/
1199 [75560]: https://github.com/rust-lang/rust/pull/75560/
1200 [75568]: https://github.com/rust-lang/rust/pull/75568/
1201 [75366]: https://github.com/rust-lang/rust/pull/75366/
1202 [75204]: https://github.com/rust-lang/rust/pull/75204/
1203 [74650]: https://github.com/rust-lang/rust/pull/74650/
1204 [74419]: https://github.com/rust-lang/rust/pull/74419/
1205 [73964]: https://github.com/rust-lang/rust/pull/73964/
1206 [74021]: https://github.com/rust-lang/rust/pull/74021/
1207 [74060]: https://github.com/rust-lang/rust/pull/74060/
1208 [73893]: https://github.com/rust-lang/rust/pull/73893/
1209 [73526]: https://github.com/rust-lang/rust/pull/73526/
1210 [73583]: https://github.com/rust-lang/rust/pull/73583/
1211 [73084]: https://github.com/rust-lang/rust/pull/73084/
1212 [73197]: https://github.com/rust-lang/rust/pull/73197/
1213 [72488]: https://github.com/rust-lang/rust/pull/72488/
1214 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1215 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1216 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1217 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1218 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1219 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1220 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1221 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1222 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1223 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1224 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1225 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1226 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1227 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1228 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1229
1230
1231 Version 1.46.0 (2020-08-27)
1232 ==========================
1233
1234 Language
1235 --------
1236 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1237 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1238   const functions.][73862]
1239 - [The `#[track_caller]` attribute can now be added to functions to use the
1240   function's caller's location information for panic messages.][72445]
1241 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1242   `x.0.0` over `(x.0).0`.
1243 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1244   You currently can't use `mem::transmute` in constant functions.
1245
1246 Compiler
1247 --------
1248 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1249 - [Enabled static "Position Independent Executables" by default
1250   for `x86_64-unknown-linux-musl`.][70740]
1251
1252 Libraries
1253 ---------
1254 - [`mem::forget` is now a `const fn`.][73887]
1255 - [`String` now implements `From<char>`.][73466]
1256 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1257   integer types.][73032]
1258 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1259 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1260   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1261 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1262 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1263 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1264
1265 Stabilized APIs
1266 ---------------
1267 - [`Option::zip`]
1268 - [`vec::Drain::as_slice`]
1269
1270 Cargo
1271 -----
1272 Added a number of new environment variables that are now available when
1273 compiling your crate.
1274
1275 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1276   the specific binary being compiled and the name of the crate.
1277 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1278 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1279
1280 Compatibility Notes
1281 -------------------
1282 - [The target configuration option `abi_blacklist` has been renamed
1283   to `unsupported_abis`.][74150] The old name will still continue to work.
1284 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1285   This was previously accepted but will become a hard error in a future release.
1286 - [Rustc will fail to compile if you have a struct with
1287   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1288   allowed on `enum`s.
1289 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1290   ensure that spans have the correct information, and may cause breakage if you
1291   were relying on receiving spans with dummy information.
1292 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1293   a legacy installer that was replaced by a MSI installer a few years ago but
1294   was still being built.
1295 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1296 - [Rustc will no longer accept overlapping trait implementations that only
1297   differ in how the lifetime was bound.][72493]
1298 - [Rustc now correctly relates the lifetime of an existential associated
1299   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1300   you to pass a shorter lifetime than expected.
1301 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1302   The library will need to be installed for `rustc` to work, even though we
1303   expect it to be already available on most systems.
1304 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1305   under QEMU.][74820]
1306 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1307   exact output returned by rustc's pretty printing is an unstable
1308   implementation detail: we recommend any macro relying on it to switch to a
1309   more robust parsing system.
1310
1311 [75453]: https://github.com/rust-lang/rust/issues/75453/
1312 [74820]: https://github.com/rust-lang/rust/issues/74820/
1313 [74420]: https://github.com/rust-lang/rust/issues/74420/
1314 [74109]: https://github.com/rust-lang/rust/pull/74109/
1315 [74150]: https://github.com/rust-lang/rust/pull/74150/
1316 [73862]: https://github.com/rust-lang/rust/pull/73862/
1317 [73887]: https://github.com/rust-lang/rust/pull/73887/
1318 [73466]: https://github.com/rust-lang/rust/pull/73466/
1319 [73516]: https://github.com/rust-lang/rust/pull/73516/
1320 [73293]: https://github.com/rust-lang/rust/pull/73293/
1321 [73007]: https://github.com/rust-lang/rust/pull/73007/
1322 [73032]: https://github.com/rust-lang/rust/pull/73032/
1323 [72920]: https://github.com/rust-lang/rust/pull/72920/
1324 [72569]: https://github.com/rust-lang/rust/pull/72569/
1325 [72583]: https://github.com/rust-lang/rust/pull/72583/
1326 [72584]: https://github.com/rust-lang/rust/pull/72584/
1327 [72717]: https://github.com/rust-lang/rust/pull/72717/
1328 [72437]: https://github.com/rust-lang/rust/pull/72437/
1329 [72445]: https://github.com/rust-lang/rust/pull/72445/
1330 [72486]: https://github.com/rust-lang/rust/pull/72486/
1331 [72493]: https://github.com/rust-lang/rust/pull/72493/
1332 [72331]: https://github.com/rust-lang/rust/pull/72331/
1333 [71896]: https://github.com/rust-lang/rust/pull/71896/
1334 [71660]: https://github.com/rust-lang/rust/pull/71660/
1335 [71322]: https://github.com/rust-lang/rust/pull/71322/
1336 [70740]: https://github.com/rust-lang/rust/pull/70740/
1337 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1338 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1339 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1340 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1341 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1342
1343
1344 Version 1.45.2 (2020-08-03)
1345 ==========================
1346
1347 * [Fix bindings in tuple struct patterns][74954]
1348 * [Fix track_caller integration with trait objects][74784]
1349
1350 [74954]: https://github.com/rust-lang/rust/issues/74954
1351 [74784]: https://github.com/rust-lang/rust/issues/74784
1352
1353
1354 Version 1.45.1 (2020-07-30)
1355 ==========================
1356
1357 * [Fix const propagation with references.][73613]
1358 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1359 * [Avoid spurious implicit region bound.][74509]
1360 * [Install clippy on x.py install][74457]
1361
1362 [73613]: https://github.com/rust-lang/rust/pull/73613
1363 [73078]: https://github.com/rust-lang/rust/issues/73078
1364 [74509]: https://github.com/rust-lang/rust/pull/74509
1365 [74457]: https://github.com/rust-lang/rust/pull/74457
1366
1367
1368 Version 1.45.0 (2020-07-16)
1369 ==========================
1370
1371 Language
1372 --------
1373 - [Out of range float to int conversions using `as` has been defined as a saturating
1374   conversion.][71269] This was previously undefined behaviour, but you can use the
1375    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1376    may be desirable in rare performance sensitive situations.
1377 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1378   using `u64`.][70705]
1379 - [Function like procedural macros can now be used in expression, pattern, and  statement
1380   positions.][68717] This means you can now use a function-like procedural macro
1381   anywhere you can use a declarative (`macro_rules!`) macro.
1382
1383 Compiler
1384 --------
1385 - [You can now override individual target features through the `target-feature`
1386   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1387   equivalent to `-C target-feature=+avx2,+fma`.
1388 - [Added the `force-unwind-tables` flag.][69984] This option allows
1389   rustc to always generate unwind tables regardless of panic strategy.
1390 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1391   to include LLVM bitcode into generated `rlib`s (this is on by default).
1392 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1393 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1394 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1395 - [Upgraded to LLVM 10.][67759]
1396
1397 \* Refer to Rust's [platform support page][platform-support-doc] for more
1398 information on Rust's tiered platform support.
1399
1400
1401 Libraries
1402 ---------
1403 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1404   and `Ord`.][72239]
1405 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1406 - [You can now use `char` with
1407   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1408   a range of codepoints.][72413] E.g.
1409   you can now write the following;
1410   ```rust
1411   for ch in 'a'..='z' {
1412       print!("{}", ch);
1413   }
1414   println!();
1415   // Prints "abcdefghijklmnopqrstuvwxyz"
1416   ```
1417 - [`OsString` now implements `FromStr`.][71662]
1418 - [The `saturating_neg` method has been added to all signed integer primitive
1419   types, and the `saturating_abs` method has been added for all integer
1420   primitive types.][71886]
1421 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1422   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1423   or `Path`.][71447]
1424 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1425 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1426   integer types.][69813]
1427 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1428   integer types.][72324]
1429 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1430
1431 Stabilized APIs
1432 ---------------
1433 - [`Arc::as_ptr`]
1434 - [`BTreeMap::remove_entry`]
1435 - [`Rc::as_ptr`]
1436 - [`rc::Weak::as_ptr`]
1437 - [`rc::Weak::from_raw`]
1438 - [`rc::Weak::into_raw`]
1439 - [`str::strip_prefix`]
1440 - [`str::strip_suffix`]
1441 - [`sync::Weak::as_ptr`]
1442 - [`sync::Weak::from_raw`]
1443 - [`sync::Weak::into_raw`]
1444 - [`char::UNICODE_VERSION`]
1445 - [`Span::resolved_at`]
1446 - [`Span::located_at`]
1447 - [`Span::mixed_site`]
1448 - [`unix::process::CommandExt::arg0`]
1449
1450 Cargo
1451 -----
1452
1453 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1454   time.][cargo/8066]
1455
1456 Misc
1457 ----
1458 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1459   `~~outdated information~~` becomes "~~outdated information~~".
1460 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1461
1462 Compatibility Notes
1463 -------------------
1464 - [Trying to self initialize a static value (that is creating a value using
1465   itself) is unsound and now causes a compile error.][71140]
1466 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1467   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1468 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1469   previously undocumented and not intended for public use. Rustdoc still provides
1470   a non-zero exit code on errors.
1471 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1472   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1473   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1474   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1475   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1476
1477 Internals Only
1478 --------------
1479 - [Make clippy a git subtree instead of a git submodule][70655]
1480 - [Unify the undo log of all snapshot types][69464]
1481
1482 [71848]: https://github.com/rust-lang/rust/issues/71848/
1483 [73420]: https://github.com/rust-lang/rust/issues/73420/
1484 [72324]: https://github.com/rust-lang/rust/pull/72324/
1485 [71843]: https://github.com/rust-lang/rust/pull/71843/
1486 [71886]: https://github.com/rust-lang/rust/pull/71886/
1487 [72234]: https://github.com/rust-lang/rust/pull/72234/
1488 [72239]: https://github.com/rust-lang/rust/pull/72239/
1489 [72397]: https://github.com/rust-lang/rust/pull/72397/
1490 [72413]: https://github.com/rust-lang/rust/pull/72413/
1491 [72014]: https://github.com/rust-lang/rust/pull/72014/
1492 [72062]: https://github.com/rust-lang/rust/pull/72062/
1493 [72094]: https://github.com/rust-lang/rust/pull/72094/
1494 [72133]: https://github.com/rust-lang/rust/pull/72133/
1495 [67759]: https://github.com/rust-lang/rust/pull/67759/
1496 [71900]: https://github.com/rust-lang/rust/pull/71900/
1497 [71928]: https://github.com/rust-lang/rust/pull/71928/
1498 [71662]: https://github.com/rust-lang/rust/pull/71662/
1499 [71716]: https://github.com/rust-lang/rust/pull/71716/
1500 [71447]: https://github.com/rust-lang/rust/pull/71447/
1501 [71269]: https://github.com/rust-lang/rust/pull/71269/
1502 [71095]: https://github.com/rust-lang/rust/pull/71095/
1503 [71140]: https://github.com/rust-lang/rust/pull/71140/
1504 [70655]: https://github.com/rust-lang/rust/pull/70655/
1505 [70705]: https://github.com/rust-lang/rust/pull/70705/
1506 [69984]: https://github.com/rust-lang/rust/pull/69984/
1507 [69813]: https://github.com/rust-lang/rust/pull/69813/
1508 [69464]: https://github.com/rust-lang/rust/pull/69464/
1509 [68717]: https://github.com/rust-lang/rust/pull/68717/
1510 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1511 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1512 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1513 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1514 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1515 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1516 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1517 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1518 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1519 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1520 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1521 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1522 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1523 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1524 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1525 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1526 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1527
1528
1529 Version 1.44.1 (2020-06-18)
1530 ===========================
1531
1532 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1533 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1534 * [Fix crashes when finding backtrace on macOS.][71397]
1535 * [Clippy applies lint levels into different files.][clippy/5356]
1536
1537 [71397]: https://github.com/rust-lang/rust/issues/71397
1538 [73078]: https://github.com/rust-lang/rust/issues/73078
1539 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1540 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1541
1542
1543 Version 1.44.0 (2020-06-04)
1544 ==========================
1545
1546 Language
1547 --------
1548 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1549 - [Added the `unused_braces` lint.][70081]
1550
1551 **Syntax-only changes**
1552
1553 - [Expansion-driven outline module parsing][69838]
1554 ```rust
1555 #[cfg(FALSE)]
1556 mod foo {
1557     mod bar {
1558         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1559     }
1560 }
1561 ```
1562
1563 These are still rejected semantically, so you will likely receive an error but
1564 these changes can be seen and parsed by macros and conditional compilation.
1565
1566 Compiler
1567 --------
1568 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1569   Additionally when in incremental mode rustc defaults to 256 codegen units.
1570 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1571   a panic is thrown.][67502]
1572 - [Added tier 3\* support for the `aarch64-unknown-none` and
1573   `aarch64-unknown-none-softfloat` targets.][68334]
1574 - [Added tier 3 support for `arm64-apple-tvos` and
1575   `x86_64-apple-tvos` targets.][68191]
1576
1577
1578 Libraries
1579 ---------
1580 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1581   `vec![]` to be able to be used in `const` contexts.
1582 - [`convert::Infallible` now implements `Hash`.][70281]
1583 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1584   a `&mut OsStr`.][70048]
1585 - [Unicode 13 is now supported.][69929]
1586 - [`String` now implements `From<&mut str>`.][69661]
1587 - [`IoSlice` now implements `Copy`.][69403]
1588 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1589 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1590 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1591   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1592   integer types.][69373]
1593
1594 Stabilized APIs
1595 ---------------
1596 - [`PathBuf::with_capacity`]
1597 - [`PathBuf::capacity`]
1598 - [`PathBuf::clear`]
1599 - [`PathBuf::reserve`]
1600 - [`PathBuf::reserve_exact`]
1601 - [`PathBuf::shrink_to_fit`]
1602 - [`f32::to_int_unchecked`]
1603 - [`f64::to_int_unchecked`]
1604 - [`Layout::align_to`]
1605 - [`Layout::pad_to_align`]
1606 - [`Layout::array`]
1607 - [`Layout::extend`]
1608
1609 Cargo
1610 -----
1611 - [Added the `cargo tree` command which will print a tree graph of
1612   your dependencies.][cargo/8062] E.g.
1613   ```
1614     mdbook v0.3.2 (/Users/src/rust/mdbook)
1615   ├── ammonia v3.0.0
1616   │   ├── html5ever v0.24.0
1617   │   │   ├── log v0.4.8
1618   │   │   │   └── cfg-if v0.1.9
1619   │   │   ├── mac v0.1.1
1620   │   │   └── markup5ever v0.9.0
1621   │   │       ├── log v0.4.8 (*)
1622   │   │       ├── phf v0.7.24
1623   │   │       │   └── phf_shared v0.7.24
1624   │   │       │       ├── siphasher v0.2.3
1625   │   │       │       └── unicase v1.4.2
1626   │   │       │           [build-dependencies]
1627   │   │       │           └── version_check v0.1.5
1628   ...
1629   ```
1630   You can also display dependencies on multiple versions of the same crate with
1631   `cargo tree -d` (short for `cargo tree --duplicates`).
1632
1633 Misc
1634 ----
1635 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1636   the version in the sidebar.][69494]
1637
1638 Compatibility Notes
1639 -------------------
1640 - [Rustc now correctly generates static libraries on Windows GNU targets with
1641   the `.a` extension, rather than the previous `.lib`.][70937]
1642 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1643 - [The `file_name` property in JSON output of macro errors now points the actual
1644   source file rather than the previous format of `<NAME macros>`.][70969]
1645   **Note:** this may not point to a file that actually exists on the user's system.
1646 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1647 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1648   not allow zero initialization such as `NonZeroU8`.][66059] This was
1649   previously a warning.
1650 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1651   operator has been defined as a saturating operation.][71269] This was previously
1652   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1653   continue using the current behaviour, which may be desirable in rare performance
1654   sensitive situations.
1655
1656 Internal Only
1657 -------------
1658 These changes provide no direct user facing benefits, but represent significant
1659 improvements to the internals and overall performance of rustc and
1660 related tools.
1661
1662 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1663 - [Replace big JS dict with JSON parsing.][71250]
1664
1665 [69373]: https://github.com/rust-lang/rust/pull/69373/
1666 [66059]: https://github.com/rust-lang/rust/pull/66059/
1667 [68191]: https://github.com/rust-lang/rust/pull/68191/
1668 [68899]: https://github.com/rust-lang/rust/pull/68899/
1669 [71147]: https://github.com/rust-lang/rust/pull/71147/
1670 [71250]: https://github.com/rust-lang/rust/pull/71250/
1671 [70937]: https://github.com/rust-lang/rust/pull/70937/
1672 [70969]: https://github.com/rust-lang/rust/pull/70969/
1673 [70632]: https://github.com/rust-lang/rust/pull/70632/
1674 [70281]: https://github.com/rust-lang/rust/pull/70281/
1675 [70345]: https://github.com/rust-lang/rust/pull/70345/
1676 [70048]: https://github.com/rust-lang/rust/pull/70048/
1677 [70081]: https://github.com/rust-lang/rust/pull/70081/
1678 [70156]: https://github.com/rust-lang/rust/pull/70156/
1679 [71269]: https://github.com/rust-lang/rust/pull/71269/
1680 [69838]: https://github.com/rust-lang/rust/pull/69838/
1681 [69929]: https://github.com/rust-lang/rust/pull/69929/
1682 [69661]: https://github.com/rust-lang/rust/pull/69661/
1683 [69778]: https://github.com/rust-lang/rust/pull/69778/
1684 [69494]: https://github.com/rust-lang/rust/pull/69494/
1685 [69403]: https://github.com/rust-lang/rust/pull/69403/
1686 [69033]: https://github.com/rust-lang/rust/pull/69033/
1687 [68692]: https://github.com/rust-lang/rust/pull/68692/
1688 [68334]: https://github.com/rust-lang/rust/pull/68334/
1689 [67502]: https://github.com/rust-lang/rust/pull/67502/
1690 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1691 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1692 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1693 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1694 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1695 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1696 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1697 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1698 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1699 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1700 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1701 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1702 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1703
1704
1705 Version 1.43.1 (2020-05-07)
1706 ===========================
1707
1708 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1709 * [Fixed the stabilization of AVX-512 features.][71473]
1710 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1711
1712 [71430]: https://github.com/rust-lang/rust/pull/71430
1713 [71473]: https://github.com/rust-lang/rust/issues/71473
1714 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1715
1716
1717 Version 1.43.0 (2020-04-23)
1718 ==========================
1719
1720 Language
1721 --------
1722 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1723   the type inferred correctly.][68129]
1724 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1725
1726 **Syntax only changes**
1727 - [Allow `type Foo: Ord` syntactically.][69361]
1728 - [Fuse associated and extern items up to defaultness.][69194]
1729 - [Syntactically allow `self` in all `fn` contexts.][68764]
1730 - [Merge `fn` syntax + cleanup item parsing.][68728]
1731 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1732   For example, you may now write:
1733   ```rust
1734   macro_rules! mac_trait {
1735       ($i:item) => {
1736           trait T { $i }
1737       }
1738   }
1739   mac_trait! {
1740       fn foo() {}
1741   }
1742   ```
1743
1744 These are still rejected *semantically*, so you will likely receive an error but
1745 these changes can be seen and parsed by macros and
1746 conditional compilation.
1747
1748
1749 Compiler
1750 --------
1751 - [You can now pass multiple lint flags to rustc to override the previous
1752   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1753   everything in the `unused` lint group except `unused-variables` which
1754   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1755   everything in the `unused` lint group **including** `unused-variables` since
1756   the allow flag is specified before the deny flag (and therefore overridden).
1757 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1758   if they are available on `windows-gnu`.][67429]
1759 - [rustc now buffers errors/warnings printed in JSON.][69227]
1760
1761 Libraries
1762 ---------
1763 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1764   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1765   respectively.][69538] **Note** These conversions are only available when `N`
1766   is `0..=32`.
1767 - [You can now use associated constants on floats and integers directly, rather
1768   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1769   `f32::NAN` with no imports.
1770 - [`u8::is_ascii` is now `const`.][68984]
1771 - [`String` now implements `AsMut<str>`.][68742]
1772 - [Added the `primitive` module to `std` and `core`.][67637] This module
1773   reexports Rust's primitive types. This is mainly useful in macros
1774   where you want avoid these types being shadowed.
1775 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1776 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1777
1778 Stabilized APIs
1779 ---------------
1780 - [`Once::is_completed`]
1781 - [`f32::LOG10_2`]
1782 - [`f32::LOG2_10`]
1783 - [`f64::LOG10_2`]
1784 - [`f64::LOG2_10`]
1785 - [`iter::once_with`]
1786
1787 Cargo
1788 -----
1789 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1790   your environment.][cargo/7823]
1791 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1792   executable path when running integration tests or benchmarks.][cargo/7697]
1793   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1794   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1795
1796 Misc
1797 ----
1798 - [Certain checks in the `const_err` lint were deemed unrelated to const
1799   evaluation][69185], and have been moved to the `unconditional_panic` and
1800   `arithmetic_overflow` lints.
1801
1802 Compatibility Notes
1803 -------------------
1804
1805 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1806   has been a warning since 1.36.0.
1807 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1808   led to some instances being accepted, and now correctly emits a hard error.
1809
1810 [69340]: https://github.com/rust-lang/rust/pull/69340
1811
1812 Internal Only
1813 -------------
1814 These changes provide no direct user facing benefits, but represent significant
1815 improvements to the internals and overall performance of `rustc` and
1816 related tools.
1817
1818 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1819 - [Improved how rustc generates drop code.][67332]
1820 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1821 - [traits: preallocate 2 Vecs of known initial size][69022]
1822 - [Avoid exponential behaviour when relating types][68772]
1823 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1824 - [Improve performance of coherence checks][68966]
1825 - [Deduplicate types in the generator witness][68672]
1826 - [Invert control in struct_lint_level.][68725]
1827
1828 [67332]: https://github.com/rust-lang/rust/pull/67332/
1829 [67429]: https://github.com/rust-lang/rust/pull/67429/
1830 [67637]: https://github.com/rust-lang/rust/pull/67637/
1831 [67642]: https://github.com/rust-lang/rust/pull/67642/
1832 [67878]: https://github.com/rust-lang/rust/pull/67878/
1833 [67885]: https://github.com/rust-lang/rust/pull/67885/
1834 [68129]: https://github.com/rust-lang/rust/pull/68129/
1835 [68672]: https://github.com/rust-lang/rust/pull/68672/
1836 [68725]: https://github.com/rust-lang/rust/pull/68725/
1837 [68728]: https://github.com/rust-lang/rust/pull/68728/
1838 [68738]: https://github.com/rust-lang/rust/pull/68738/
1839 [68742]: https://github.com/rust-lang/rust/pull/68742/
1840 [68764]: https://github.com/rust-lang/rust/pull/68764/
1841 [68772]: https://github.com/rust-lang/rust/pull/68772/
1842 [68943]: https://github.com/rust-lang/rust/pull/68943/
1843 [68952]: https://github.com/rust-lang/rust/pull/68952/
1844 [68966]: https://github.com/rust-lang/rust/pull/68966/
1845 [68984]: https://github.com/rust-lang/rust/pull/68984/
1846 [69022]: https://github.com/rust-lang/rust/pull/69022/
1847 [69185]: https://github.com/rust-lang/rust/pull/69185/
1848 [69194]: https://github.com/rust-lang/rust/pull/69194/
1849 [69201]: https://github.com/rust-lang/rust/pull/69201/
1850 [69227]: https://github.com/rust-lang/rust/pull/69227/
1851 [69548]: https://github.com/rust-lang/rust/pull/69548/
1852 [69256]: https://github.com/rust-lang/rust/pull/69256/
1853 [69361]: https://github.com/rust-lang/rust/pull/69361/
1854 [69366]: https://github.com/rust-lang/rust/pull/69366/
1855 [69538]: https://github.com/rust-lang/rust/pull/69538/
1856 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1857 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1858 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1859 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1860 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1861 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1862 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1863 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1864
1865
1866 Version 1.42.0 (2020-03-12)
1867 ==========================
1868
1869 Language
1870 --------
1871 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1872   ```rust
1873   fn foo(words: &[&str]) {
1874       match words {
1875           ["Hello", "World", "!", ..] => println!("Hello World!"),
1876           ["Foo", "Bar", ..] => println!("Baz"),
1877           rest => println!("{:?}", rest),
1878       }
1879   }
1880   ```
1881 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1882   that you can create an enum that has the exact layout and ABI of the type
1883   it contains.
1884 - [You can now use outer attribute procedural macros on inline modules.][64273]
1885 - [There are some *syntax-only* changes:][67131]
1886    - `default` is syntactically allowed before items in `trait` definitions.
1887    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1888      leave out their bodies in favor of `;`.
1889    - Bounds on associated types in `impl`s are now syntactically allowed
1890      (e.g. `type Foo: Ord;`).
1891    - `...` (the C-variadic type) may occur syntactically directly as the type of
1892       any function parameter.
1893
1894   These are still rejected *semantically*, so you will likely receive an error
1895   but these changes can be seen and parsed by procedural macros and
1896   conditional compilation.
1897
1898 Compiler
1899 --------
1900 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1901 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1902 - [`Option::{expect,unwrap}` and
1903    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1904    pointing to the location where they were called, rather than
1905    `core`'s internals. ][67887]
1906
1907 \* Refer to Rust's [platform support page][platform-support-doc] for more
1908 information on Rust's tiered platform support.
1909
1910 Libraries
1911 ---------
1912 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1913 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1914    to implement `Sized`.][67935]
1915 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1916 - [`Layout::new` is now `const`.][66254]
1917 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1918
1919
1920 Stabilized APIs
1921 ---------------
1922 - [`CondVar::wait_while`]
1923 - [`CondVar::wait_timeout_while`]
1924 - [`DebugMap::key`]
1925 - [`DebugMap::value`]
1926 - [`ManuallyDrop::take`]
1927 - [`matches!`]
1928 - [`ptr::slice_from_raw_parts_mut`]
1929 - [`ptr::slice_from_raw_parts`]
1930
1931 Cargo
1932 -----
1933 - [You no longer need to include `extern crate proc_macro;` to be able to
1934   `use proc_macro;` in the `2018` edition.][cargo/7700]
1935
1936 Compatibility Notes
1937 -------------------
1938 - [`Error::description` has been deprecated, and its use will now produce a
1939   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1940
1941 [68253]: https://github.com/rust-lang/rust/pull/68253/
1942 [68348]: https://github.com/rust-lang/rust/pull/68348/
1943 [67935]: https://github.com/rust-lang/rust/pull/67935/
1944 [68339]: https://github.com/rust-lang/rust/pull/68339/
1945 [68122]: https://github.com/rust-lang/rust/pull/68122/
1946 [64273]: https://github.com/rust-lang/rust/pull/64273/
1947 [67712]: https://github.com/rust-lang/rust/pull/67712/
1948 [67887]: https://github.com/rust-lang/rust/pull/67887/
1949 [67131]: https://github.com/rust-lang/rust/pull/67131/
1950 [67233]: https://github.com/rust-lang/rust/pull/67233/
1951 [66899]: https://github.com/rust-lang/rust/pull/66899/
1952 [66919]: https://github.com/rust-lang/rust/pull/66919/
1953 [66254]: https://github.com/rust-lang/rust/pull/66254/
1954 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1955 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1956 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1957 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1958 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1959 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1960 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1961 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1962 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1963
1964
1965 Version 1.41.1 (2020-02-27)
1966 ===========================
1967
1968 * [Always check types of static items][69145]
1969 * [Always check lifetime bounds of `Copy` impls][69145]
1970 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1971
1972 [69225]: https://github.com/rust-lang/rust/issues/69225
1973 [69145]: https://github.com/rust-lang/rust/pull/69145
1974
1975
1976 Version 1.41.0 (2020-01-30)
1977 ===========================
1978
1979 Language
1980 --------
1981
1982 - [You can now pass type parameters to foreign items when implementing
1983   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1984 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1985   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1986   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1987 - [You can now use any valid identifier in a `format_args` macro.][66847]
1988   Previously identifiers starting with an underscore were not allowed.
1989 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1990   enum variants.][66183] These are still rejected semantically, but
1991   can be seen and parsed by procedural macros and conditional compilation.
1992
1993 Compiler
1994 --------
1995
1996 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1997 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1998 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1999 - [You can now pass an arguments file passing the `@path` syntax
2000   to rustc.][66172] Note that the format differs somewhat from what is
2001   found in other tooling; please see [the documentation][argfile-docs] for
2002   more information.
2003 - [You can now provide `--extern` flag without a path, indicating that it is
2004   available from the search path or specified with an `-L` flag.][64882]
2005
2006 \* Refer to Rust's [platform support page][platform-support-doc] for more
2007 information on Rust's tiered platform support.
2008
2009 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
2010
2011 Libraries
2012 ---------
2013
2014 - [The `core::panic` module is now stable.][66771] It was already stable
2015   through `std`.
2016 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
2017   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
2018 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
2019
2020 Stabilized APIs
2021 ---------------
2022
2023 - [`Result::map_or`]
2024 - [`Result::map_or_else`]
2025 - [`std::rc::Weak::weak_count`]
2026 - [`std::rc::Weak::strong_count`]
2027 - [`std::sync::Weak::weak_count`]
2028 - [`std::sync::Weak::strong_count`]
2029
2030 Cargo
2031 -----
2032
2033 - [Cargo will now document all the private items for binary crates
2034   by default.][cargo/7593]
2035 - [`cargo-install` will now reinstall the package if it detects that it is out
2036   of date.][cargo/7560]
2037 - [Cargo.lock now uses a more git friendly format that should help to reduce
2038   merge conflicts.][cargo/7579]
2039 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
2040   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
2041   optimisation level to `2` for debug builds. You can also use
2042   `[profile.<profile>.build-override]` to override build scripts and
2043   their dependencies.
2044
2045 Misc
2046 ----
2047
2048 - [You can now specify `edition` in documentation code blocks to compile the block
2049   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
2050   should be compiled the 2018 edition of Rust.
2051 - [You can now provide custom themes to rustdoc with `--theme`, and check the
2052   current theme with `--check-theme`.][54733]
2053 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
2054
2055 Compatibility Notes
2056 -------------------
2057
2058 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
2059   Apple targets.][apple-32bit-drop] This means that the source code is still
2060   available to build, but the targets are no longer being tested and release
2061   binaries for those platforms will no longer be distributed by the Rust project.
2062   Please refer to the linked blog post for more information.
2063
2064 [54733]: https://github.com/rust-lang/rust/pull/54733/
2065 [61351]: https://github.com/rust-lang/rust/pull/61351/
2066 [67255]: https://github.com/rust-lang/rust/pull/67255/
2067 [66661]: https://github.com/rust-lang/rust/pull/66661/
2068 [66771]: https://github.com/rust-lang/rust/pull/66771/
2069 [66847]: https://github.com/rust-lang/rust/pull/66847/
2070 [66238]: https://github.com/rust-lang/rust/pull/66238/
2071 [66277]: https://github.com/rust-lang/rust/pull/66277/
2072 [66325]: https://github.com/rust-lang/rust/pull/66325/
2073 [66172]: https://github.com/rust-lang/rust/pull/66172/
2074 [66183]: https://github.com/rust-lang/rust/pull/66183/
2075 [65879]: https://github.com/rust-lang/rust/pull/65879/
2076 [65013]: https://github.com/rust-lang/rust/pull/65013/
2077 [64882]: https://github.com/rust-lang/rust/pull/64882/
2078 [64325]: https://github.com/rust-lang/rust/pull/64325/
2079 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
2080 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
2081 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
2082 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
2083 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
2084 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
2085 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
2086 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
2087 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
2088 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
2089 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
2090
2091 Version 1.40.0 (2019-12-19)
2092 ===========================
2093
2094 Language
2095 --------
2096 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
2097   `const` contexts.][65188] e.g.
2098
2099   ```rust
2100   pub struct Point(i32, i32);
2101
2102   const ORIGIN: Point = {
2103       let constructor = Point;
2104
2105       constructor(0, 0)
2106   };
2107   ```
2108
2109 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
2110   indicate that there may be variants or fields added in the future.][64639]
2111   For example this requires adding a wild-card branch (`_ => {}`) to any match
2112   statements on a non-exhaustive `enum`. [(RFC 2008)]
2113 - [You can now use function-like procedural macros in `extern` blocks and in
2114   type positions.][63931] e.g. `type Generated = macro!();`
2115 - [Function-like and attribute procedural macros can now emit
2116   `macro_rules!` items, so you can now have your macros generate macros.][64035]
2117 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
2118   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
2119   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
2120
2121 Compiler
2122 --------
2123 - [Added tier 3 support\* for the
2124   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
2125 - [Added tier 3 support for the
2126   `aarch64-unknown-none-softfloat` target.][64589]
2127 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
2128   `mips64el-unknown-linux-muslabi64` targets.][65843]
2129
2130 \* Refer to Rust's [platform support page][platform-support-doc] for more
2131   information on Rust's tiered platform support.
2132
2133 Libraries
2134 ---------
2135 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2136
2137 Stabilized APIs
2138 ---------------
2139 - [`BTreeMap::get_key_value`]
2140 - [`HashMap::get_key_value`]
2141 - [`Option::as_deref_mut`]
2142 - [`Option::as_deref`]
2143 - [`Option::flatten`]
2144 - [`UdpSocket::peer_addr`]
2145 - [`f32::to_be_bytes`]
2146 - [`f32::to_le_bytes`]
2147 - [`f32::to_ne_bytes`]
2148 - [`f64::to_be_bytes`]
2149 - [`f64::to_le_bytes`]
2150 - [`f64::to_ne_bytes`]
2151 - [`f32::from_be_bytes`]
2152 - [`f32::from_le_bytes`]
2153 - [`f32::from_ne_bytes`]
2154 - [`f64::from_be_bytes`]
2155 - [`f64::from_le_bytes`]
2156 - [`f64::from_ne_bytes`]
2157 - [`mem::take`]
2158 - [`slice::repeat`]
2159 - [`todo!`]
2160
2161 Cargo
2162 -----
2163 - [Cargo will now always display warnings, rather than only on
2164   fresh builds.][cargo/7450]
2165 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2166   now produce an error.][cargo/7507] Previously these flags were ignored.
2167 - [You can now publish `dev-dependencies` without including
2168   a `version`.][cargo/7333]
2169
2170 Misc
2171 ----
2172 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2173   when running documentation tests with `rustdoc`.][63803]
2174
2175 Compatibility Notes
2176 -------------------
2177 - [As previously announced, any previous NLL warnings in the 2015 edition are
2178   now hard errors.][64221]
2179 - [The `include!` macro will now warn if it failed to include the
2180   entire file.][64284] The `include!` macro unintentionally only includes the
2181   first _expression_ in a file, and this can be unintuitive. This will become
2182   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2183 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2184   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2185   or `extern` blocks now correctly emits a hard error.
2186
2187 [65294]: https://github.com/rust-lang/rust/pull/65294/
2188 [66103]: https://github.com/rust-lang/rust/pull/66103/
2189 [65843]: https://github.com/rust-lang/rust/pull/65843/
2190 [65188]: https://github.com/rust-lang/rust/pull/65188/
2191 [65092]: https://github.com/rust-lang/rust/pull/65092/
2192 [64589]: https://github.com/rust-lang/rust/pull/64589/
2193 [64639]: https://github.com/rust-lang/rust/pull/64639/
2194 [64221]: https://github.com/rust-lang/rust/pull/64221/
2195 [64284]: https://github.com/rust-lang/rust/pull/64284/
2196 [63931]: https://github.com/rust-lang/rust/pull/63931/
2197 [64035]: https://github.com/rust-lang/rust/pull/64035/
2198 [63674]: https://github.com/rust-lang/rust/pull/63674/
2199 [63803]: https://github.com/rust-lang/rust/pull/63803/
2200 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2201 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2202 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2203 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2204 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2205 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2206 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2207 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2208 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2209 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2210 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2211 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2212 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2213 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2214 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2215 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2216 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2217 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2218 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2219 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2220 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2221 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2222 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2223 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2224 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2225 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2226
2227
2228 Version 1.39.0 (2019-11-07)
2229 ===========================
2230
2231 Language
2232 --------
2233 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2234   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2235 - [You can now use certain attributes on function, closure, and function pointer
2236   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2237   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2238   attributes applied to items. e.g.
2239   ```rust
2240   fn len(
2241       #[cfg(windows)] slice: &[u16],
2242       #[cfg(not(windows))] slice: &[u8],
2243   ) -> usize {
2244       slice.len()
2245   }
2246   ```
2247 - [You can now take shared references to bind-by-move patterns in the `if` guards
2248   of `match` arms.][63118] e.g.
2249   ```rust
2250   fn main() {
2251       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2252
2253       match array {
2254           nums
2255   //      ---- `nums` is bound by move.
2256               if nums.iter().sum::<u8>() == 10
2257   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2258           => {
2259               drop(nums);
2260   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2261           }
2262           _ => unreachable!(),
2263       }
2264   }
2265   ```
2266
2267
2268
2269 Compiler
2270 --------
2271 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2272 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2273 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2274   **Note** Cargo currently doesn't use this feature. Refer to
2275   [cargo#7315][cargo/7315] to track this feature's progress.
2276 - [You can now pass `--show-output` argument to test binaries to print the
2277   output of successful tests.][62600]
2278
2279
2280 \* Refer to Rust's [platform support page][platform-support-doc] for more
2281 information on Rust's tiered platform support.
2282
2283 Libraries
2284 ---------
2285 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2286 - [`LinkedList::new` is now a `const` function.][63684]
2287 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2288 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2289   now `const`.][63786]
2290
2291 Stabilized APIs
2292 ---------------
2293 - [`Pin::into_inner`]
2294 - [`Instant::checked_duration_since`]
2295 - [`Instant::saturating_duration_since`]
2296
2297 Cargo
2298 -----
2299 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2300 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2301   `--all` is now deprecated.
2302
2303 Misc
2304 ----
2305 - [You can now pass `-Clinker` to rustdoc to control the linker used
2306   for compiling doctests.][63834]
2307
2308 Compatibility Notes
2309 -------------------
2310 - [Code that was previously accepted by the old borrow checker, but rejected by
2311   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2312   previously a warning, and will also become a hard error in the Rust 2015
2313   edition in the 1.40.0 release.
2314 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2315   run tests.][63827] This should improve performance when running a large
2316   amount of doctests.
2317 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2318   recommended to use the `?` operator instead.
2319 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2320   returned `0.0`.
2321
2322 [62600]: https://github.com/rust-lang/rust/pull/62600/
2323 [62672]: https://github.com/rust-lang/rust/pull/62672/
2324 [63118]: https://github.com/rust-lang/rust/pull/63118/
2325 [63209]: https://github.com/rust-lang/rust/pull/63209/
2326 [63402]: https://github.com/rust-lang/rust/pull/63402/
2327 [63565]: https://github.com/rust-lang/rust/pull/63565/
2328 [63595]: https://github.com/rust-lang/rust/pull/63595/
2329 [63684]: https://github.com/rust-lang/rust/pull/63684/
2330 [63698]: https://github.com/rust-lang/rust/pull/63698/
2331 [63770]: https://github.com/rust-lang/rust/pull/63770/
2332 [63786]: https://github.com/rust-lang/rust/pull/63786/
2333 [63827]: https://github.com/rust-lang/rust/pull/63827/
2334 [63834]: https://github.com/rust-lang/rust/pull/63834/
2335 [63927]: https://github.com/rust-lang/rust/pull/63927/
2336 [63933]: https://github.com/rust-lang/rust/pull/63933/
2337 [63934]: https://github.com/rust-lang/rust/pull/63934/
2338 [63938]: https://github.com/rust-lang/rust/pull/63938/
2339 [63940]: https://github.com/rust-lang/rust/pull/63940/
2340 [63941]: https://github.com/rust-lang/rust/pull/63941/
2341 [63945]: https://github.com/rust-lang/rust/pull/63945/
2342 [64010]: https://github.com/rust-lang/rust/pull/64010/
2343 [64028]: https://github.com/rust-lang/rust/pull/64028/
2344 [64334]: https://github.com/rust-lang/rust/pull/64334/
2345 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2346 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2347 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2348 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2349 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2350 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2351
2352 Version 1.38.0 (2019-09-26)
2353 ==========================
2354
2355 Language
2356 --------
2357 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2358 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2359
2360 Compiler
2361 --------
2362 - [Added pipelined compilation support to `rustc`.][62766] This will
2363   improve compilation times in some cases. For further information please refer
2364   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2365 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2366   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2367   `x86_64-uwp-windows-msvc` targets.][60260]
2368 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2369   `armv7-unknown-linux-musleabi` targets.][63107]
2370 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2371 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2372 - [Upgraded to LLVM 9.][62592]
2373
2374 \* Refer to Rust's [platform support page][platform-support-doc] for more
2375 information on Rust's tiered platform support.
2376
2377 Libraries
2378 ---------
2379 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2380 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2381   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2382   is available at `std::clone::Clone`). This also makes all built-in macros
2383   available in `std`/`core` root. e.g. `std::include_bytes!`.
2384 - [`str::Chars` now implements `Debug`.][63000]
2385 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2386 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2387 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2388 - [Added euclidean remainder and division operations (`div_euclid`,
2389   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2390   `overflowing`, and `wrapping` versions are available for all
2391   integer primitives.
2392 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2393   `PartialEq`.][61491]
2394 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2395
2396 Stabilized APIs
2397 ---------------
2398 - [`<*const T>::cast`]
2399 - [`<*mut T>::cast`]
2400 - [`Duration::as_secs_f32`]
2401 - [`Duration::as_secs_f64`]
2402 - [`Duration::div_f32`]
2403 - [`Duration::div_f64`]
2404 - [`Duration::from_secs_f32`]
2405 - [`Duration::from_secs_f64`]
2406 - [`Duration::mul_f32`]
2407 - [`Duration::mul_f64`]
2408 - [`any::type_name`]
2409
2410 Cargo
2411 -----
2412 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2413 - [You can now pass the `--features` option multiple times to enable
2414   multiple features.][cargo/7084]
2415
2416 Rustdoc
2417 -------
2418
2419 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2420
2421 Misc
2422 ----
2423 - [`rustc` will now warn about some incorrect uses of
2424   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2425
2426 Compatibility Notes
2427 -------------------
2428 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2429   1.38.0.
2430 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2431   issues][62896] with certain crates such as libc.
2432
2433 [60260]: https://github.com/rust-lang/rust/pull/60260/
2434 [61457]: https://github.com/rust-lang/rust/pull/61457/
2435 [61491]: https://github.com/rust-lang/rust/pull/61491/
2436 [61884]: https://github.com/rust-lang/rust/pull/61884/
2437 [61953]: https://github.com/rust-lang/rust/pull/61953/
2438 [62042]: https://github.com/rust-lang/rust/pull/62042/
2439 [62528]: https://github.com/rust-lang/rust/pull/62528/
2440 [62583]: https://github.com/rust-lang/rust/pull/62583/
2441 [62735]: https://github.com/rust-lang/rust/pull/62735/
2442 [62766]: https://github.com/rust-lang/rust/pull/62766/
2443 [62784]: https://github.com/rust-lang/rust/pull/62784/
2444 [62592]: https://github.com/rust-lang/rust/pull/62592/
2445 [62785]: https://github.com/rust-lang/rust/issues/62785/
2446 [62814]: https://github.com/rust-lang/rust/pull/62814/
2447 [62896]: https://github.com/rust-lang/rust/issues/62896/
2448 [63000]: https://github.com/rust-lang/rust/pull/63000/
2449 [63056]: https://github.com/rust-lang/rust/pull/63056/
2450 [63107]: https://github.com/rust-lang/rust/pull/63107/
2451 [63346]: https://github.com/rust-lang/rust/pull/63346/
2452 [63421]: https://github.com/rust-lang/rust/pull/63421/
2453 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2454 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2455 [63048]: https://github.com/rust-lang/rust/pull/63048
2456 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2457 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2458 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2459 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2460 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2461 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2462 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2463 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2464 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2465 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2466 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2467 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2468 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2469
2470 Version 1.37.0 (2019-08-15)
2471 ==========================
2472
2473 Language
2474 --------
2475 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2476   [`Box`][62228], or an [array][62235] and unused.
2477 - [You can now use the `cfg` and `cfg_attr` attributes on
2478   generic parameters.][61547]
2479 - [You can now use enum variants through type alias.][61682] e.g. You can
2480   write the following:
2481   ```rust
2482   type MyOption = Option<u8>;
2483
2484   fn increment_or_zero(x: MyOption) -> u8 {
2485       match x {
2486           MyOption::Some(y) => y + 1,
2487           MyOption::None => 0,
2488       }
2489   }
2490   ```
2491 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2492   `const _: u32 = 5;`.
2493 - [You can now use `#[repr(align(X)]` on enums.][61229]
2494 - [The  `?` Kleene macro operator is now available in the
2495   2015 edition.][60932]
2496
2497 Compiler
2498 --------
2499 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2500   and `-C profile-use` flags.][61268] For more information on how to use profile
2501   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2502 - [The `rust-lldb` wrapper script should now work again.][61827]
2503
2504 Libraries
2505 ---------
2506 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2507
2508 Stabilized APIs
2509 ---------------
2510 - [`BufReader::buffer`]
2511 - [`BufWriter::buffer`]
2512 - [`Cell::from_mut`]
2513 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2514 - [`DoubleEndedIterator::nth_back`]
2515 - [`Option::xor`]
2516 - [`Wrapping::reverse_bits`]
2517 - [`i128::reverse_bits`]
2518 - [`i16::reverse_bits`]
2519 - [`i32::reverse_bits`]
2520 - [`i64::reverse_bits`]
2521 - [`i8::reverse_bits`]
2522 - [`isize::reverse_bits`]
2523 - [`slice::copy_within`]
2524 - [`u128::reverse_bits`]
2525 - [`u16::reverse_bits`]
2526 - [`u32::reverse_bits`]
2527 - [`u64::reverse_bits`]
2528 - [`u8::reverse_bits`]
2529 - [`usize::reverse_bits`]
2530
2531 Cargo
2532 -----
2533 - [`Cargo.lock` files are now included by default when publishing executable crates
2534   with executables.][cargo/7026]
2535 - [You can now specify `default-run="foo"` in `[package]` to specify the
2536   default executable to use for `cargo run`.][cargo/7056]
2537
2538 Misc
2539 ----
2540
2541 Compatibility Notes
2542 -------------------
2543 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2544   Please transition your code to using the `..=` syntax for inclusive
2545   ranges instead.
2546 - [Using a trait object without the `dyn` will now warn by default.][61203]
2547   Please transition your code to use `dyn Trait` for trait objects instead.
2548
2549 [62228]: https://github.com/rust-lang/rust/pull/62228/
2550 [62235]: https://github.com/rust-lang/rust/pull/62235/
2551 [61802]: https://github.com/rust-lang/rust/pull/61802/
2552 [61827]: https://github.com/rust-lang/rust/pull/61827/
2553 [61547]: https://github.com/rust-lang/rust/pull/61547/
2554 [61682]: https://github.com/rust-lang/rust/pull/61682/
2555 [61268]: https://github.com/rust-lang/rust/pull/61268/
2556 [61342]: https://github.com/rust-lang/rust/pull/61342/
2557 [61347]: https://github.com/rust-lang/rust/pull/61347/
2558 [61100]: https://github.com/rust-lang/rust/pull/61100/
2559 [61203]: https://github.com/rust-lang/rust/pull/61203/
2560 [61229]: https://github.com/rust-lang/rust/pull/61229/
2561 [60932]: https://github.com/rust-lang/rust/pull/60932/
2562 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2563 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2564 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2565 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2566 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2567 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2568 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2569 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2570 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2571 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2572 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2573 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2574 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2575 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2576 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2577 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2578 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2579 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2580 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2581 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2582 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2583 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2584 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2585 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2586
2587
2588 Version 1.36.0 (2019-07-04)
2589 ==========================
2590
2591 Language
2592 --------
2593 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2594 - [The order of traits in trait objects no longer affects the semantics of that
2595   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2596   `dyn fmt::Debug + Send`, where this was previously not the case.
2597
2598 Libraries
2599 ---------
2600 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2601 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2602 - [`mem::needs_drop` is now available as a const fn.][60364]
2603 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2604 - [`String` now implements `BorrowMut<str>`.][60404]
2605 - [`io::Cursor` now implements `Default`.][60234]
2606 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2607 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2608   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2609   environment has access to heap memory allocation.
2610 - [`String` now implements `From<&String>`.][59825]
2611 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2612   return a tuple of each argument when there is multiple arguments.
2613 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2614   not used.][59648]
2615
2616 Stabilized APIs
2617 ---------------
2618 - [`VecDeque::rotate_left`]
2619 - [`VecDeque::rotate_right`]
2620 - [`Iterator::copied`]
2621 - [`io::IoSlice`]
2622 - [`io::IoSliceMut`]
2623 - [`Read::read_vectored`]
2624 - [`Write::write_vectored`]
2625 - [`str::as_mut_ptr`]
2626 - [`mem::MaybeUninit`]
2627 - [`pointer::align_offset`]
2628 - [`future::Future`]
2629 - [`task::Context`]
2630 - [`task::RawWaker`]
2631 - [`task::RawWakerVTable`]
2632 - [`task::Waker`]
2633 - [`task::Poll`]
2634
2635 Cargo
2636 -----
2637 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2638 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2639
2640 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2641
2642 Clippy
2643 ------
2644 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2645
2646 Misc
2647 ----
2648
2649 Compatibility Notes
2650 -------------------
2651 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2652   longer recommended, and will be deprecated in 1.39.0.
2653
2654 [60318]: https://github.com/rust-lang/rust/pull/60318/
2655 [60364]: https://github.com/rust-lang/rust/pull/60364/
2656 [60370]: https://github.com/rust-lang/rust/pull/60370/
2657 [60404]: https://github.com/rust-lang/rust/pull/60404/
2658 [60234]: https://github.com/rust-lang/rust/pull/60234/
2659 [60244]: https://github.com/rust-lang/rust/pull/60244/
2660 [58623]: https://github.com/rust-lang/rust/pull/58623/
2661 [59648]: https://github.com/rust-lang/rust/pull/59648/
2662 [59675]: https://github.com/rust-lang/rust/pull/59675/
2663 [59825]: https://github.com/rust-lang/rust/pull/59825/
2664 [59826]: https://github.com/rust-lang/rust/pull/59826/
2665 [59445]: https://github.com/rust-lang/rust/pull/59445/
2666 [59114]: https://github.com/rust-lang/rust/pull/59114/
2667 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2668 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2669 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2670 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2671 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2672 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2673 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2674 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2675 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2676 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2677 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2678 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2679 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2680 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2681 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2682 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2683 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2684 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2685 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2686 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2687
2688
2689 Version 1.35.0 (2019-05-23)
2690 ==========================
2691
2692 Language
2693 --------
2694 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2695   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2696 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2697   ```rust
2698   unsafe fn call_unsafe(func: unsafe fn()) {
2699       func()
2700   }
2701
2702   pub fn main() {
2703       unsafe { call_unsafe(|| {}); }
2704   }
2705   ```
2706
2707
2708 Compiler
2709 --------
2710 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2711   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2712 - [Added the `wasm32-unknown-wasi` target.][59464]
2713
2714
2715 Libraries
2716 ---------
2717 - [`Thread` will now show its ID in `Debug` output.][59460]
2718 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2719 - [`alloc::System` now implements `Default`.][59451]
2720 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2721   last field.][59076]
2722 - [`char::{ToLowercase, ToUppercase}` now
2723   implement `ExactSizeIterator`.][58778]
2724 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2725 - [Removed the `Read` trait bounds
2726   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2727 - [You can now call the `dbg!` macro without any parameters to print the file
2728   and line where it is called.][57847]
2729 - [In place ASCII case conversions are now up to 4× faster.][59283]
2730   e.g. `str::make_ascii_lowercase`
2731 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2732   and `Send`.][58369]
2733
2734 Stabilized APIs
2735 ---------------
2736 - [`f32::copysign`]
2737 - [`f64::copysign`]
2738 - [`RefCell::replace_with`]
2739 - [`RefCell::map_split`]
2740 - [`ptr::hash`]
2741 - [`Range::contains`]
2742 - [`RangeFrom::contains`]
2743 - [`RangeTo::contains`]
2744 - [`RangeInclusive::contains`]
2745 - [`RangeToInclusive::contains`]
2746 - [`Option::copied`]
2747
2748 Cargo
2749 -----
2750 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2751   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2752   platform specific.
2753
2754 Misc
2755 ----
2756 - [The Rust toolchain is now available natively for musl based distros.][58575]
2757
2758 [59460]: https://github.com/rust-lang/rust/pull/59460/
2759 [59464]: https://github.com/rust-lang/rust/pull/59464/
2760 [59500]: https://github.com/rust-lang/rust/pull/59500/
2761 [59512]: https://github.com/rust-lang/rust/pull/59512/
2762 [59580]: https://github.com/rust-lang/rust/pull/59580/
2763 [59283]: https://github.com/rust-lang/rust/pull/59283/
2764 [59451]: https://github.com/rust-lang/rust/pull/59451/
2765 [59076]: https://github.com/rust-lang/rust/pull/59076/
2766 [58778]: https://github.com/rust-lang/rust/pull/58778/
2767 [58717]: https://github.com/rust-lang/rust/pull/58717/
2768 [58369]: https://github.com/rust-lang/rust/pull/58369/
2769 [58423]: https://github.com/rust-lang/rust/pull/58423/
2770 [58080]: https://github.com/rust-lang/rust/pull/58080/
2771 [57847]: https://github.com/rust-lang/rust/pull/57847/
2772 [58575]: https://github.com/rust-lang/rust/pull/58575
2773 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2774 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2775 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2776 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2777 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2778 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2779 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2780 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2781 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2782 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2783 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2784 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2785
2786 Version 1.34.2 (2019-05-14)
2787 ===========================
2788
2789 * [Destabilize the `Error::type_id` function due to a security
2790    vulnerability][60785] ([CVE-2019-12083])
2791
2792 [60785]: https://github.com/rust-lang/rust/pull/60785
2793 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2794
2795 Version 1.34.1 (2019-04-25)
2796 ===========================
2797
2798 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2799 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2800 * [Fix Clippy panic when checking some macros][clippy/3805]
2801
2802 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2803 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2804 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2805
2806 Version 1.34.0 (2019-04-11)
2807 ==========================
2808
2809 Language
2810 --------
2811 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2812   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2813   but had no effect.
2814 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2815   `#[attr{}]` procedural macros.][57367]
2816 - [You can now write `extern crate self as foo;`][57407] to import your
2817   crate's root into the extern prelude.
2818
2819
2820 Compiler
2821 --------
2822 - [You can now target `riscv64imac-unknown-none-elf` and
2823   `riscv64gc-unknown-none-elf`.][58406]
2824 - [You can now enable linker plugin LTO optimisations with
2825   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2826   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2827   boundaries.
2828 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2829
2830
2831 Libraries
2832 ---------
2833 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2834   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2835   the `Hash` trait to create an iterator.
2836 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2837   methods.][58421] Most notably you no longer require the `Ord` trait to create
2838   an iterator.
2839 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2840   for all numeric types.][58044]
2841 - [Indexing a `str` is now generic over all types that
2842   implement `SliceIndex<str>`.][57604]
2843 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2844   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2845   produce a warning if their returning type is unused.
2846 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2847   `overflowing_pow` are now available for all numeric types.][57873] These are
2848   equivalent to methods such as `wrapping_add` for the `pow` operation.
2849
2850
2851 Stabilized APIs
2852 ---------------
2853
2854 #### std & core
2855 * [`Any::type_id`]
2856 * [`Error::type_id`]
2857 * [`atomic::AtomicI16`]
2858 * [`atomic::AtomicI32`]
2859 * [`atomic::AtomicI64`]
2860 * [`atomic::AtomicI8`]
2861 * [`atomic::AtomicU16`]
2862 * [`atomic::AtomicU32`]
2863 * [`atomic::AtomicU64`]
2864 * [`atomic::AtomicU8`]
2865 * [`convert::Infallible`]
2866 * [`convert::TryFrom`]
2867 * [`convert::TryInto`]
2868 * [`iter::from_fn`]
2869 * [`iter::successors`]
2870 * [`num::NonZeroI128`]
2871 * [`num::NonZeroI16`]
2872 * [`num::NonZeroI32`]
2873 * [`num::NonZeroI64`]
2874 * [`num::NonZeroI8`]
2875 * [`num::NonZeroIsize`]
2876 * [`slice::sort_by_cached_key`]
2877 * [`str::escape_debug`]
2878 * [`str::escape_default`]
2879 * [`str::escape_unicode`]
2880 * [`str::split_ascii_whitespace`]
2881
2882 #### std
2883 * [`Instant::checked_add`]
2884 * [`Instant::checked_sub`]
2885 * [`SystemTime::checked_add`]
2886 * [`SystemTime::checked_sub`]
2887
2888 Cargo
2889 -----
2890 - [You can now use alternative registries to crates.io.][cargo/6654]
2891
2892 Misc
2893 ----
2894 - [You can now use the `?` operator in your documentation tests without manually
2895   adding `fn main() -> Result<(), _> {}`.][56470]
2896
2897 Compatibility Notes
2898 -------------------
2899 - [`Command::before_exec` is being replaced by the unsafe method
2900   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2901 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2902   can now use `const` functions in `static` variables.
2903
2904 [58370]: https://github.com/rust-lang/rust/pull/58370/
2905 [58406]: https://github.com/rust-lang/rust/pull/58406/
2906 [58421]: https://github.com/rust-lang/rust/pull/58421/
2907 [58166]: https://github.com/rust-lang/rust/pull/58166/
2908 [58044]: https://github.com/rust-lang/rust/pull/58044/
2909 [58057]: https://github.com/rust-lang/rust/pull/58057/
2910 [58059]: https://github.com/rust-lang/rust/pull/58059/
2911 [57809]: https://github.com/rust-lang/rust/pull/57809/
2912 [57873]: https://github.com/rust-lang/rust/pull/57873/
2913 [57604]: https://github.com/rust-lang/rust/pull/57604/
2914 [57367]: https://github.com/rust-lang/rust/pull/57367/
2915 [57407]: https://github.com/rust-lang/rust/pull/57407/
2916 [57425]: https://github.com/rust-lang/rust/pull/57425/
2917 [57106]: https://github.com/rust-lang/rust/pull/57106/
2918 [56470]: https://github.com/rust-lang/rust/pull/56470/
2919 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2920 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2921 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2922 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2923 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2924 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2925 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2926 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2927 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2928 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2929 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2930 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2931 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2932 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2933 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2934 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2935 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2936 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2937 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2938 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2939 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2940 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2941 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2942 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2943 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2944 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2945 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2946 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2947 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2948 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2949 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2950
2951
2952 Version 1.33.0 (2019-02-28)
2953 ==========================
2954
2955 Language
2956 --------
2957 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2958   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2959 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2960   E.g. You can have match statement on a `u8` that covers `0..=255` and
2961   you would no longer be required to have a `_ => unreachable!()` case.
2962 - [You can now have multiple patterns in `if let` and `while let`
2963   expressions.][57532] You can do this with the same syntax as a `match`
2964   expression. E.g.
2965   ```rust
2966   enum Creature {
2967       Crab(String),
2968       Lobster(String),
2969       Person(String),
2970   }
2971
2972   fn main() {
2973       let state = Creature::Crab("Ferris");
2974
2975       if let Creature::Crab(name) | Creature::Person(name) = state {
2976           println!("This creature's name is: {}", name);
2977       }
2978   }
2979   ```
2980 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2981   this feature will by default produce a warning as this behaviour can be
2982   unintuitive. E.g. `if let _ = 5 {}`
2983 - [You can now use `let` bindings, assignments, expression statements,
2984   and irrefutable pattern destructuring in const functions.][57175]
2985 - [You can now call unsafe const functions.][57067] E.g.
2986   ```rust
2987   const unsafe fn foo() -> i32 { 5 }
2988   const fn bar() -> i32 {
2989       unsafe { foo() }
2990   }
2991   ```
2992 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2993   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2994 - [You can now specify a specific alignment with the `#[repr(packed)]`
2995   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2996   with an alignment of 2 bytes and a size of 6 bytes.
2997 - [You can now import an item from a module as an `_`.][56303] This allows you to
2998   import a trait's impls, and not have the name in the namespace. E.g.
2999   ```rust
3000   use std::io::Read as _;
3001
3002   // Allowed as there is only one `Read` in the module.
3003   pub trait Read {}
3004   ```
3005 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
3006
3007 Compiler
3008 --------
3009 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
3010   command line argument.][56351]
3011 - [The minimum required LLVM version has been bumped to 6.0.][56642]
3012 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
3013 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
3014   tier 2 support.][57130] Visit the [platform support][platform-support] page for
3015   information on Rust's platform support.
3016 - [Added support for the `thumbv7neon-linux-androideabi` and
3017   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
3018 - [Added support for the `x86_64-unknown-uefi` target.][56769]
3019
3020 Libraries
3021 ---------
3022 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
3023   functions for all numeric types.][57566]
3024 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
3025   are now `const` functions for all numeric types.][57105]
3026 - [The methods `is_positive` and `is_negative` are now `const` functions for
3027   all signed numeric types.][57105]
3028 - [The `get` method for all `NonZero` types is now `const`.][57167]
3029 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
3030   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
3031   numeric types.][57234]
3032 - [`Ipv4Addr::new` is now a `const` function][57234]
3033
3034 Stabilized APIs
3035 ---------------
3036 - [`unix::FileExt::read_exact_at`]
3037 - [`unix::FileExt::write_all_at`]
3038 - [`Option::transpose`]
3039 - [`Result::transpose`]
3040 - [`convert::identity`]
3041 - [`pin::Pin`]
3042 - [`marker::Unpin`]
3043 - [`marker::PhantomPinned`]
3044 - [`Vec::resize_with`]
3045 - [`VecDeque::resize_with`]
3046 - [`Duration::as_millis`]
3047 - [`Duration::as_micros`]
3048 - [`Duration::as_nanos`]
3049
3050
3051 Cargo
3052 -----
3053 - [You can now publish crates that require a feature flag to compile with
3054   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
3055 - [Cargo should now rebuild a crate if a file was modified during the initial
3056   build.][cargo/6484]
3057
3058 Compatibility Notes
3059 -------------------
3060 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
3061   are now deprecated in the standard library, and their usage will now produce a warning.
3062   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
3063   methods instead.
3064 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
3065   downcasting.
3066 - [Libtest no longer creates a new thread for each test when
3067   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
3068
3069 [55982]: https://github.com/rust-lang/rust/pull/55982/
3070 [56243]: https://github.com/rust-lang/rust/pull/56243
3071 [56303]: https://github.com/rust-lang/rust/pull/56303/
3072 [56351]: https://github.com/rust-lang/rust/pull/56351/
3073 [56362]: https://github.com/rust-lang/rust/pull/56362
3074 [56642]: https://github.com/rust-lang/rust/pull/56642/
3075 [56769]: https://github.com/rust-lang/rust/pull/56769/
3076 [56805]: https://github.com/rust-lang/rust/pull/56805
3077 [56947]: https://github.com/rust-lang/rust/pull/56947/
3078 [57049]: https://github.com/rust-lang/rust/pull/57049/
3079 [57067]: https://github.com/rust-lang/rust/pull/57067/
3080 [57105]: https://github.com/rust-lang/rust/pull/57105
3081 [57130]: https://github.com/rust-lang/rust/pull/57130/
3082 [57167]: https://github.com/rust-lang/rust/pull/57167/
3083 [57175]: https://github.com/rust-lang/rust/pull/57175/
3084 [57234]: https://github.com/rust-lang/rust/pull/57234/
3085 [57332]: https://github.com/rust-lang/rust/pull/57332/
3086 [57465]: https://github.com/rust-lang/rust/pull/57465/
3087 [57532]: https://github.com/rust-lang/rust/pull/57532/
3088 [57535]: https://github.com/rust-lang/rust/pull/57535/
3089 [57566]: https://github.com/rust-lang/rust/pull/57566/
3090 [57615]: https://github.com/rust-lang/rust/pull/57615/
3091 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
3092 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
3093 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
3094 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
3095 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
3096 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
3097 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
3098 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
3099 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
3100 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
3101 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
3102 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
3103 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
3104 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
3105 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
3106 [platform-support]: https://forge.rust-lang.org/platform-support.html
3107
3108 Version 1.32.0 (2019-01-17)
3109 ==========================
3110
3111 Language
3112 --------
3113 #### 2018 edition
3114 - [You can now use the `?` operator in macro definitions.][56245] The `?`
3115   operator allows you to specify zero or one repetitions similar to the `*` and
3116   `+` operators.
3117 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
3118   now always resolve to the item (`enum`, `struct`, etc.) available in the
3119   module if present, before resolving to a external crate or an item the prelude.][56759]
3120   E.g.
3121   ```rust
3122   enum Color { Red, Green, Blue }
3123
3124   use Color::*;
3125   ```
3126
3127 #### All editions
3128 - [You can now match against `PhantomData<T>` types.][55837]
3129 - [You can now match against literals in macros with the `literal`
3130   specifier.][56072] This will match against a literal of any type.
3131   E.g. `1`, `'A'`, `"Hello World"`
3132 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3133   ```rust
3134   struct Point(i32, i32);
3135
3136   impl Point {
3137       pub fn new(x: i32, y: i32) -> Self {
3138           Self(x, y)
3139       }
3140
3141       pub fn is_origin(&self) -> bool {
3142           match self {
3143               Self(0, 0) => true,
3144               _ => false,
3145           }
3146       }
3147   }
3148   ```
3149 - [Self can also now be used in type definitions.][56366] E.g.
3150   ```rust
3151   enum List<T>
3152   where
3153       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3154   {
3155       Nil,
3156       Cons(T, Box<Self>) // likewise here
3157   }
3158   ```
3159 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3160   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3161
3162 Compiler
3163 --------
3164 - [The default allocator has changed from jemalloc to the default allocator on
3165   your system.][55238] The compiler itself on Linux & macOS will still use
3166   jemalloc, but programs compiled with it will use the system allocator.
3167 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3168
3169 Libraries
3170 ---------
3171 - [`PathBuf` now implements `FromStr`.][55148]
3172 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3173 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3174   easily debug expressions in your rust program. E.g.
3175   ```rust
3176   let a = 2;
3177   let b = dbg!(a * 2) + 1;
3178   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3179   assert_eq!(b, 5);
3180   ```
3181
3182 The following APIs are now `const` functions and can be used in a
3183 `const` context.
3184
3185 - [`Cell::as_ptr`]
3186 - [`UnsafeCell::get`]
3187 - [`char::is_ascii`]
3188 - [`iter::empty`]
3189 - [`ManuallyDrop::new`]
3190 - [`ManuallyDrop::into_inner`]
3191 - [`RangeInclusive::start`]
3192 - [`RangeInclusive::end`]
3193 - [`NonNull::as_ptr`]
3194 - [`slice::as_ptr`]
3195 - [`str::as_ptr`]
3196 - [`Duration::as_secs`]
3197 - [`Duration::subsec_millis`]
3198 - [`Duration::subsec_micros`]
3199 - [`Duration::subsec_nanos`]
3200 - [`CStr::as_ptr`]
3201 - [`Ipv4Addr::is_unspecified`]
3202 - [`Ipv6Addr::new`]
3203 - [`Ipv6Addr::octets`]
3204
3205 Stabilized APIs
3206 ---------------
3207 - [`i8::to_be_bytes`]
3208 - [`i8::to_le_bytes`]
3209 - [`i8::to_ne_bytes`]
3210 - [`i8::from_be_bytes`]
3211 - [`i8::from_le_bytes`]
3212 - [`i8::from_ne_bytes`]
3213 - [`i16::to_be_bytes`]
3214 - [`i16::to_le_bytes`]
3215 - [`i16::to_ne_bytes`]
3216 - [`i16::from_be_bytes`]
3217 - [`i16::from_le_bytes`]
3218 - [`i16::from_ne_bytes`]
3219 - [`i32::to_be_bytes`]
3220 - [`i32::to_le_bytes`]
3221 - [`i32::to_ne_bytes`]
3222 - [`i32::from_be_bytes`]
3223 - [`i32::from_le_bytes`]
3224 - [`i32::from_ne_bytes`]
3225 - [`i64::to_be_bytes`]
3226 - [`i64::to_le_bytes`]
3227 - [`i64::to_ne_bytes`]
3228 - [`i64::from_be_bytes`]
3229 - [`i64::from_le_bytes`]
3230 - [`i64::from_ne_bytes`]
3231 - [`i128::to_be_bytes`]
3232 - [`i128::to_le_bytes`]
3233 - [`i128::to_ne_bytes`]
3234 - [`i128::from_be_bytes`]
3235 - [`i128::from_le_bytes`]
3236 - [`i128::from_ne_bytes`]
3237 - [`isize::to_be_bytes`]
3238 - [`isize::to_le_bytes`]
3239 - [`isize::to_ne_bytes`]
3240 - [`isize::from_be_bytes`]
3241 - [`isize::from_le_bytes`]
3242 - [`isize::from_ne_bytes`]
3243 - [`u8::to_be_bytes`]
3244 - [`u8::to_le_bytes`]
3245 - [`u8::to_ne_bytes`]
3246 - [`u8::from_be_bytes`]
3247 - [`u8::from_le_bytes`]
3248 - [`u8::from_ne_bytes`]
3249 - [`u16::to_be_bytes`]
3250 - [`u16::to_le_bytes`]
3251 - [`u16::to_ne_bytes`]
3252 - [`u16::from_be_bytes`]
3253 - [`u16::from_le_bytes`]
3254 - [`u16::from_ne_bytes`]
3255 - [`u32::to_be_bytes`]
3256 - [`u32::to_le_bytes`]
3257 - [`u32::to_ne_bytes`]
3258 - [`u32::from_be_bytes`]
3259 - [`u32::from_le_bytes`]
3260 - [`u32::from_ne_bytes`]
3261 - [`u64::to_be_bytes`]
3262 - [`u64::to_le_bytes`]
3263 - [`u64::to_ne_bytes`]
3264 - [`u64::from_be_bytes`]
3265 - [`u64::from_le_bytes`]
3266 - [`u64::from_ne_bytes`]
3267 - [`u128::to_be_bytes`]
3268 - [`u128::to_le_bytes`]
3269 - [`u128::to_ne_bytes`]
3270 - [`u128::from_be_bytes`]
3271 - [`u128::from_le_bytes`]
3272 - [`u128::from_ne_bytes`]
3273 - [`usize::to_be_bytes`]
3274 - [`usize::to_le_bytes`]
3275 - [`usize::to_ne_bytes`]
3276 - [`usize::from_be_bytes`]
3277 - [`usize::from_le_bytes`]
3278 - [`usize::from_ne_bytes`]
3279
3280 Cargo
3281 -----
3282 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3283 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3284
3285 Misc
3286 ----
3287 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3288
3289 Compatibility Notes
3290 -------------------
3291 - [The argument types for AVX's
3292   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3293   been changed from `*const` to `*mut` as the previous implementation
3294   was unsound.
3295
3296
3297 [55148]: https://github.com/rust-lang/rust/pull/55148/
3298 [55238]: https://github.com/rust-lang/rust/pull/55238/
3299 [55280]: https://github.com/rust-lang/rust/pull/55280/
3300 [55610]: https://github.com/rust-lang/rust/pull/55610/
3301 [55663]: https://github.com/rust-lang/rust/pull/55663/
3302 [55702]: https://github.com/rust-lang/rust/pull/55702/
3303 [55837]: https://github.com/rust-lang/rust/pull/55837/
3304 [55843]: https://github.com/rust-lang/rust/pull/55843/
3305 [56072]: https://github.com/rust-lang/rust/pull/56072/
3306 [56245]: https://github.com/rust-lang/rust/pull/56245/
3307 [56365]: https://github.com/rust-lang/rust/pull/56365/
3308 [56366]: https://github.com/rust-lang/rust/pull/56366/
3309 [56395]: https://github.com/rust-lang/rust/pull/56395/
3310 [56759]: https://github.com/rust-lang/rust/pull/56759/
3311 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3312 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3313 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3314 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3315 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3316 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3317 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3318 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3319 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3320 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3321 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3322 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3323 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3324 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3325 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3326 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3327 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3328 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3329 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3330 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3331 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3332 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3333 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3334 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3335 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3336 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3337 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3338 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3339 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3340 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3341 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3342 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3343 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3344 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3345 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3346 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3347 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3348 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3349 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3350 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3351 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3352 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3353 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3354 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3355 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3356 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3357 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3358 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3359 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3360 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3361 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3362 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3363 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3364 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3365 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3366 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3367 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3368 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3369 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3370 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3371 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3372 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3373 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3374 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3375 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3376 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3377 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3378 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3379 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3380 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3381 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3382 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3383 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3384 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3385 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3386 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3387 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3388 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3389 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3390 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3391 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3392 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3393 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3394 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3395 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3396 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3397 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3398 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3399 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3400 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3401 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3402 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3403 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3404
3405
3406 Version 1.31.1 (2018-12-20)
3407 ===========================
3408
3409 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3410 - [Fix broken go-to-definition in RLS][rls/1171]
3411 - [Fix infinite loop on hover in RLS][rls/1170]
3412
3413 [56562]: https://github.com/rust-lang/rust/pull/56562
3414 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3415 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3416
3417 Version 1.31.0 (2018-12-06)
3418 ==========================
3419
3420 Language
3421 --------
3422 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3423 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3424   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3425   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3426   in structs.
3427 - [You can now define and use `const` functions.][54835] These are currently
3428   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3429   [language reference][const-reference] for what exactly is available.
3430 - [You can now use tool lints, which allow you to scope lints from external
3431   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3432 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3433   a crate, not just in exported functions.][54451]
3434 - [You can now use parentheses in pattern matches.][54497]
3435
3436 Compiler
3437 --------
3438 - [Updated musl to 1.1.20][54430]
3439
3440 Libraries
3441 ---------
3442 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3443   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3444 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3445   into `Option<&mut T>` using the `From` trait.][53218]
3446 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3447
3448
3449 Stabilized APIs
3450 ---------------
3451 - [`slice::align_to`]
3452 - [`slice::align_to_mut`]
3453 - [`slice::chunks_exact`]
3454 - [`slice::chunks_exact_mut`]
3455 - [`slice::rchunks`]
3456 - [`slice::rchunks_mut`]
3457 - [`slice::rchunks_exact`]
3458 - [`slice::rchunks_exact_mut`]
3459 - [`Option::replace`]
3460
3461 Cargo
3462 -----
3463 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3464 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3465   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3466
3467 [52813]: https://github.com/rust-lang/rust/pull/52813/
3468 [53218]: https://github.com/rust-lang/rust/pull/53218/
3469 [53555]: https://github.com/rust-lang/rust/issues/53555/
3470 [54057]: https://github.com/rust-lang/rust/pull/54057/
3471 [54240]: https://github.com/rust-lang/rust/pull/54240/
3472 [54430]: https://github.com/rust-lang/rust/pull/54430/
3473 [54451]: https://github.com/rust-lang/rust/pull/54451/
3474 [54497]: https://github.com/rust-lang/rust/pull/54497/
3475 [54778]: https://github.com/rust-lang/rust/pull/54778/
3476 [54835]: https://github.com/rust-lang/rust/pull/54835/
3477 [54870]: https://github.com/rust-lang/rust/pull/54870/
3478 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3479 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3480 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3481 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3482 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3483 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3484 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3485 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3486 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3487 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3488 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3489 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3490 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3491 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3492
3493 Version 1.30.1 (2018-11-08)
3494 ===========================
3495
3496 - [Fixed overflow ICE in rustdoc][54199]
3497 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3498
3499 [54199]: https://github.com/rust-lang/rust/pull/54199
3500 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3501
3502 Version 1.30.0 (2018-10-25)
3503 ==========================
3504
3505 Language
3506 --------
3507 - [Procedural macros are now available.][52081] These kinds of macros allow for
3508   more powerful code generation. There is a [new chapter available][proc-macros]
3509   in the Rust Programming Language book that goes further in depth.
3510 - [You can now use keywords as identifiers using the raw identifiers
3511   syntax (`r#`),][53236] e.g. `let r#for = true;`
3512 - [Using anonymous parameters in traits is now deprecated with a warning and
3513   will be a hard error in the 2018 edition.][53272]
3514 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3515   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3516 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3517   Previously, using a external crate in a module without a use statement
3518   required `let json = ::serde_json::from_str(foo);` but can now be written
3519   as `let json = serde_json::from_str(foo);`.
3520 - [You can now apply the `#[used]` attribute to static items to prevent the
3521   compiler from optimising them away, even if they appear to be unused,][51363]
3522   e.g. `#[used] static FOO: u32 = 1;`
3523 - [You can now import and reexport macros from other crates with the `use`
3524   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3525   the root module of the crate. If your macro relies on calling other local
3526   macros, it is recommended to export with the
3527   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3528   those macros.
3529 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3530   using the `vis` specifier.][53370]
3531 - [Non-macro attributes now allow all forms of literals, not just
3532   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3533   write `#[attr(true)]`.
3534 - [You can now specify a function to handle a panic in the Rust runtime with the
3535   `#[panic_handler]` attribute.][51366]
3536
3537 Compiler
3538 --------
3539 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3540 - [Added the `aarch64-unknown-netbsd` target][53165]
3541 - [Upgraded to LLVM 8.][53611]
3542
3543 Libraries
3544 ---------
3545 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3546
3547 Stabilized APIs
3548 ---------------
3549 - [`Ipv4Addr::BROADCAST`]
3550 - [`Ipv4Addr::LOCALHOST`]
3551 - [`Ipv4Addr::UNSPECIFIED`]
3552 - [`Ipv6Addr::LOCALHOST`]
3553 - [`Ipv6Addr::UNSPECIFIED`]
3554 - [`Iterator::find_map`]
3555
3556   The following methods are replacement methods for `trim_left`, `trim_right`,
3557   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3558   in 1.33.0:
3559 - [`str::trim_end_matches`]
3560 - [`str::trim_end`]
3561 - [`str::trim_start_matches`]
3562 - [`str::trim_start`]
3563
3564 Cargo
3565 ----
3566 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3567 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3568   equivalent to calling `rustdoc --error-format=json`.
3569 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3570
3571 Misc
3572 ----
3573 - [`rustdoc` allows you to specify what edition to treat your code as with the
3574   `--edition` option.][54057]
3575 - [`rustdoc` now has the `--color` (specify whether to output color) and
3576   `--error-format` (specify error format, e.g. `json`) options.][53003]
3577 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3578   debug symbols.][53774]
3579 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3580   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3581
3582 [50911]: https://github.com/rust-lang/rust/pull/50911/
3583 [51363]: https://github.com/rust-lang/rust/pull/51363/
3584 [51366]: https://github.com/rust-lang/rust/pull/51366/
3585 [52081]: https://github.com/rust-lang/rust/pull/52081/
3586 [53003]: https://github.com/rust-lang/rust/pull/53003/
3587 [53033]: https://github.com/rust-lang/rust/pull/53033/
3588 [53044]: https://github.com/rust-lang/rust/pull/53044/
3589 [53165]: https://github.com/rust-lang/rust/pull/53165/
3590 [53611]: https://github.com/rust-lang/rust/pull/53611/
3591 [53213]: https://github.com/rust-lang/rust/pull/53213/
3592 [53236]: https://github.com/rust-lang/rust/pull/53236/
3593 [53272]: https://github.com/rust-lang/rust/pull/53272/
3594 [53370]: https://github.com/rust-lang/rust/pull/53370/
3595 [53459]: https://github.com/rust-lang/rust/pull/53459/
3596 [53774]: https://github.com/rust-lang/rust/pull/53774/
3597 [53822]: https://github.com/rust-lang/rust/pull/53822/
3598 [54057]: https://github.com/rust-lang/rust/pull/54057/
3599 [54146]: https://github.com/rust-lang/rust/pull/54146/
3600 [54404]: https://github.com/rust-lang/rust/pull/54404/
3601 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3602 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3603 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3604 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3605
3606 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3607 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3608 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3609 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3610 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3611 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3612 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3613 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3614 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3615 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3616
3617
3618 Version 1.29.2 (2018-10-11)
3619 ===========================
3620
3621 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3622 - The `rls-preview` component on the windows-gnu targets has been restored.
3623
3624 [54639]: https://github.com/rust-lang/rust/pull/54639
3625
3626
3627 Version 1.29.1 (2018-09-25)
3628 ===========================
3629
3630 Security Notes
3631 --------------
3632
3633 - The standard library's `str::repeat` function contained an out of bounds write
3634   caused by an integer overflow. This has been fixed by deterministically
3635   panicking when an overflow happens.
3636
3637   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3638   us.
3639
3640
3641 Version 1.29.0 (2018-09-13)
3642 ==========================
3643
3644 Compiler
3645 --------
3646 - [Bumped minimum LLVM version to 5.0.][51899]
3647 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3648 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3649 - [Upgraded to LLVM 7.][51966]
3650
3651 Libraries
3652 ---------
3653 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3654 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3655 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3656 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3657   for `&str`.][51178]
3658 - [`Cell<T>` now allows `T` to be unsized.][50494]
3659 - [`SocketAddr` is now stable on Redox.][52656]
3660
3661 Stabilized APIs
3662 ---------------
3663 - [`Arc::downcast`]
3664 - [`Iterator::flatten`]
3665 - [`Rc::downcast`]
3666
3667 Cargo
3668 -----
3669 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3670   `--locked` to disable this behavior.
3671 - [`cargo-install` will now allow you to cross compile an install
3672   using `--target`.][cargo/5614]
3673 - [Added the `cargo-fix` subcommand to automatically move project code from
3674   2015 edition to 2018.][cargo/5723]
3675 - [`cargo doc` can now optionally document private types using the
3676   `--document-private-items` flag.][cargo/5543]
3677
3678 Misc
3679 ----
3680 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3681   the specified level to that level.][52354] For example `--cap-lints warn`
3682   will demote `deny` and `forbid` lints to `warn`.
3683 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3684   fails and `101` if there is a panic.][52197]
3685 - [A preview of clippy has been made available through rustup.][51122]
3686   You can install the preview with `rustup component add clippy-preview`.
3687
3688 Compatibility Notes
3689 -------------------
3690 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3691   Use `str::get_unchecked(begin..end)` instead.
3692 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3693   Consider using the `home_dir` function from
3694   https://crates.io/crates/dirs instead.
3695 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3696 - [`cfg` attributes and `--cfg` command line flags are now more
3697   strictly validated.][53893]
3698
3699 [53893]: https://github.com/rust-lang/rust/pull/53893/
3700 [52861]: https://github.com/rust-lang/rust/pull/52861/
3701 [51966]: https://github.com/rust-lang/rust/pull/51966/
3702 [52656]: https://github.com/rust-lang/rust/pull/52656/
3703 [52239]: https://github.com/rust-lang/rust/pull/52239/
3704 [52330]: https://github.com/rust-lang/rust/pull/52330/
3705 [52354]: https://github.com/rust-lang/rust/pull/52354/
3706 [52402]: https://github.com/rust-lang/rust/pull/52402/
3707 [52103]: https://github.com/rust-lang/rust/pull/52103/
3708 [52197]: https://github.com/rust-lang/rust/pull/52197/
3709 [51807]: https://github.com/rust-lang/rust/pull/51807/
3710 [51899]: https://github.com/rust-lang/rust/pull/51899/
3711 [51912]: https://github.com/rust-lang/rust/pull/51912/
3712 [51511]: https://github.com/rust-lang/rust/pull/51511/
3713 [51619]: https://github.com/rust-lang/rust/pull/51619/
3714 [51656]: https://github.com/rust-lang/rust/pull/51656/
3715 [51178]: https://github.com/rust-lang/rust/pull/51178/
3716 [51122]: https://github.com/rust-lang/rust/pull/51122
3717 [50494]: https://github.com/rust-lang/rust/pull/50494/
3718 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3719 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3720 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3721 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3722 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3723 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3724 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3725
3726
3727 Version 1.28.0 (2018-08-02)
3728 ===========================
3729
3730 Language
3731 --------
3732 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3733   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3734   the inner type across Foreign Function Interface (FFI) boundaries.
3735 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3736   and can now be used as identifiers.][51196]
3737 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3738   stable.][51241] This will allow users to specify a global allocator for
3739   their program.
3740 - [Unit test functions marked with the `#[test]` attribute can now return
3741   `Result<(), E: Debug>` in addition to `()`.][51298]
3742 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3743   allows macros to easily target lifetimes.
3744
3745 Compiler
3746 --------
3747 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3748   prioritise making smaller binary sizes. `z` is the same as `s` with the
3749   exception that it does not vectorise loops, which typically results in an even
3750   smaller binary.
3751 - [The short error format is now stable.][49546] Specified with
3752   `--error-format=short` this option will provide a more compressed output of
3753   rust error messages.
3754 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3755 - [Reduced the number of allocations in the macro parser.][50855] This can
3756   improve compile times of macro heavy crates on average by 5%.
3757
3758 Libraries
3759 ---------
3760 - [Implemented `Default` for `&mut str`.][51306]
3761 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3762 - [Implemented `Extend` for `()`.][50234]
3763 - [The `Debug` implementation of `time::Duration` should now be more easily
3764   human readable.][50364] Previously a `Duration` of one second would printed as
3765   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3766 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3767   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3768   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3769   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3770   for `PathBuf`.][50170]
3771 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3772   and `Wrapping<i128>`.][50465]
3773 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3774   possible.][51050] This can provide up to a 40% speed increase.
3775 - [Improved error messages when using `format!`.][50610]
3776
3777 Stabilized APIs
3778 ---------------
3779 - [`Iterator::step_by`]
3780 - [`Path::ancestors`]
3781 - [`SystemTime::UNIX_EPOCH`]
3782 - [`alloc::GlobalAlloc`]
3783 - [`alloc::Layout`]
3784 - [`alloc::LayoutErr`]
3785 - [`alloc::System`]
3786 - [`alloc::alloc`]
3787 - [`alloc::alloc_zeroed`]
3788 - [`alloc::dealloc`]
3789 - [`alloc::realloc`]
3790 - [`alloc::handle_alloc_error`]
3791 - [`btree_map::Entry::or_default`]
3792 - [`fmt::Alignment`]
3793 - [`hash_map::Entry::or_default`]
3794 - [`iter::repeat_with`]
3795 - [`num::NonZeroUsize`]
3796 - [`num::NonZeroU128`]
3797 - [`num::NonZeroU16`]
3798 - [`num::NonZeroU32`]
3799 - [`num::NonZeroU64`]
3800 - [`num::NonZeroU8`]
3801 - [`ops::RangeBounds`]
3802 - [`slice::SliceIndex`]
3803 - [`slice::from_mut`]
3804 - [`slice::from_ref`]
3805 - [`{Any + Send + Sync}::downcast_mut`]
3806 - [`{Any + Send + Sync}::downcast_ref`]
3807 - [`{Any + Send + Sync}::is`]
3808
3809 Cargo
3810 -----
3811 - [Cargo will now no longer allow you to publish crates with build scripts that
3812   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3813   considered to be immutable.
3814
3815 Misc
3816 ----
3817 - [The `suggestion_applicability` field in `rustc`'s json output is now
3818   stable.][50486] This will allow dev tools to check whether a code suggestion
3819   would apply to them.
3820
3821 Compatibility Notes
3822 -------------------
3823 - [Rust will consider trait objects with duplicated constraints to be the same
3824   type as without the duplicated constraint.][51276] For example the below code will
3825   now fail to compile.
3826   ```rust
3827   trait Trait {}
3828
3829   impl Trait + Send {
3830       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3831   }
3832
3833   impl Trait + Send + Send {
3834       fn test(&self) { println!("two"); }
3835   }
3836   ```
3837
3838 [49546]: https://github.com/rust-lang/rust/pull/49546/
3839 [50143]: https://github.com/rust-lang/rust/pull/50143/
3840 [50170]: https://github.com/rust-lang/rust/pull/50170/
3841 [50234]: https://github.com/rust-lang/rust/pull/50234/
3842 [50265]: https://github.com/rust-lang/rust/pull/50265/
3843 [50364]: https://github.com/rust-lang/rust/pull/50364/
3844 [50385]: https://github.com/rust-lang/rust/pull/50385/
3845 [50465]: https://github.com/rust-lang/rust/pull/50465/
3846 [50486]: https://github.com/rust-lang/rust/pull/50486/
3847 [50554]: https://github.com/rust-lang/rust/pull/50554/
3848 [50610]: https://github.com/rust-lang/rust/pull/50610/
3849 [50855]: https://github.com/rust-lang/rust/pull/50855/
3850 [51050]: https://github.com/rust-lang/rust/pull/51050/
3851 [51196]: https://github.com/rust-lang/rust/pull/51196/
3852 [51200]: https://github.com/rust-lang/rust/pull/51200/
3853 [51241]: https://github.com/rust-lang/rust/pull/51241/
3854 [51276]: https://github.com/rust-lang/rust/pull/51276/
3855 [51298]: https://github.com/rust-lang/rust/pull/51298/
3856 [51306]: https://github.com/rust-lang/rust/pull/51306/
3857 [51562]: https://github.com/rust-lang/rust/pull/51562/
3858 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3859 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3860 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3861 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3862 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3863 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3864 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3865 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3866 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3867 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3868 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3869 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3870 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3871 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3872 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3873 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3874 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3875 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3876 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3877 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3878 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3879 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3880 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3881 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3882 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3883 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3884 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3885 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3886 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3887 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3888
3889 Version 1.27.2 (2018-07-20)
3890 ===========================
3891
3892 Compatibility Notes
3893 -------------------
3894
3895 - The borrow checker was fixed to avoid potential unsoundness when using
3896   match ergonomics: [#52213][52213].
3897
3898 [52213]: https://github.com/rust-lang/rust/issues/52213
3899
3900 Version 1.27.1 (2018-07-10)
3901 ===========================
3902
3903 Security Notes
3904 --------------
3905
3906 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3907   when running, which enabled executing code as some other user on a
3908   given machine. This release fixes that vulnerability; you can read
3909   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3910
3911   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3912
3913 Compatibility Notes
3914 -------------------
3915
3916 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3917   match ergonomics: [#51415][51415], [#49534][49534].
3918
3919 [51415]: https://github.com/rust-lang/rust/issues/51415
3920 [49534]: https://github.com/rust-lang/rust/issues/49534
3921 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3922 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3923
3924 Version 1.27.0 (2018-06-21)
3925 ==========================
3926
3927 Language
3928 --------
3929 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3930   be used as an identifier.
3931 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3932   bare `Trait` syntax, and should make it clearer when being used in tandem with
3933   `impl Trait` because it is equivalent to the following syntax:
3934   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3935   `Box<Trait> == Box<dyn Trait>`.
3936 - [Attributes on generic parameters such as types and lifetimes are
3937   now stable.][48851] e.g.
3938   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3939 - [The `#[must_use]` attribute can now also be used on functions as well as
3940   types.][48925] It provides a lint that by default warns users when the
3941   value returned by a function has not been used.
3942
3943 Compiler
3944 --------
3945 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3946
3947 Libraries
3948 ---------
3949 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3950   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3951   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3952   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3953   the `cfg` attribute.
3954 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3955   std are now available in core.][49896]
3956 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3957   to `Self`.][49630]
3958 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3959   that the operation isn't done in place.
3960 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3961   the `#[must_use]` attribute][49533] to warn about unused potentially
3962   expensive allocations.
3963
3964 Stabilized APIs
3965 ---------------
3966 - [`DoubleEndedIterator::rfind`]
3967 - [`DoubleEndedIterator::rfold`]
3968 - [`DoubleEndedIterator::try_rfold`]
3969 - [`Duration::from_micros`]
3970 - [`Duration::from_nanos`]
3971 - [`Duration::subsec_micros`]
3972 - [`Duration::subsec_millis`]
3973 - [`HashMap::remove_entry`]
3974 - [`Iterator::try_fold`]
3975 - [`Iterator::try_for_each`]
3976 - [`NonNull::cast`]
3977 - [`Option::filter`]
3978 - [`String::replace_range`]
3979 - [`Take::set_limit`]
3980 - [`hint::unreachable_unchecked`]
3981 - [`os::unix::process::parent_id`]
3982 - [`ptr::swap_nonoverlapping`]
3983 - [`slice::rsplit_mut`]
3984 - [`slice::rsplit`]
3985 - [`slice::swap_with_slice`]
3986
3987 Cargo
3988 -----
3989 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3990   `readme`, and `repository` fields.][cargo/5386]
3991 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3992 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3993   a different directory than `target` for placing compilation artifacts.
3994 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3995   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3996   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3997   where cargo would infer a binary, Cargo will produce a warning. You can
3998   disable this feature ahead of time by setting any of the following to false:
3999   `autobins`, `autobenches`, `autoexamples`, `autotests`.
4000 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
4001   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
4002
4003 Misc
4004 ----
4005 - [Added “The Rustc book” into the official documentation.][49707]
4006   [“The Rustc book”] documents and teaches how to use the rustc compiler.
4007 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
4008
4009 Compatibility Notes
4010 -------------------
4011 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
4012   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
4013   compile, `"".is_empty()` will still compile.
4014 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
4015   will only print the inner type.][48553] E.g.
4016   `print!("{:?}", AtomicBool::new(true))` will print `true`,
4017   not `AtomicBool(true)`.
4018 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
4019   could enter higher numbers but they were not supported by LLVM. Up to 512MB
4020   alignment should cover all use cases.
4021 - The `.description()` method on the `std::error::Error` trait
4022   [has been soft-deprecated][50163]. It is no longer required to implement it.
4023
4024 [48553]: https://github.com/rust-lang/rust/pull/48553/
4025 [48851]: https://github.com/rust-lang/rust/pull/48851/
4026 [48925]: https://github.com/rust-lang/rust/pull/48925/
4027 [49533]: https://github.com/rust-lang/rust/pull/49533/
4028 [49623]: https://github.com/rust-lang/rust/pull/49623/
4029 [49630]: https://github.com/rust-lang/rust/pull/49630/
4030 [49664]: https://github.com/rust-lang/rust/pull/49664/
4031 [49699]: https://github.com/rust-lang/rust/pull/49699/
4032 [49707]: https://github.com/rust-lang/rust/pull/49707/
4033 [49719]: https://github.com/rust-lang/rust/pull/49719/
4034 [49896]: https://github.com/rust-lang/rust/pull/49896/
4035 [49968]: https://github.com/rust-lang/rust/pull/49968/
4036 [50163]: https://github.com/rust-lang/rust/pull/50163
4037 [50177]: https://github.com/rust-lang/rust/pull/50177/
4038 [50378]: https://github.com/rust-lang/rust/pull/50378/
4039 [50398]: https://github.com/rust-lang/rust/pull/50398/
4040 [50423]: https://github.com/rust-lang/rust/pull/50423/
4041 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
4042 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
4043 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
4044 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
4045 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
4046 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
4047 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
4048 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
4049 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
4050 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
4051 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
4052 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
4053 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
4054 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
4055 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
4056 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
4057 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
4058 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
4059 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
4060 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
4061 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
4062 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
4063 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4064 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
4065 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
4066 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
4067 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
4068 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
4069 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
4070 [“The Rustc book”]: https://doc.rust-lang.org/rustc
4071
4072
4073 Version 1.26.2 (2018-06-05)
4074 ==========================
4075
4076 Compatibility Notes
4077 -------------------
4078
4079 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
4080
4081 [51117]: https://github.com/rust-lang/rust/issues/51117
4082
4083
4084 Version 1.26.1 (2018-05-29)
4085 ==========================
4086
4087 Tools
4088 -----
4089
4090 - [RLS now works on Windows.][50646]
4091 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
4092
4093
4094 Compatibility Notes
4095 --------
4096
4097 - [`fn main() -> impl Trait` no longer works for non-Termination
4098   trait.][50656]
4099   This reverts an accidental stabilization.
4100 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
4101 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
4102
4103 [50646]: https://github.com/rust-lang/rust/issues/50646
4104 [50656]: https://github.com/rust-lang/rust/pull/50656
4105 [50812]: https://github.com/rust-lang/rust/pull/50812
4106 [50950]: https://github.com/rust-lang/rust/issues/50950
4107 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
4108
4109 Version 1.26.0 (2018-05-10)
4110 ==========================
4111
4112 Language
4113 --------
4114 - [Closures now implement `Copy` and/or `Clone` if all captured variables
4115   implement either or both traits.][49299]
4116 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
4117 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
4118   lifetime can be elided.][49458]
4119 - [`impl Trait` is now stable allowing you to have abstract types in returns
4120    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
4121   `fn open(path: impl AsRef<Path>)`.
4122 - [Pattern matching will now automatically apply dereferences.][49394]
4123 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
4124 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
4125 - [A lot of operations are now available in a const context.][46882] E.g. You
4126   can now index into constant arrays, reference and dereference into constants,
4127   and use tuple struct constructors.
4128 - [Fixed entry slice patterns are now stable.][48516] E.g.
4129   ```rust
4130   let points = [1, 2, 3, 4];
4131   match points {
4132       [1, 2, 3, 4] => println!("All points were sequential."),
4133       _ => println!("Not all points were sequential."),
4134   }
4135   ```
4136
4137
4138 Compiler
4139 --------
4140 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4141 - [Fixed exponential projection complexity on nested types.][48296]
4142   This can provide up to a ~12% reduction in compile times for certain crates.
4143 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4144   to remap path prefixes outputted by the compiler.
4145 - [Added `powerpc-unknown-netbsd` target.][48281]
4146
4147 Libraries
4148 ---------
4149 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4150 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4151   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4152 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4153 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4154 - [`ascii::escape_default` is now available in libcore.][48735]
4155 - [Trailing commas are now supported in std and core macros.][48056]
4156 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4157 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4158
4159 Stabilized APIs
4160 ---------------
4161 - [`*const T::add`]
4162 - [`*const T::copy_to_nonoverlapping`]
4163 - [`*const T::copy_to`]
4164 - [`*const T::read_unaligned`]
4165 - [`*const T::read_volatile`]
4166 - [`*const T::read`]
4167 - [`*const T::sub`]
4168 - [`*const T::wrapping_add`]
4169 - [`*const T::wrapping_sub`]
4170 - [`*mut T::add`]
4171 - [`*mut T::copy_to_nonoverlapping`]
4172 - [`*mut T::copy_to`]
4173 - [`*mut T::read_unaligned`]
4174 - [`*mut T::read_volatile`]
4175 - [`*mut T::read`]
4176 - [`*mut T::replace`]
4177 - [`*mut T::sub`]
4178 - [`*mut T::swap`]
4179 - [`*mut T::wrapping_add`]
4180 - [`*mut T::wrapping_sub`]
4181 - [`*mut T::write_bytes`]
4182 - [`*mut T::write_unaligned`]
4183 - [`*mut T::write_volatile`]
4184 - [`*mut T::write`]
4185 - [`Box::leak`]
4186 - [`FromUtf8Error::as_bytes`]
4187 - [`LocalKey::try_with`]
4188 - [`Option::cloned`]
4189 - [`btree_map::Entry::and_modify`]
4190 - [`fs::read_to_string`]
4191 - [`fs::read`]
4192 - [`fs::write`]
4193 - [`hash_map::Entry::and_modify`]
4194 - [`iter::FusedIterator`]
4195 - [`ops::RangeInclusive`]
4196 - [`ops::RangeToInclusive`]
4197 - [`process::id`]
4198 - [`slice::rotate_left`]
4199 - [`slice::rotate_right`]
4200 - [`String::retain`]
4201
4202
4203 Cargo
4204 -----
4205 - [Cargo will now output path to custom commands when `-v` is
4206   passed with `--list`][cargo/5041]
4207 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4208
4209 Misc
4210 ----
4211 - [The second edition of "The Rust Programming Language" book is now recommended
4212   over the first.][48404]
4213
4214 Compatibility Notes
4215 -------------------
4216
4217 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4218   syntax is now invalid.
4219   ```
4220   use std::ops::Fn as dyn;
4221   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4222   ```
4223 - [The result of dereferences are no longer promoted to `'static`.][47408]
4224   e.g.
4225   ```rust
4226   fn main() {
4227       const PAIR: &(i32, i32) = &(0, 1);
4228       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4229   }
4230   ```
4231 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4232 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4233   an error.][48235]
4234 - [Removed hoedown from rustdoc.][48274]
4235 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4236
4237 [46882]: https://github.com/rust-lang/rust/pull/46882
4238 [47379]: https://github.com/rust-lang/rust/pull/47379
4239 [47408]: https://github.com/rust-lang/rust/pull/47408
4240 [47813]: https://github.com/rust-lang/rust/pull/47813
4241 [48056]: https://github.com/rust-lang/rust/pull/48056
4242 [48125]: https://github.com/rust-lang/rust/pull/48125
4243 [48166]: https://github.com/rust-lang/rust/pull/48166
4244 [48235]: https://github.com/rust-lang/rust/pull/48235
4245 [48274]: https://github.com/rust-lang/rust/pull/48274
4246 [48281]: https://github.com/rust-lang/rust/pull/48281
4247 [48296]: https://github.com/rust-lang/rust/pull/48296
4248 [48326]: https://github.com/rust-lang/rust/pull/48326
4249 [48359]: https://github.com/rust-lang/rust/pull/48359
4250 [48404]: https://github.com/rust-lang/rust/pull/48404
4251 [48481]: https://github.com/rust-lang/rust/pull/48481
4252 [48516]: https://github.com/rust-lang/rust/pull/48516
4253 [48628]: https://github.com/rust-lang/rust/pull/48628
4254 [48629]: https://github.com/rust-lang/rust/pull/48629
4255 [48657]: https://github.com/rust-lang/rust/pull/48657
4256 [48735]: https://github.com/rust-lang/rust/pull/48735
4257 [48978]: https://github.com/rust-lang/rust/pull/48978
4258 [49101]: https://github.com/rust-lang/rust/pull/49101
4259 [49109]: https://github.com/rust-lang/rust/pull/49109
4260 [49121]: https://github.com/rust-lang/rust/pull/49121
4261 [49162]: https://github.com/rust-lang/rust/pull/49162
4262 [49184]: https://github.com/rust-lang/rust/pull/49184
4263 [49234]: https://github.com/rust-lang/rust/pull/49234
4264 [49255]: https://github.com/rust-lang/rust/pull/49255
4265 [49299]: https://github.com/rust-lang/rust/pull/49299
4266 [49305]: https://github.com/rust-lang/rust/pull/49305
4267 [49394]: https://github.com/rust-lang/rust/pull/49394
4268 [49458]: https://github.com/rust-lang/rust/pull/49458
4269 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4270 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4271 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4272 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4273 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4274 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4275 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4276 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4277 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4278 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4279 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4280 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4281 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4282 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4283 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4284 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4285 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4286 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4287 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4288 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4289 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4290 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4291 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4292 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4293 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4294 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4295 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4296 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4297 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4298 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4299 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4300 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4301 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4302 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4303 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4304 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4305 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4306 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4307 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4308 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4309 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4310 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4311
4312
4313 Version 1.25.0 (2018-03-29)
4314 ==========================
4315
4316 Language
4317 --------
4318 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4319 - [You can now use nested groups of imports.][47948]
4320   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4321 - [You can now have `|` at the start of a match arm.][47947] e.g.
4322 ```rust
4323 enum Foo { A, B, C }
4324
4325 fn main() {
4326     let x = Foo::A;
4327     match x {
4328         | Foo::A
4329         | Foo::B => println!("AB"),
4330         | Foo::C => println!("C"),
4331     }
4332 }
4333 ```
4334
4335 Compiler
4336 --------
4337 - [Upgraded to LLVM 6.][47828]
4338 - [Added `-C lto=val` option.][47521]
4339 - [Added `i586-unknown-linux-musl` target][47282]
4340
4341 Libraries
4342 ---------
4343 - [Impl Send for `process::Command` on Unix.][47760]
4344 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4345 - [`UnsafeCell::into_inner` is now safe.][47204]
4346 - [Implement libstd for CloudABI.][47268]
4347 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4348 - [Implement `AsRef<Path>` for Component][46985]
4349 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4350 - [Moved `Duration` to libcore.][46666]
4351
4352 Stabilized APIs
4353 ---------------
4354 - [`Location::column`]
4355 - [`ptr::NonNull`]
4356
4357 The following functions can now be used in a constant expression.
4358 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4359 - [`Duration::new`][47300]
4360 - [`Duration::from_secs`][47300]
4361 - [`Duration::from_millis`][47300]
4362
4363 Cargo
4364 -----
4365 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4366 - [`cargo new` now defaults to creating a binary crate, instead of a
4367   library crate.][cargo/5029]
4368
4369 Misc
4370 ----
4371 - [Rust by example is now shipped with new releases][46196]
4372
4373 Compatibility Notes
4374 -------------------
4375 - [Deprecated `net::lookup_host`.][47510]
4376 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4377 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4378   around indexing operations (see [#47349][47349]). This has been fixed (which also
4379   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4380 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4381
4382 [33903]: https://github.com/rust-lang/rust/pull/33903
4383 [47947]: https://github.com/rust-lang/rust/pull/47947
4384 [47948]: https://github.com/rust-lang/rust/pull/47948
4385 [47760]: https://github.com/rust-lang/rust/pull/47760
4386 [47790]: https://github.com/rust-lang/rust/pull/47790
4387 [47828]: https://github.com/rust-lang/rust/pull/47828
4388 [47398]: https://github.com/rust-lang/rust/pull/47398
4389 [47510]: https://github.com/rust-lang/rust/pull/47510
4390 [47521]: https://github.com/rust-lang/rust/pull/47521
4391 [47204]: https://github.com/rust-lang/rust/pull/47204
4392 [47251]: https://github.com/rust-lang/rust/pull/47251
4393 [47268]: https://github.com/rust-lang/rust/pull/47268
4394 [47282]: https://github.com/rust-lang/rust/pull/47282
4395 [47300]: https://github.com/rust-lang/rust/pull/47300
4396 [47349]: https://github.com/rust-lang/rust/pull/47349
4397 [46931]: https://github.com/rust-lang/rust/pull/46931
4398 [46985]: https://github.com/rust-lang/rust/pull/46985
4399 [47006]: https://github.com/rust-lang/rust/pull/47006
4400 [46830]: https://github.com/rust-lang/rust/pull/46830
4401 [46095]: https://github.com/rust-lang/rust/pull/46095
4402 [46666]: https://github.com/rust-lang/rust/pull/46666
4403 [46196]: https://github.com/rust-lang/rust/pull/46196
4404 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4405 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4406 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4407 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4408 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4409
4410
4411 Version 1.24.1 (2018-03-01)
4412 ==========================
4413
4414  - [Do not abort when unwinding through FFI][48251]
4415  - [Emit UTF-16 files for linker arguments on Windows][48318]
4416  - [Make the error index generator work again][48308]
4417  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4418
4419 [48251]: https://github.com/rust-lang/rust/issues/48251
4420 [48308]: https://github.com/rust-lang/rust/issues/48308
4421 [48318]: https://github.com/rust-lang/rust/issues/48318
4422 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4423
4424
4425 Version 1.24.0 (2018-02-15)
4426 ==========================
4427
4428 Language
4429 --------
4430 - [External `sysv64` ffi is now available.][46528]
4431   eg. `extern "sysv64" fn foo () {}`
4432
4433 Compiler
4434 --------
4435 - [rustc now uses 16 codegen units by default for release builds.][46910]
4436   For the fastest builds, utilize `codegen-units=1`.
4437 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4438 - [Add `aarch64-unknown-openbsd` support][46760]
4439
4440 Libraries
4441 ---------
4442 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4443   improvement in performance in the majority of cases.
4444 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4445   with Windows.][46798]
4446 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4447 - [impl `From<bool>` for `AtomicBool`][46293]
4448 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4449 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4450 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4451 - [float::from_bits now just uses transmute.][46012] This provides
4452   some optimisations from LLVM.
4453 - [Copied `AsciiExt` methods onto `char`][46077]
4454 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4455 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4456 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4457 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4458
4459 Stabilized APIs
4460 ---------------
4461 - [`RefCell::replace`]
4462 - [`RefCell::swap`]
4463 - [`atomic::spin_loop_hint`]
4464
4465 The following functions can now be used in a constant expression.
4466 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4467
4468 - [`AtomicBool::new`][46287]
4469 - [`AtomicUsize::new`][46287]
4470 - [`AtomicIsize::new`][46287]
4471 - [`AtomicPtr::new`][46287]
4472 - [`Cell::new`][46287]
4473 - [`{integer}::min_value`][46287]
4474 - [`{integer}::max_value`][46287]
4475 - [`mem::size_of`][46287]
4476 - [`mem::align_of`][46287]
4477 - [`ptr::null`][46287]
4478 - [`ptr::null_mut`][46287]
4479 - [`RefCell::new`][46287]
4480 - [`UnsafeCell::new`][46287]
4481
4482 Cargo
4483 -----
4484 - [Added a `workspace.default-members` config that
4485   overrides implied `--all` in virtual workspaces.][cargo/4743]
4486 - [Enable incremental by default on development builds.][cargo/4817] Also added
4487   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4488   per-project or global basis respectively.
4489
4490 Misc
4491 ----
4492
4493 Compatibility Notes
4494 -------------------
4495 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4496 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4497   in accordance with IETF RFC 4291 §2.2.
4498 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4499 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4500   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4501 - [Leading zeros in tuple struct members is now an error][47084]
4502 - [`column!()` macro is one-based instead of zero-based][46977]
4503 - [`fmt::Arguments` can no longer be shared across threads][45198]
4504 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4505 - [Cargo sets a different working directory for the compiler][cargo/4788]
4506
4507 [44884]: https://github.com/rust-lang/rust/pull/44884
4508 [45198]: https://github.com/rust-lang/rust/pull/45198
4509 [45506]: https://github.com/rust-lang/rust/pull/45506
4510 [45904]: https://github.com/rust-lang/rust/pull/45904
4511 [45990]: https://github.com/rust-lang/rust/pull/45990
4512 [46012]: https://github.com/rust-lang/rust/pull/46012
4513 [46077]: https://github.com/rust-lang/rust/pull/46077
4514 [46094]: https://github.com/rust-lang/rust/pull/46094
4515 [46284]: https://github.com/rust-lang/rust/pull/46284
4516 [46287]: https://github.com/rust-lang/rust/pull/46287
4517 [46293]: https://github.com/rust-lang/rust/pull/46293
4518 [46528]: https://github.com/rust-lang/rust/pull/46528
4519 [46671]: https://github.com/rust-lang/rust/pull/46671
4520 [46713]: https://github.com/rust-lang/rust/pull/46713
4521 [46735]: https://github.com/rust-lang/rust/pull/46735
4522 [46749]: https://github.com/rust-lang/rust/pull/46749
4523 [46760]: https://github.com/rust-lang/rust/pull/46760
4524 [46798]: https://github.com/rust-lang/rust/pull/46798
4525 [46828]: https://github.com/rust-lang/rust/pull/46828
4526 [46831]: https://github.com/rust-lang/rust/pull/46831
4527 [46833]: https://github.com/rust-lang/rust/pull/46833
4528 [46910]: https://github.com/rust-lang/rust/pull/46910
4529 [46977]: https://github.com/rust-lang/rust/pull/46977
4530 [47018]: https://github.com/rust-lang/rust/pull/47018
4531 [47080]: https://github.com/rust-lang/rust/pull/47080
4532 [47084]: https://github.com/rust-lang/rust/pull/47084
4533 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4534 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4535 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4536 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4537 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4538 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4539
4540
4541 Version 1.23.0 (2018-01-04)
4542 ==========================
4543
4544 Language
4545 --------
4546 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4547 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4548   Which should fix some confusing errors in some operations.
4549
4550 Compiler
4551 --------
4552 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4553   undefined behavior.][45920]
4554 - [rustc now suggests renaming import if names clash.][45660]
4555 - [Display errors/warnings correctly when there are zero-width or
4556   wide characters.][45711]
4557 - [rustc now avoids unnecessary copies of arguments that are
4558   simple bindings][45380] This should improve memory usage on average by 5-10%.
4559 - [Updated musl used to build musl rustc to 1.1.17][45393]
4560
4561 Libraries
4562 ---------
4563 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4564 - [Implement Hash for raw pointers to unsized types][45483]
4565 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4566 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4567 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4568 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4569   and `<*mut T>::as_mut`][44932]
4570 - [Optimized `Thread::{park, unpark}` implementation][45524]
4571 - [Improved `SliceExt::binary_search` performance.][45333]
4572 - [impl `FromIterator<()>` for `()`][45379]
4573 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4574   is now deprecated.
4575
4576 Stabilized APIs
4577 ---------------
4578
4579 Cargo
4580 -----
4581 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4582   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4583 - [Added unit test checking to `cargo check`][cargo/4592]
4584 - [Cargo now lets you install a specific version
4585   using `cargo install --version`][cargo/4637]
4586
4587 Misc
4588 ----
4589 - [Releases now ship with the Cargo book documentation.][45692]
4590 - [rustdoc now prints rendering warnings on every run.][45324]
4591
4592 Compatibility Notes
4593 -------------------
4594 - [Changes have been made to type equality to make it more correct,
4595   in rare cases this could break some code.][45853] [Tracking issue for
4596   further information][45852]
4597 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4598 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4599   Android 9, the minimum supported version is Android 14.
4600 - [Bumped the minimum LLVM to 3.9][45326]
4601
4602 [44042]: https://github.com/rust-lang/rust/pull/44042
4603 [44932]: https://github.com/rust-lang/rust/pull/44932
4604 [45267]: https://github.com/rust-lang/rust/pull/45267
4605 [45324]: https://github.com/rust-lang/rust/pull/45324
4606 [45326]: https://github.com/rust-lang/rust/pull/45326
4607 [45333]: https://github.com/rust-lang/rust/pull/45333
4608 [45379]: https://github.com/rust-lang/rust/pull/45379
4609 [45380]: https://github.com/rust-lang/rust/pull/45380
4610 [45393]: https://github.com/rust-lang/rust/pull/45393
4611 [45435]: https://github.com/rust-lang/rust/pull/45435
4612 [45483]: https://github.com/rust-lang/rust/pull/45483
4613 [45524]: https://github.com/rust-lang/rust/pull/45524
4614 [45571]: https://github.com/rust-lang/rust/pull/45571
4615 [45580]: https://github.com/rust-lang/rust/pull/45580
4616 [45610]: https://github.com/rust-lang/rust/pull/45610
4617 [45660]: https://github.com/rust-lang/rust/pull/45660
4618 [45692]: https://github.com/rust-lang/rust/pull/45692
4619 [45711]: https://github.com/rust-lang/rust/pull/45711
4620 [45772]: https://github.com/rust-lang/rust/pull/45772
4621 [45852]: https://github.com/rust-lang/rust/issues/45852
4622 [45853]: https://github.com/rust-lang/rust/pull/45853
4623 [45887]: https://github.com/rust-lang/rust/pull/45887
4624 [45920]: https://github.com/rust-lang/rust/pull/45920
4625 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4626 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4627 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4628
4629
4630 Version 1.22.1 (2017-11-22)
4631 ==========================
4632
4633 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4634
4635 [46183]: https://github.com/rust-lang/rust/pull/46183
4636
4637 Version 1.22.0 (2017-11-22)
4638 ==========================
4639
4640 Language
4641 --------
4642 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4643 - [Now accepts underscores in unicode escapes][43716]
4644 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4645 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4646
4647 Compiler
4648 --------
4649 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4650 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4651   This should decrease compile times for debug builds.
4652 - [strict memory alignment now enabled on ARMv6][45094]
4653 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4654
4655 Libraries
4656 ---------
4657 - [Allow atomic operations up to 32 bits
4658   on `armv5te_unknown_linux_gnueabi`][44978]
4659 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4660 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4661 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4662 - [Properly detect overflow in `Instant += Duration`.][44220]
4663 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4664 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4665 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4666
4667 Stabilized APIs
4668 ---------------
4669
4670 Cargo
4671 -----
4672 - [Cargo will now build multi file examples in subdirectories of the `examples`
4673   folder that have a `main.rs` file.][cargo/4496]
4674 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4675   the old format will continue to work and can be updated with `cargo update`.
4676 - [Now supports vendoring git repositories][cargo/3992]
4677
4678 Misc
4679 ----
4680 - [`libbacktrace` is now available on Apple platforms.][44251]
4681 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4682   This now lets you specify that a given code example will fail to compile.
4683
4684 Compatibility Notes
4685 -------------------
4686 - [The minimum Android version that rustc can build for has been bumped
4687   to `4.0` from `2.3`][45656]
4688 - [Allowing `T op= &T` for numeric types has broken some type
4689   inference cases][45480]
4690
4691
4692 [42526]: https://github.com/rust-lang/rust/pull/42526
4693 [43017]: https://github.com/rust-lang/rust/pull/43017
4694 [43716]: https://github.com/rust-lang/rust/pull/43716
4695 [43949]: https://github.com/rust-lang/rust/pull/43949
4696 [44015]: https://github.com/rust-lang/rust/pull/44015
4697 [44220]: https://github.com/rust-lang/rust/pull/44220
4698 [44251]: https://github.com/rust-lang/rust/pull/44251
4699 [44287]: https://github.com/rust-lang/rust/pull/44287
4700 [44303]: https://github.com/rust-lang/rust/pull/44303
4701 [44456]: https://github.com/rust-lang/rust/pull/44456
4702 [44466]: https://github.com/rust-lang/rust/pull/44466
4703 [44895]: https://github.com/rust-lang/rust/pull/44895
4704 [44966]: https://github.com/rust-lang/rust/pull/44966
4705 [44978]: https://github.com/rust-lang/rust/pull/44978
4706 [45041]: https://github.com/rust-lang/rust/pull/45041
4707 [45064]: https://github.com/rust-lang/rust/pull/45064
4708 [45075]: https://github.com/rust-lang/rust/pull/45075
4709 [45094]: https://github.com/rust-lang/rust/pull/45094
4710 [45095]: https://github.com/rust-lang/rust/pull/45095
4711 [45480]: https://github.com/rust-lang/rust/issues/45480
4712 [45656]: https://github.com/rust-lang/rust/pull/45656
4713 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4714 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4715 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4716
4717
4718
4719
4720
4721
4722 Version 1.21.0 (2017-10-12)
4723 ==========================
4724
4725 Language
4726 --------
4727 - [You can now use static references for literals.][43838]
4728   Example:
4729   ```rust
4730   fn main() {
4731       let x: &'static u32 = &0;
4732   }
4733   ```
4734 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4735   Example:
4736   ```rust
4737   my_macro!(Vec<i32>::new); // Always worked
4738   my_macro!(Vec::<i32>::new); // Now works
4739   ```
4740
4741 Compiler
4742 --------
4743 - [Upgraded jemalloc to 4.5.0][43911]
4744 - [Enabled unwinding panics on Redox][43917]
4745 - [Now runs LLVM in parallel during translation phase.][43506]
4746   This should reduce peak memory usage.
4747
4748 Libraries
4749 ---------
4750 - [Generate builtin impls for `Clone` for all arrays and tuples that
4751   are `T: Clone`][43690]
4752 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4753 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4754   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4755
4756 Stabilized APIs
4757 ---------------
4758
4759 [`std::mem::discriminant`]
4760
4761 Cargo
4762 -----
4763 - [You can now call `cargo install` with multiple package names][cargo/4216]
4764 - [Cargo commands inside a virtual workspace will now implicitly
4765   pass `--all`][cargo/4335]
4766 - [Added a `[patch]` section to `Cargo.toml` to handle
4767   prepublication dependencies][cargo/4123] [RFC 1969]
4768 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4769   like patterns][cargo/4270]
4770 - [Added the `--all-targets` option][cargo/4400]
4771 - [Using required dependencies as a feature is now deprecated and emits
4772   a warning][cargo/4364]
4773
4774
4775 Misc
4776 ----
4777 - [Cargo docs are moving][43916]
4778   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4779 - [The rustdoc book is now available][43863]
4780   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4781 - [Added a preview of RLS has been made available through rustup][44204]
4782   Install with `rustup component add rls-preview`
4783 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4784   Previously only showed `std::os::unix`.
4785
4786 Compatibility Notes
4787 -------------------
4788 - [Changes in method matching against higher-ranked types][43880] This may cause
4789   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4790 - [rustc's JSON error output's byte position start at top of file.][42973]
4791   Was previously relative to the rustc's internal `CodeMap` struct which
4792   required the unstable library `libsyntax` to correctly use.
4793 - [`unused_results` lint no longer ignores booleans][43728]
4794
4795 [42565]: https://github.com/rust-lang/rust/pull/42565
4796 [42973]: https://github.com/rust-lang/rust/pull/42973
4797 [43348]: https://github.com/rust-lang/rust/pull/43348
4798 [43459]: https://github.com/rust-lang/rust/pull/43459
4799 [43506]: https://github.com/rust-lang/rust/pull/43506
4800 [43540]: https://github.com/rust-lang/rust/pull/43540
4801 [43690]: https://github.com/rust-lang/rust/pull/43690
4802 [43728]: https://github.com/rust-lang/rust/pull/43728
4803 [43838]: https://github.com/rust-lang/rust/pull/43838
4804 [43863]: https://github.com/rust-lang/rust/pull/43863
4805 [43880]: https://github.com/rust-lang/rust/pull/43880
4806 [43911]: https://github.com/rust-lang/rust/pull/43911
4807 [43916]: https://github.com/rust-lang/rust/pull/43916
4808 [43917]: https://github.com/rust-lang/rust/pull/43917
4809 [44204]: https://github.com/rust-lang/rust/pull/44204
4810 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4811 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4812 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4813 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4814 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4815 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4816 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4817 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4818 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4819
4820 Version 1.20.0 (2017-08-31)
4821 ===========================
4822
4823 Language
4824 --------
4825 - [Associated constants are now stabilised.][42809]
4826 - [A lot of macro bugs are now fixed.][42913]
4827
4828 Compiler
4829 --------
4830
4831 - [Struct fields are now properly coerced to the expected field type.][42807]
4832 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4833   `wasm32-experimental-emscripten` target.
4834 - [Changed some of the error messages to be more helpful.][42033]
4835 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4836   it.][43170]
4837 - [rustc now reports the total number of errors on compilation failure][43015]
4838   previously this was only the number of errors in the pass that failed.
4839 - [Expansion in rustc has been sped up 29x.][42533]
4840 - [added `msp430-none-elf` target.][43099]
4841 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4842   applicable][43178]
4843 - [Fixes backtraces on Redox][43228]
4844 - [rustc now identifies different versions of same crate when absolute paths of
4845   different types match in an error message.][42826]
4846
4847 Libraries
4848 ---------
4849
4850
4851 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4852 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4853   tuples.][43011]
4854 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4855   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4856 - [Impl `Clone` for `DefaultHasher`.][42799]
4857 - [Impl `Sync` for `SyncSender`.][42397]
4858 - [Impl `FromStr` for `char`][42271]
4859 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4860   NaN.][42431]
4861 - [allow messages in the `unimplemented!()` macro.][42155]
4862   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4863 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4864 - [Upgrade to Unicode 10.0.0][42999]
4865 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4866 - [Skip the main thread's manual stack guard on Linux][43072]
4867 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4868 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4869   previously 2^15.
4870 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4871
4872 Stabilized APIs
4873 ---------------
4874
4875 - [`CStr::into_c_string`]
4876 - [`CString::as_c_str`]
4877 - [`CString::into_boxed_c_str`]
4878 - [`Chain::get_mut`]
4879 - [`Chain::get_ref`]
4880 - [`Chain::into_inner`]
4881 - [`Option::get_or_insert_with`]
4882 - [`Option::get_or_insert`]
4883 - [`OsStr::into_os_string`]
4884 - [`OsString::into_boxed_os_str`]
4885 - [`Take::get_mut`]
4886 - [`Take::get_ref`]
4887 - [`Utf8Error::error_len`]
4888 - [`char::EscapeDebug`]
4889 - [`char::escape_debug`]
4890 - [`compile_error!`]
4891 - [`f32::from_bits`]
4892 - [`f32::to_bits`]
4893 - [`f64::from_bits`]
4894 - [`f64::to_bits`]
4895 - [`mem::ManuallyDrop`]
4896 - [`slice::sort_unstable_by_key`]
4897 - [`slice::sort_unstable_by`]
4898 - [`slice::sort_unstable`]
4899 - [`str::from_boxed_utf8_unchecked`]
4900 - [`str::as_bytes_mut`]
4901 - [`str::as_bytes_mut`]
4902 - [`str::from_utf8_mut`]
4903 - [`str::from_utf8_unchecked_mut`]
4904 - [`str::get_mut`]
4905 - [`str::get_unchecked_mut`]
4906 - [`str::get_unchecked`]
4907 - [`str::get`]
4908 - [`str::into_boxed_bytes`]
4909
4910
4911 Cargo
4912 -----
4913 - [Cargo API token location moved from `~/.cargo/config` to
4914   `~/.cargo/credentials`.][cargo/3978]
4915 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4916   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4917   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4918 - [You can now specify version of a binary when installed through
4919   `cargo install` using `--vers`.][cargo/4229]
4920 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4921   failure.][cargo/4248]
4922 - [Changed the convention around which file is the crate root.][cargo/4259]
4923 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4924   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4925
4926 Compatibility Notes
4927 -------------------
4928
4929 - [Functions with `'static` in their return types will now not be as usable as
4930   if they were using lifetime parameters instead.][42417]
4931 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4932   takes the sign of NaN into account where previously didn't.][42430]
4933
4934 [42033]: https://github.com/rust-lang/rust/pull/42033
4935 [42155]: https://github.com/rust-lang/rust/pull/42155
4936 [42271]: https://github.com/rust-lang/rust/pull/42271
4937 [42397]: https://github.com/rust-lang/rust/pull/42397
4938 [42417]: https://github.com/rust-lang/rust/pull/42417
4939 [42430]: https://github.com/rust-lang/rust/pull/42430
4940 [42431]: https://github.com/rust-lang/rust/pull/42431
4941 [42533]: https://github.com/rust-lang/rust/pull/42533
4942 [42571]: https://github.com/rust-lang/rust/pull/42571
4943 [42613]: https://github.com/rust-lang/rust/pull/42613
4944 [42799]: https://github.com/rust-lang/rust/pull/42799
4945 [42807]: https://github.com/rust-lang/rust/pull/42807
4946 [42809]: https://github.com/rust-lang/rust/pull/42809
4947 [42822]: https://github.com/rust-lang/rust/pull/42822
4948 [42826]: https://github.com/rust-lang/rust/pull/42826
4949 [42854]: https://github.com/rust-lang/rust/pull/42854
4950 [42913]: https://github.com/rust-lang/rust/pull/42913
4951 [42999]: https://github.com/rust-lang/rust/pull/42999
4952 [43011]: https://github.com/rust-lang/rust/pull/43011
4953 [43015]: https://github.com/rust-lang/rust/pull/43015
4954 [43072]: https://github.com/rust-lang/rust/pull/43072
4955 [43077]: https://github.com/rust-lang/rust/pull/43077
4956 [43097]: https://github.com/rust-lang/rust/pull/43097
4957 [43099]: https://github.com/rust-lang/rust/pull/43099
4958 [43170]: https://github.com/rust-lang/rust/pull/43170
4959 [43178]: https://github.com/rust-lang/rust/pull/43178
4960 [43185]: https://github.com/rust-lang/rust/pull/43185
4961 [43228]: https://github.com/rust-lang/rust/pull/43228
4962 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4963 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4964 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4965 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4966 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4967 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4968 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4969 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4970 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4971 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4972 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4973 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4974 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4975 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4976 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4977 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4978 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4979 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4980 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4981 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4982 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4983 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4984 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4985 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4986 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4987 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4988 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4989 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4990 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4991 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4992 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4993 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4994 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4995 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4996 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4997 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4998 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4999 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
5000 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
5001
5002
5003 Version 1.19.0 (2017-07-20)
5004 ===========================
5005
5006 Language
5007 --------
5008
5009 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
5010   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
5011 - [Macro recursion limit increased to 1024 from 64.][41676]
5012 - [Added lint for detecting unused macros.][41907]
5013 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
5014   For example: `let x = loop { break 7; };`
5015 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
5016   contain `Copy` types and cannot have a `Drop` implementation.
5017   Example: `union Foo { bar: u8, baz: usize }`
5018 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
5019   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
5020
5021 Compiler
5022 --------
5023
5024 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
5025 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
5026   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
5027   you should use `--target armv7-linux-androideabi`.
5028 - [Fixed ICE when removing a source file between compilation sessions.][41873]
5029 - [Minor optimisation of string operations.][42037]
5030 - [Compiler error message is now `aborting due to previous error(s)` instead of
5031   `aborting due to N previous errors`][42150] This was previously inaccurate and
5032   would only count certain kinds of errors.
5033 - [The compiler now supports Visual Studio 2017][42225]
5034 - [The compiler is now built against LLVM 4.0.1 by default][42948]
5035 - [Added a lot][42264] of [new error codes][42302]
5036 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
5037   libraries with C Run-time Libraries(CRT) to be statically linked.
5038 - [Fixed various ARM codegen bugs][42740]
5039
5040 Libraries
5041 ---------
5042
5043 - [`String` now implements `FromIterator<Cow<'a, str>>` and
5044   `Extend<Cow<'a, str>>`][41449]
5045 - [`Vec` now implements `From<&mut [T]>`][41530]
5046 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
5047 - [`SplitWhitespace` now implements `Clone`][41659]
5048 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
5049   1.5x faster][41764]
5050 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
5051   macros, but for printing to stderr.
5052
5053 Stabilized APIs
5054 ---------------
5055
5056 - [`OsString::shrink_to_fit`]
5057 - [`cmp::Reverse`]
5058 - [`Command::envs`]
5059 - [`thread::ThreadId`]
5060
5061 Cargo
5062 -----
5063
5064 - [Build scripts can now add environment variables to the environment
5065   the crate is being compiled in.
5066   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
5067 - [Subcommands now replace the current process rather than spawning a new
5068   child process][cargo/3970]
5069 - [Workspace members can now accept glob file patterns][cargo/3979]
5070 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
5071   the members in a given workspace.][cargo/3988]
5072 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
5073 - [Target directory path is now in the cargo metadata][cargo/4022]
5074 - [Cargo no longer checks out a local working directory for the
5075   crates.io index][cargo/4026] This should provide smaller file size for the
5076   registry, and improve cloning times, especially on Windows machines.
5077 - [Added an `--exclude` option for excluding certain packages when using the
5078   `--all` option][cargo/4031]
5079 - [Cargo will now automatically retry when receiving a 5xx error
5080   from crates.io][cargo/4032]
5081 - [The `--features` option now accepts multiple comma or space
5082   delimited values.][cargo/4084]
5083 - [Added support for custom target specific runners][cargo/3954]
5084
5085 Misc
5086 ----
5087
5088 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
5089   Windows Debugger.
5090 - [Rust will now release XZ compressed packages][rust-installer/57]
5091 - [rustup will now prefer to download rust packages with
5092   XZ compression][rustup/1100] over GZip packages.
5093 - [Added the ability to escape `#` in rust documentation][41785] By adding
5094   additional `#`'s ie. `##` is now `#`
5095
5096 Compatibility Notes
5097 -------------------
5098
5099 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
5100 - [`-Z` flags are now no longer allowed to be used on the stable
5101   compiler.][41751] This has been a warning for a year previous to this.
5102 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
5103   longer works][42844]. Users should migrate to the built-in `check`
5104   command, which has been available since 1.16.
5105 - [Ending a float literal with `._` is now a hard error.
5106   Example: `42._` .][41946]
5107 - [Any use of a private `extern crate` outside of its module is now a
5108   hard error.][36886] This was previously a warning.
5109 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
5110   relative while the `::` prefix makes a path absolute, but was ignored and the
5111   path was relative regardless.
5112 - [Floating point constants in match patterns is now a hard error][36890]
5113   This was previously a warning.
5114 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
5115   match patterns is now a hard error][36891] This was previously a warning.
5116 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
5117   a warning.
5118 - [From the pound escape, lines consisting of multiple `#`s are
5119   now visible][41785]
5120 - [It is an error to re-export private enum variants][42460]. This is
5121   known to break a number of crates that depend on an older version of
5122   mustache.
5123 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
5124   to use it to find the linker, and the build will fail where it did
5125   not previously][42607]
5126
5127 [36886]: https://github.com/rust-lang/rust/issues/36886
5128 [36888]: https://github.com/rust-lang/rust/issues/36888
5129 [36890]: https://github.com/rust-lang/rust/issues/36890
5130 [36891]: https://github.com/rust-lang/rust/issues/36891
5131 [36892]: https://github.com/rust-lang/rust/issues/36892
5132 [37406]: https://github.com/rust-lang/rust/issues/37406
5133 [39983]: https://github.com/rust-lang/rust/pull/39983
5134 [41145]: https://github.com/rust-lang/rust/pull/41145
5135 [41192]: https://github.com/rust-lang/rust/pull/41192
5136 [41258]: https://github.com/rust-lang/rust/pull/41258
5137 [41370]: https://github.com/rust-lang/rust/pull/41370
5138 [41449]: https://github.com/rust-lang/rust/pull/41449
5139 [41530]: https://github.com/rust-lang/rust/pull/41530
5140 [41624]: https://github.com/rust-lang/rust/pull/41624
5141 [41656]: https://github.com/rust-lang/rust/pull/41656
5142 [41659]: https://github.com/rust-lang/rust/pull/41659
5143 [41676]: https://github.com/rust-lang/rust/pull/41676
5144 [41751]: https://github.com/rust-lang/rust/pull/41751
5145 [41764]: https://github.com/rust-lang/rust/pull/41764
5146 [41785]: https://github.com/rust-lang/rust/pull/41785
5147 [41873]: https://github.com/rust-lang/rust/pull/41873
5148 [41907]: https://github.com/rust-lang/rust/pull/41907
5149 [41946]: https://github.com/rust-lang/rust/pull/41946
5150 [42016]: https://github.com/rust-lang/rust/pull/42016
5151 [42037]: https://github.com/rust-lang/rust/pull/42037
5152 [42068]: https://github.com/rust-lang/rust/pull/42068
5153 [42150]: https://github.com/rust-lang/rust/pull/42150
5154 [42162]: https://github.com/rust-lang/rust/pull/42162
5155 [42225]: https://github.com/rust-lang/rust/pull/42225
5156 [42264]: https://github.com/rust-lang/rust/pull/42264
5157 [42302]: https://github.com/rust-lang/rust/pull/42302
5158 [42460]: https://github.com/rust-lang/rust/issues/42460
5159 [42607]: https://github.com/rust-lang/rust/issues/42607
5160 [42740]: https://github.com/rust-lang/rust/pull/42740
5161 [42844]: https://github.com/rust-lang/rust/issues/42844
5162 [42948]: https://github.com/rust-lang/rust/pull/42948
5163 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5164 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5165 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5166 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5167 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5168 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5169 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5170 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5171 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5172 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5173 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5174 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5175 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5176 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5177 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5178 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5179 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5180 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5181 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5182 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5183 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5184 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5185
5186
5187 Version 1.18.0 (2017-06-08)
5188 ===========================
5189
5190 Language
5191 --------
5192
5193 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5194   make the item visible to just that module tree. Also accepts the keyword
5195   `crate` to make something public to the whole crate but not users of the
5196   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5197 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5198   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5199 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5200   types like `Write + Send`, trailing `+` are now supported in trait objects,
5201   and better error reporting for trait objects starting with `?Sized`.
5202 - [0e+10 is now a valid floating point literal][40589]
5203 - [Now warns if you bind a lifetime parameter to 'static][40734]
5204 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5205   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5206   representation in some cases.][40377]
5207
5208 Compiler
5209 --------
5210
5211 - [rustc can now emit mir with `--emit mir`][39891]
5212 - [Improved LLVM IR for trivial functions][40367]
5213 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5214 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5215   opportunities found through profiling
5216 - [Improved backtrace formatting when panicking][38165]
5217
5218 Libraries
5219 ---------
5220
5221 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5222   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5223   iteration or reallocation.
5224 - [Simplified HashMap Bucket interface][40561] provides performance
5225   improvements for iterating and cloning.
5226 - [Specialize Vec::from_elem to use calloc][40409]
5227 - [Fixed Race condition in fs::create_dir_all][39799]
5228 - [No longer caching stdio on Windows][40516]
5229 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5230   2.50%~ faster and in one case now 12.50% faster.
5231 - [Optimized `AtomicBool::fetch_nand`][41143]
5232
5233 Stabilized APIs
5234 ---------------
5235
5236 - [`Child::try_wait`]
5237 - [`HashMap::retain`]
5238 - [`HashSet::retain`]
5239 - [`PeekMut::pop`]
5240 - [`TcpStream::peek`]
5241 - [`UdpSocket::peek`]
5242 - [`UdpSocket::peek_from`]
5243
5244 Cargo
5245 -----
5246
5247 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5248   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5249 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5250 - [Added Android build support][cargo/3885]
5251 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5252   of a certain type, for example `cargo build --bins` will build all
5253   binaries.
5254 - [Added support for haiku][cargo/3952]
5255
5256 Misc
5257 ----
5258
5259 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5260 - [Added rust-windbg script for better debugging on Windows][39983]
5261 - [Rust now uses the official cross compiler for NetBSD][40612]
5262 - [rustdoc now accepts `#` at the start of files][40828]
5263 - [Fixed jemalloc support for musl][41168]
5264
5265 Compatibility Notes
5266 -------------------
5267
5268 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5269   always placed after the sign if it exists and before the digits. With the `#`
5270   flag the zeroes are placed after the prefix and before the digits.
5271 - [Due to the struct field optimisation][40377], using `transmute` on structs
5272   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5273   always been undefined behavior, but is now more likely to break in practice.
5274 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5275   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5276   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5277 - [Overlapping inherent `impl`s are now a hard error][40728]
5278 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5279 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5280   `out.asm` and `out.ll` instead of only one of the filetypes.
5281 - [ calling a function that returns `Self` will no longer work][41805] when
5282   the size of `Self` cannot be statically determined.
5283 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5284   this has caused a few regressions namely:
5285
5286   - Changed the link order of local static/dynamic libraries (respecting the
5287     order on given rather than having the compiler reorder).
5288   - Changed how MinGW is linked, native code linked to dynamic libraries
5289     may require manually linking to the gcc support library (for the native
5290     code itself)
5291
5292 [38165]: https://github.com/rust-lang/rust/pull/38165
5293 [39799]: https://github.com/rust-lang/rust/pull/39799
5294 [39891]: https://github.com/rust-lang/rust/pull/39891
5295 [39983]: https://github.com/rust-lang/rust/pull/39983
5296 [40043]: https://github.com/rust-lang/rust/pull/40043
5297 [40241]: https://github.com/rust-lang/rust/pull/40241
5298 [40338]: https://github.com/rust-lang/rust/pull/40338
5299 [40367]: https://github.com/rust-lang/rust/pull/40367
5300 [40377]: https://github.com/rust-lang/rust/pull/40377
5301 [40409]: https://github.com/rust-lang/rust/pull/40409
5302 [40516]: https://github.com/rust-lang/rust/pull/40516
5303 [40556]: https://github.com/rust-lang/rust/pull/40556
5304 [40561]: https://github.com/rust-lang/rust/pull/40561
5305 [40589]: https://github.com/rust-lang/rust/pull/40589
5306 [40612]: https://github.com/rust-lang/rust/pull/40612
5307 [40723]: https://github.com/rust-lang/rust/pull/40723
5308 [40728]: https://github.com/rust-lang/rust/pull/40728
5309 [40731]: https://github.com/rust-lang/rust/pull/40731
5310 [40734]: https://github.com/rust-lang/rust/pull/40734
5311 [40805]: https://github.com/rust-lang/rust/pull/40805
5312 [40807]: https://github.com/rust-lang/rust/pull/40807
5313 [40828]: https://github.com/rust-lang/rust/pull/40828
5314 [40870]: https://github.com/rust-lang/rust/pull/40870
5315 [41085]: https://github.com/rust-lang/rust/pull/41085
5316 [41143]: https://github.com/rust-lang/rust/pull/41143
5317 [41168]: https://github.com/rust-lang/rust/pull/41168
5318 [41270]: https://github.com/rust-lang/rust/issues/41270
5319 [41469]: https://github.com/rust-lang/rust/pull/41469
5320 [41805]: https://github.com/rust-lang/rust/issues/41805
5321 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5322 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5323 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5324 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5325 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5326 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5327 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5328 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5329 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5330 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5331 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5332 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5333 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5334 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5335
5336
5337 Version 1.17.0 (2017-04-27)
5338 ===========================
5339
5340 Language
5341 --------
5342
5343 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5344 * [Fields of structs may be initialized without duplicating the field/variable
5345   names][39761]. [RFC 1682]
5346 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5347 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5348   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5349   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5350   `'b`. Soundness fix.
5351 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5352 * [Static variables may contain references to other statics][40027]
5353
5354 Compiler
5355 --------
5356
5357 * [Exit quickly on only `--emit dep-info`][40336]
5358 * [Make `-C relocation-model` more correctly determine whether the linker
5359   creates a position-independent executable][40245]
5360 * [Add `-C overflow-checks` to directly control whether integer overflow
5361   panics][40037]
5362 * [The rustc type checker now checks items on demand instead of in a single
5363   in-order pass][40008]. This is mostly an internal refactoring in support of
5364   future work, including incremental type checking, but also resolves [RFC
5365   1647], allowing `Self` to appear in `impl` `where` clauses.
5366 * [Optimize vtable loads][39995]
5367 * [Turn off vectorization for Emscripten targets][39990]
5368 * [Provide suggestions for unknown macros imported with `use`][39953]
5369 * [Fix ICEs in path resolution][39939]
5370 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5371 * [Add clearer error message using `&str + &str`][39116]
5372
5373 Stabilized APIs
5374 ---------------
5375
5376 * [`Arc::into_raw`]
5377 * [`Arc::from_raw`]
5378 * [`Arc::ptr_eq`]
5379 * [`Rc::into_raw`]
5380 * [`Rc::from_raw`]
5381 * [`Rc::ptr_eq`]
5382 * [`Ordering::then`]
5383 * [`Ordering::then_with`]
5384 * [`BTreeMap::range`]
5385 * [`BTreeMap::range_mut`]
5386 * [`collections::Bound`]
5387 * [`process::abort`]
5388 * [`ptr::read_unaligned`]
5389 * [`ptr::write_unaligned`]
5390 * [`Result::expect_err`]
5391 * [`Cell::swap`]
5392 * [`Cell::replace`]
5393 * [`Cell::into_inner`]
5394 * [`Cell::take`]
5395
5396 Libraries
5397 ---------
5398
5399 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5400 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5401 * [`String` implements `FromIterator<&char>`][40028]
5402 * `Box` [implements][40009] a number of new conversions:
5403   `From<Box<str>> for String`,
5404   `From<Box<[T]>> for Vec<T>`,
5405   `From<Box<CStr>> for CString`,
5406   `From<Box<OsStr>> for OsString`,
5407   `From<Box<Path>> for PathBuf`,
5408   `Into<Box<str>> for String`,
5409   `Into<Box<[T]>> for Vec<T>`,
5410   `Into<Box<CStr>> for CString`,
5411   `Into<Box<OsStr>> for OsString`,
5412   `Into<Box<Path>> for PathBuf`,
5413   `Default for Box<str>`,
5414   `Default for Box<CStr>`,
5415   `Default for Box<OsStr>`,
5416   `From<&CStr> for Box<CStr>`,
5417   `From<&OsStr> for Box<OsStr>`,
5418   `From<&Path> for Box<Path>`
5419 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5420 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5421 * [Slightly optimize `slice::sort`][39538]
5422 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5423 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5424   `Box<str>` implements `From<&str>`][39438]
5425 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5426   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5427 * [`format!` estimates the needed capacity before writing a string][39356]
5428 * [Support unprivileged symlink creation in Windows][38921]
5429 * [`PathBuf` implements `Default`][38764]
5430 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5431 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5432   and poor hash functions.
5433
5434 Cargo
5435 -----
5436
5437 * [Add `cargo check --all`][cargo/3731]
5438 * [Add an option to ignore SSL revocation checking][cargo/3699]
5439 * [Add `cargo run --package`][cargo/3691]
5440 * [Add `required_features`][cargo/3667]
5441 * [Assume `build.rs` is a build script][cargo/3664]
5442 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5443
5444 Misc
5445 ----
5446
5447 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5448   `rustbook`][39633]
5449 * [The "Unstable Book" documents nightly-only features][ubook]
5450 * [Improve the style of the sidebar in rustdoc output][40265]
5451 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5452 * [Fix MSP430 breakage due to `i128`][40257]
5453 * [Preliminary Solaris/SPARCv9 support][39903]
5454 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5455   run without installing the MSVC runtime.
5456 * [`rustdoc --test` includes file names in test names][39788]
5457 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5458   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5459 * [Initial support for `aarch64-unknown-freebsd`][39491]
5460 * [Initial support for `i686-unknown-netbsd`][39426]
5461 * [This release no longer includes the old makefile build system][39431]. Rust
5462   is built with a custom build system, written in Rust, and with Cargo.
5463 * [Add Debug implementations for libcollection structs][39002]
5464 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5465 * [`--test-threads=0` produces an error][38945]
5466 * [`rustup` installs documentation by default][40526]
5467 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5468   WinDbg and Visual Studio to improve the debugging experience.
5469
5470 Compatibility Notes
5471 -------------------
5472
5473 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5474   workaround, either use MSVC 2015 or run vcvars.bat.
5475 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5476   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5477   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5478   fix.
5479 * [`format!` and `Display::to_string` panic if an underlying formatting
5480   implementation returns an error][40117]. Previously the error was silently
5481   ignored. It is incorrect for `write_fmt` to return an error when writing
5482   to a string.
5483 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5484   crates were marked stable and could be accessed from the stable toolchain.
5485 * [Rust git source no longer includes vendored crates][39728]. Those that need
5486   to build with vendored crates should build from release tarballs.
5487 * [Fix inert attributes from `proc_macro_derives`][39572]
5488 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5489   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5490   build system.
5491 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5492   existing code generally ignores the type of dead-code unless a type-hint is
5493   provided; this can cause surprising inference interactions particularly around
5494   defaulting. The new code uniformly ignores the result type of dead-code.
5495 * [Tuple-struct constructors with private fields are no longer visible][38932]
5496 * [Lifetime parameters that do not appear in the arguments are now considered
5497   early-bound][38897], resolving a soundness bug (#[32330]). The
5498   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5499   April of 2016.
5500 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5501 * [Make transmuting from fn item types to pointer-sized types a hard
5502   error][34198]
5503
5504 [27787]: https://github.com/rust-lang/rust/issues/27787
5505 [32330]: https://github.com/rust-lang/rust/issues/32330
5506 [34198]: https://github.com/rust-lang/rust/pull/34198
5507 [38161]: https://github.com/rust-lang/rust/pull/38161
5508 [38368]: https://github.com/rust-lang/rust/pull/38368
5509 [38584]: https://github.com/rust-lang/rust/issues/38584
5510 [38661]: https://github.com/rust-lang/rust/pull/38661
5511 [38764]: https://github.com/rust-lang/rust/pull/38764
5512 [38864]: https://github.com/rust-lang/rust/issues/38864
5513 [38897]: https://github.com/rust-lang/rust/pull/38897
5514 [38921]: https://github.com/rust-lang/rust/pull/38921
5515 [38932]: https://github.com/rust-lang/rust/pull/38932
5516 [38945]: https://github.com/rust-lang/rust/pull/38945
5517 [38981]: https://github.com/rust-lang/rust/pull/38981
5518 [39002]: https://github.com/rust-lang/rust/pull/39002
5519 [39116]: https://github.com/rust-lang/rust/pull/39116
5520 [39193]: https://github.com/rust-lang/rust/pull/39193
5521 [39265]: https://github.com/rust-lang/rust/pull/39265
5522 [39356]: https://github.com/rust-lang/rust/pull/39356
5523 [39372]: https://github.com/rust-lang/rust/pull/39372
5524 [39426]: https://github.com/rust-lang/rust/pull/39426
5525 [39431]: https://github.com/rust-lang/rust/pull/39431
5526 [39438]: https://github.com/rust-lang/rust/pull/39438
5527 [39440]: https://github.com/rust-lang/rust/pull/39440
5528 [39485]: https://github.com/rust-lang/rust/pull/39485
5529 [39491]: https://github.com/rust-lang/rust/pull/39491
5530 [39518]: https://github.com/rust-lang/rust/pull/39518
5531 [39538]: https://github.com/rust-lang/rust/pull/39538
5532 [39572]: https://github.com/rust-lang/rust/pull/39572
5533 [39633]: https://github.com/rust-lang/rust/pull/39633
5534 [39642]: https://github.com/rust-lang/rust/pull/39642
5535 [39728]: https://github.com/rust-lang/rust/pull/39728
5536 [39761]: https://github.com/rust-lang/rust/pull/39761
5537 [39788]: https://github.com/rust-lang/rust/pull/39788
5538 [39793]: https://github.com/rust-lang/rust/pull/39793
5539 [39837]: https://github.com/rust-lang/rust/pull/39837
5540 [39843]: https://github.com/rust-lang/rust/pull/39843
5541 [39851]: https://github.com/rust-lang/rust/pull/39851
5542 [39903]: https://github.com/rust-lang/rust/pull/39903
5543 [39939]: https://github.com/rust-lang/rust/pull/39939
5544 [39953]: https://github.com/rust-lang/rust/pull/39953
5545 [39960]: https://github.com/rust-lang/rust/pull/39960
5546 [39990]: https://github.com/rust-lang/rust/pull/39990
5547 [39995]: https://github.com/rust-lang/rust/pull/39995
5548 [40008]: https://github.com/rust-lang/rust/pull/40008
5549 [40009]: https://github.com/rust-lang/rust/pull/40009
5550 [40027]: https://github.com/rust-lang/rust/pull/40027
5551 [40028]: https://github.com/rust-lang/rust/pull/40028
5552 [40037]: https://github.com/rust-lang/rust/pull/40037
5553 [40117]: https://github.com/rust-lang/rust/pull/40117
5554 [40166]: https://github.com/rust-lang/rust/pull/40166
5555 [40245]: https://github.com/rust-lang/rust/pull/40245
5556 [40257]: https://github.com/rust-lang/rust/pull/40257
5557 [40261]: https://github.com/rust-lang/rust/pull/40261
5558 [40265]: https://github.com/rust-lang/rust/pull/40265
5559 [40319]: https://github.com/rust-lang/rust/pull/40319
5560 [40336]: https://github.com/rust-lang/rust/pull/40336
5561 [40526]: https://github.com/rust-lang/rust/pull/40526
5562 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5563 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5564 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5565 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5566 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5567 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5568 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5569 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5570 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5571 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5572 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5573 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5574 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5575 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5576 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5577 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5578 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5579 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5580 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5581 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5582 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5583 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5584 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5585 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5586 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5587 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5588 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5589 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5590 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5591 [mdbook]: https://crates.io/crates/mdbook
5592 [ubook]: https://doc.rust-lang.org/unstable-book/
5593
5594
5595 Version 1.16.0 (2017-03-16)
5596 ===========================
5597
5598 Language
5599 --------
5600
5601 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5602 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5603   match patterns][38069]
5604 * [Clean up semantics of `self` in an import list][38313]
5605 * [`Self` may appear in `impl` headers][38920]
5606 * [`Self` may appear in struct expressions][39282]
5607
5608 Compiler
5609 --------
5610
5611 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5612   a `.rmeta` file containing only crate metadata][38571]. This can be
5613   used by tools like the Rust Language Service to perform
5614   metadata-only builds.
5615 * [Levenshtein based typo suggestions now work in most places, while
5616   previously they worked only for fields and sometimes for local
5617   variables][38927]. Together with the overhaul of "no
5618   resolution"/"unexpected resolution" errors (#[38154]) they result in
5619   large and systematic improvement in resolution diagnostics.
5620 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5621   `U`][38670]
5622 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5623 * [`rustc` no longer attempts to provide "consider using an explicit
5624   lifetime" suggestions][37057]. They were inaccurate.
5625
5626 Stabilized APIs
5627 ---------------
5628
5629 * [`VecDeque::truncate`]
5630 * [`VecDeque::resize`]
5631 * [`String::insert_str`]
5632 * [`Duration::checked_add`]
5633 * [`Duration::checked_sub`]
5634 * [`Duration::checked_div`]
5635 * [`Duration::checked_mul`]
5636 * [`str::replacen`]
5637 * [`str::repeat`]
5638 * [`SocketAddr::is_ipv4`]
5639 * [`SocketAddr::is_ipv6`]
5640 * [`IpAddr::is_ipv4`]
5641 * [`IpAddr::is_ipv6`]
5642 * [`Vec::dedup_by`]
5643 * [`Vec::dedup_by_key`]
5644 * [`Result::unwrap_or_default`]
5645 * [`<*const T>::wrapping_offset`]
5646 * [`<*mut T>::wrapping_offset`]
5647 * `CommandExt::creation_flags`
5648 * [`File::set_permissions`]
5649 * [`String::split_off`]
5650
5651 Libraries
5652 ---------
5653
5654 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5655   their argument by `Borrow` parameter][37761]
5656 * [All public types in std implement `Debug`][38006]
5657 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5658 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5659 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5660   Windows][38274]
5661 * [std: Fix partial writes in `LineWriter`][38062]
5662 * [std: Clamp max read/write sizes on Unix][38062]
5663 * [Use more specific panic message for `&str` slicing errors][38066]
5664 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5665   functionality cannot be achieved in std currently.
5666 * [`writeln!`, like `println!`, now accepts a form with no string
5667   or formatting arguments, to just print a newline][38469]
5668 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5669 * [Reduce the size of static data in `std_unicode::tables`][38781]
5670 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5671   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5672   `Display`][38909]
5673 * [`Duration` implements `Sum`][38712]
5674 * [`String` implements `ToSocketAddrs`][39048]
5675
5676 Cargo
5677 -----
5678
5679 * [The `cargo check` command does a type check of a project without
5680   building it][cargo/3296]
5681 * [crates.io will display CI badges from Travis and AppVeyor, if
5682   specified in Cargo.toml][cargo/3546]
5683 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5684 * [Compilation profiles accept integer values for `debug`, in addition
5685   to `true` and `false`. These are passed to `rustc` as the value to
5686   `-C debuginfo`][cargo/3534]
5687 * [Implement `cargo --version --verbose`][cargo/3604]
5688 * [All builds now output 'dep-info' build dependencies compatible with
5689   make and ninja][cargo/3557]
5690 * [Build all workspace members with `build --all`][cargo/3511]
5691 * [Document all workspace members with `doc --all`][cargo/3515]
5692 * [Path deps outside workspace are not members][cargo/3443]
5693
5694 Misc
5695 ----
5696
5697 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5698   the path to the Rust implementation][38589]
5699 * [The `armv7-linux-androideabi` target no longer enables NEON
5700   extensions, per Google's ABI guide][38413]
5701 * [The stock standard library can be compiled for Redox OS][38401]
5702 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5703   available.
5704 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5705   builds available.
5706 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5707
5708 Compatibility Notes
5709 -------------------
5710
5711 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5712   match patterns][38069]
5713 * In this release, references to uninhabited types can not be
5714   pattern-matched. This was accidentally allowed in 1.15.
5715 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5716 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5717   Windows][38274]
5718 * [Clean up semantics of `self` in an import list][38313]
5719 * Reimplemented lifetime elision. This change was almost entirely compatible
5720   with existing code, but it did close a number of small bugs and loopholes,
5721   as well as being more accepting in some other [cases][41105].
5722
5723 [37057]: https://github.com/rust-lang/rust/pull/37057
5724 [37761]: https://github.com/rust-lang/rust/pull/37761
5725 [38006]: https://github.com/rust-lang/rust/pull/38006
5726 [38051]: https://github.com/rust-lang/rust/pull/38051
5727 [38062]: https://github.com/rust-lang/rust/pull/38062
5728 [38062]: https://github.com/rust-lang/rust/pull/38622
5729 [38066]: https://github.com/rust-lang/rust/pull/38066
5730 [38069]: https://github.com/rust-lang/rust/pull/38069
5731 [38131]: https://github.com/rust-lang/rust/pull/38131
5732 [38154]: https://github.com/rust-lang/rust/pull/38154
5733 [38274]: https://github.com/rust-lang/rust/pull/38274
5734 [38304]: https://github.com/rust-lang/rust/pull/38304
5735 [38313]: https://github.com/rust-lang/rust/pull/38313
5736 [38314]: https://github.com/rust-lang/rust/pull/38314
5737 [38327]: https://github.com/rust-lang/rust/pull/38327
5738 [38401]: https://github.com/rust-lang/rust/pull/38401
5739 [38413]: https://github.com/rust-lang/rust/pull/38413
5740 [38469]: https://github.com/rust-lang/rust/pull/38469
5741 [38559]: https://github.com/rust-lang/rust/pull/38559
5742 [38571]: https://github.com/rust-lang/rust/pull/38571
5743 [38580]: https://github.com/rust-lang/rust/pull/38580
5744 [38589]: https://github.com/rust-lang/rust/pull/38589
5745 [38670]: https://github.com/rust-lang/rust/pull/38670
5746 [38712]: https://github.com/rust-lang/rust/pull/38712
5747 [38726]: https://github.com/rust-lang/rust/pull/38726
5748 [38781]: https://github.com/rust-lang/rust/pull/38781
5749 [38798]: https://github.com/rust-lang/rust/pull/38798
5750 [38909]: https://github.com/rust-lang/rust/pull/38909
5751 [38920]: https://github.com/rust-lang/rust/pull/38920
5752 [38927]: https://github.com/rust-lang/rust/pull/38927
5753 [39048]: https://github.com/rust-lang/rust/pull/39048
5754 [39282]: https://github.com/rust-lang/rust/pull/39282
5755 [39379]: https://github.com/rust-lang/rust/pull/39379
5756 [41105]: https://github.com/rust-lang/rust/issues/41105
5757 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5758 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5759 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5760 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5761 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5762 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5763 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5764 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5765 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5766 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5767 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5768 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5769 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5770 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5771 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5772 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5773 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5774 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5775 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5776 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5777 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5778 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5779 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5780 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5781 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5782 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5783 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5784 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5785 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5786 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5787
5788
5789 Version 1.15.1 (2017-02-09)
5790 ===========================
5791
5792 * [Fix IntoIter::as_mut_slice's signature][39466]
5793 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5794
5795 [39466]: https://github.com/rust-lang/rust/pull/39466
5796 [39523]: https://github.com/rust-lang/rust/pull/39523
5797
5798
5799 Version 1.15.0 (2017-02-02)
5800 ===========================
5801
5802 Language
5803 --------
5804
5805 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5806   stable. This allows popular code-generating crates like Serde and Diesel to
5807   work ergonomically. [RFC 1681].
5808 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5809   with curly braces][36868]. Part of [RFC 1506].
5810 * [A number of minor changes to name resolution have been activated][37127].
5811   They add up to more consistent semantics, allowing for future evolution of
5812   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5813   details of what is different. The breaking changes here have been transitioned
5814   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5815 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5816   bounds][38279]
5817 * [`?Sized` can be used in `where` clauses][37791]
5818 * [There is now a limit on the size of monomorphized types and it can be
5819   modified with the `#![type_size_limit]` crate attribute, similarly to
5820   the `#![recursion_limit]` attribute][37789]
5821
5822 Compiler
5823 --------
5824
5825 * [On Windows, the compiler will apply dllimport attributes when linking to
5826   extern functions][37973]. Additional attributes and flags can control which
5827   library kind is linked and its name. [RFC 1717].
5828 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5829 * [The `--test` flag works with procedural macro crates][38107]
5830 * [Fix `extern "aapcs" fn` ABI][37814]
5831 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5832 * [The `format!` expander recognizes incorrect `printf` and shell-style
5833   formatting directives and suggests the correct format][37613].
5834 * [Only report one error for all unused imports in an import list][37456]
5835
5836 Compiler Performance
5837 --------------------
5838
5839 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5840 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5841 * [Don't clone in `UnificationTable::probe`][37848]
5842 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5843 * [Use small vectors in type walker][37760]
5844 * [Macro expansion performance was improved][37701]
5845 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5846 * [Replace FNV with a faster hash function][37229]
5847
5848 Stabilized APIs
5849 ---------------
5850
5851 * [`std::iter::Iterator::min_by`]
5852 * [`std::iter::Iterator::max_by`]
5853 * [`std::os::*::fs::FileExt`]
5854 * [`std::sync::atomic::Atomic*::get_mut`]
5855 * [`std::sync::atomic::Atomic*::into_inner`]
5856 * [`std::vec::IntoIter::as_slice`]
5857 * [`std::vec::IntoIter::as_mut_slice`]
5858 * [`std::sync::mpsc::Receiver::try_iter`]
5859 * [`std::os::unix::process::CommandExt::before_exec`]
5860 * [`std::rc::Rc::strong_count`]
5861 * [`std::rc::Rc::weak_count`]
5862 * [`std::sync::Arc::strong_count`]
5863 * [`std::sync::Arc::weak_count`]
5864 * [`std::char::encode_utf8`]
5865 * [`std::char::encode_utf16`]
5866 * [`std::cell::Ref::clone`]
5867 * [`std::io::Take::into_inner`]
5868
5869 Libraries
5870 ---------
5871
5872 * [The standard sorting algorithm has been rewritten for dramatic performance
5873   improvements][38192]. It is a hybrid merge sort, drawing influences from
5874   Timsort. Previously it was a naive merge sort.
5875 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5876 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5877   performance.
5878 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5879   and `char_indices().last()`][37882]
5880 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5881 * [Chinese characters display correctly in `fmt::Debug`][37855]
5882 * [Derive `Default` for `Duration`][37699]
5883 * [Support creation of anonymous pipes on WinXP/2k][37677]
5884 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5885 * [Don't pass overlapped handles to processes][38835]
5886
5887 Cargo
5888 -----
5889
5890 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5891   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5892   should instead check the variable at runtime with `std::env`. That the value
5893   was set at build time was a bug, and incorrect when cross-compiling. This
5894   change is known to cause breakage.
5895 * [Add `--all` flag to `cargo test`][cargo/3221]
5896 * [Compile statically against the MSVC CRT][cargo/3363]
5897 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5898 * [Link OpenSSL statically on OSX][cargo/3311]
5899 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5900 * [Test for bad path overrides with summaries][cargo/3336]
5901 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5902 * [Fix retrying crate downloads for network errors][cargo/3348]
5903 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5904 * [Emit more info on --message-format=json][cargo/3319]
5905 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5906 * [Don't ignore errors in workspace manifest][cargo/3409]
5907 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5908
5909 Tooling
5910 -------
5911
5912 * [Test runners (binaries built with `--test`) now support a `--list` argument
5913   that lists the tests it contains][38185]
5914 * [Test runners now support a `--exact` argument that makes the test filter
5915   match exactly, instead of matching only a substring of the test name][38181]
5916 * [rustdoc supports a `--playground-url` flag][37763]
5917 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5918
5919 Misc
5920 ----
5921
5922 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5923   continue to be used in this release by passing `--disable-rustbuild` to the
5924   configure script, but they will be deleted soon. Note that the new build
5925   system uses a different on-disk layout that will likely affect any scripts
5926   building Rust.
5927 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5928   releases.
5929 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5930 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5931   releases.
5932
5933 Compatibility Notes
5934 -------------------
5935
5936 * [A number of minor changes to name resolution have been activated][37127].
5937   They add up to more consistent semantics, allowing for future evolution of
5938   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5939   details of what is different. The breaking changes here have been transitioned
5940   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5941 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5942   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5943   should instead check the variable at runtime with `std::env`. That the value
5944   was set at build time was a bug, and incorrect when cross-compiling. This
5945   change is known to cause breakage.
5946 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5947   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5948   1.10 and is now an error by default. It will become a hard error in the near
5949   future.
5950 * [The semantics relating modules to file system directories are changing in
5951   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5952   lint, which is a warning in this release, and will become a hard error in the
5953   future.
5954 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5955 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5956   the underlying iterator][37834]
5957
5958 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5959 [33685]: https://github.com/rust-lang/rust/issues/33685
5960 [36868]: https://github.com/rust-lang/rust/pull/36868
5961 [37127]: https://github.com/rust-lang/rust/pull/37127
5962 [37229]: https://github.com/rust-lang/rust/pull/37229
5963 [37456]: https://github.com/rust-lang/rust/pull/37456
5964 [37527]: https://github.com/rust-lang/rust/pull/37527
5965 [37602]: https://github.com/rust-lang/rust/pull/37602
5966 [37613]: https://github.com/rust-lang/rust/pull/37613
5967 [37615]: https://github.com/rust-lang/rust/pull/37615
5968 [37636]: https://github.com/rust-lang/rust/pull/37636
5969 [37627]: https://github.com/rust-lang/rust/pull/37627
5970 [37642]: https://github.com/rust-lang/rust/pull/37642
5971 [37677]: https://github.com/rust-lang/rust/pull/37677
5972 [37699]: https://github.com/rust-lang/rust/pull/37699
5973 [37701]: https://github.com/rust-lang/rust/pull/37701
5974 [37705]: https://github.com/rust-lang/rust/pull/37705
5975 [37749]: https://github.com/rust-lang/rust/pull/37749
5976 [37760]: https://github.com/rust-lang/rust/pull/37760
5977 [37763]: https://github.com/rust-lang/rust/pull/37763
5978 [37764]: https://github.com/rust-lang/rust/pull/37764
5979 [37789]: https://github.com/rust-lang/rust/pull/37789
5980 [37791]: https://github.com/rust-lang/rust/pull/37791
5981 [37814]: https://github.com/rust-lang/rust/pull/37814
5982 [37817]: https://github.com/rust-lang/rust/pull/37817
5983 [37834]: https://github.com/rust-lang/rust/pull/37834
5984 [37848]: https://github.com/rust-lang/rust/pull/37848
5985 [37855]: https://github.com/rust-lang/rust/pull/37855
5986 [37882]: https://github.com/rust-lang/rust/pull/37882
5987 [37888]: https://github.com/rust-lang/rust/pull/37888
5988 [37973]: https://github.com/rust-lang/rust/pull/37973
5989 [37979]: https://github.com/rust-lang/rust/pull/37979
5990 [38086]: https://github.com/rust-lang/rust/pull/38086
5991 [38107]: https://github.com/rust-lang/rust/pull/38107
5992 [38117]: https://github.com/rust-lang/rust/pull/38117
5993 [38134]: https://github.com/rust-lang/rust/pull/38134
5994 [38146]: https://github.com/rust-lang/rust/pull/38146
5995 [38181]: https://github.com/rust-lang/rust/pull/38181
5996 [38182]: https://github.com/rust-lang/rust/pull/38182
5997 [38185]: https://github.com/rust-lang/rust/pull/38185
5998 [38192]: https://github.com/rust-lang/rust/pull/38192
5999 [38279]: https://github.com/rust-lang/rust/pull/38279
6000 [38835]: https://github.com/rust-lang/rust/pull/38835
6001 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6002 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6003 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
6004 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
6005 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
6006 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
6007 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
6008 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
6009 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
6010 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
6011 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
6012 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
6013 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
6014 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
6015 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
6016 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
6017 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
6018 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
6019 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
6020 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
6021 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
6022 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
6023 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
6024 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
6025 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
6026 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
6027 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
6028 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
6029 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
6030 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
6031 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
6032 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
6033 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
6034 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
6035 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
6036 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
6037 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
6038 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
6039
6040
6041 Version 1.14.0 (2016-12-22)
6042 ===========================
6043
6044 Language
6045 --------
6046
6047 * [`..` matches multiple tuple fields in enum variants, structs
6048   and tuples][36843]. [RFC 1492].
6049 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
6050 * [`use *` and `use ::*` both glob-import from the crate root][37367]
6051 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
6052   dereferencing][36822]
6053
6054 Compiler
6055 --------
6056
6057 * [Mark enums with non-zero discriminant as non-zero][37224]
6058 * [Lower-case `static mut` names are linted like other
6059   statics and consts][37162]
6060 * [Fix ICE on some macros in const integer positions
6061    (e.g. `[u8; m!()]`)][36819]
6062 * [Improve error message and snippet for "did you mean `x`"][36798]
6063 * [Add a panic-strategy field to the target specification][36794]
6064 * [Include LLVM version in `--version --verbose`][37200]
6065
6066 Compile-time Optimizations
6067 --------------------------
6068
6069 * [Improve macro expansion performance][37569]
6070 * [Shrink `Expr_::ExprInlineAsm`][37445]
6071 * [Replace all uses of SHA-256 with BLAKE2b][37439]
6072 * [Reduce the number of bytes hashed by `IchHasher`][37427]
6073 * [Avoid more allocations when compiling html5ever][37373]
6074 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
6075 * [Avoid some allocations in the macro parser][37318]
6076 * [Use a faster deflate setting][37298]
6077 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
6078   during interning of slices][37270]
6079 * [Optimize `write_metadata`][37267]
6080 * [Don't process obligation forest cycles when stalled][37231]
6081 * [Avoid many `CrateConfig` clones][37161]
6082 * [Optimize `Substs::super_fold_with`][37108]
6083 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
6084 * [Speed up `plug_leaks`][36917]
6085
6086 Libraries
6087 ---------
6088
6089 * [`println!()`, with no arguments, prints newline][36825].
6090   Previously, an empty string was required to achieve the same.
6091 * [`Wrapping` impls standard binary and unary operators, as well as
6092    the `Sum` and `Product` iterators][37356]
6093 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
6094   Vec<T>`][37326]
6095 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
6096   `VecDeque` iterators][37315]
6097 * [Improve `SipHasher` performance on small values][37312]
6098 * [Add Iterator trait TrustedLen to enable better FromIterator /
6099   Extend][37306]
6100 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
6101 * [`ReadDir` implements `Debug`][37221]
6102 * [Implement `RefUnwindSafe` for atomic types][37178]
6103 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
6104 * [Avoid allocations in `Decoder::read_str`][37064]
6105 * [`io::Error` implements `From<io::ErrorKind>`][37037]
6106 * [Impl `Debug` for raw pointers to unsized data][36880]
6107 * [Don't reuse `HashMap` random seeds][37470]
6108 * [The internal memory layout of `HashMap` is more cache-friendly, for
6109   significant improvements in some operations][36692]
6110 * [`HashMap` uses less memory on 32-bit architectures][36595]
6111 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
6112
6113 Cargo
6114 -----
6115
6116 * [Expose rustc cfg values to build scripts][cargo/3243]
6117 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
6118 * [Fix passing --features when testing multiple packages][cargo/3280]
6119 * [Use a single profile set per workspace][cargo/3249]
6120 * [Load `replace` sections from lock files][cargo/3220]
6121 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
6122
6123 Tooling
6124 -------
6125
6126 * [rustup is the recommended Rust installation method][1.14rustup]
6127 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
6128   S390x. These are [tier 2] platforms and may have major defects. Follow the
6129   instructions on the website to install, or add the targets to an existing
6130   installation with `rustup target add`. The new target triples are:
6131   - `mips-unknown-linux-gnu`
6132   - `mipsel-unknown-linux-gnu`
6133   - `mips64-unknown-linux-gnuabi64`
6134   - `mips64el-unknown-linux-gnuabi64 `
6135   - `powerpc-unknown-linux-gnu`
6136   - `powerpc64-unknown-linux-gnu`
6137   - `powerpc64le-unknown-linux-gnu`
6138   - `s390x-unknown-linux-gnu `
6139 * This release includes target (std) builds for ARM Linux running MUSL
6140   libc. These are [tier 2] platforms and may have major defects. Add the
6141   following triples to an existing rustup installation with `rustup target add`:
6142   - `arm-unknown-linux-musleabi`
6143   - `arm-unknown-linux-musleabihf`
6144   - `armv7-unknown-linux-musleabihf`
6145 * This release includes [experimental support for WebAssembly][1.14wasm], via
6146   the `wasm32-unknown-emscripten` target. This target is known to have major
6147   defects. Please test, report, and fix.
6148 * rustup no longer installs documentation by default. Run `rustup
6149   component add rust-docs` to install.
6150 * [Fix line stepping in debugger][37310]
6151 * [Enable line number debuginfo in releases][37280]
6152
6153 Misc
6154 ----
6155
6156 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6157 * [Add support for Fuchsia OS][37313]
6158 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6159
6160 Compatibility Notes
6161 -------------------
6162
6163 * [A number of forward-compatibility lints used by the compiler
6164   to gradually introduce language changes have been converted
6165   to deny by default][36894]:
6166   - ["use of inaccessible extern crate erroneously allowed"][36886]
6167   - ["type parameter default erroneously allowed in invalid location"][36887]
6168   - ["detects super or self keywords at the beginning of global path"][36888]
6169   - ["two overlapping inherent impls define an item with the same name
6170     were erroneously allowed"][36889]
6171   - ["floating-point constants cannot be used in patterns"][36890]
6172   - ["constants of struct or enum type can only be used in a pattern if
6173      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6174   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6175 * [Prohibit patterns in trait methods without bodies][37378]
6176 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6177 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6178 * [The `$crate` macro variable is accepted in fewer locations][37213]
6179 * [Impls specifying extra region requirements beyond the trait
6180   they implement are rejected][37167]
6181 * [Enums may not be unsized][37111]. Unsized enums are intended to
6182   work but never have. For now they are forbidden.
6183 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6184
6185 [tier 2]: https://forge.rust-lang.org/platform-support.html
6186 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6187 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6188 [36430]: https://github.com/rust-lang/rust/pull/36430
6189 [36595]: https://github.com/rust-lang/rust/pull/36595
6190 [36595]: https://github.com/rust-lang/rust/pull/36595
6191 [36692]: https://github.com/rust-lang/rust/pull/36692
6192 [36767]: https://github.com/rust-lang/rust/pull/36767
6193 [36794]: https://github.com/rust-lang/rust/pull/36794
6194 [36798]: https://github.com/rust-lang/rust/pull/36798
6195 [36819]: https://github.com/rust-lang/rust/pull/36819
6196 [36822]: https://github.com/rust-lang/rust/pull/36822
6197 [36825]: https://github.com/rust-lang/rust/pull/36825
6198 [36843]: https://github.com/rust-lang/rust/pull/36843
6199 [36880]: https://github.com/rust-lang/rust/pull/36880
6200 [36886]: https://github.com/rust-lang/rust/issues/36886
6201 [36887]: https://github.com/rust-lang/rust/issues/36887
6202 [36888]: https://github.com/rust-lang/rust/issues/36888
6203 [36889]: https://github.com/rust-lang/rust/issues/36889
6204 [36890]: https://github.com/rust-lang/rust/issues/36890
6205 [36891]: https://github.com/rust-lang/rust/issues/36891
6206 [36892]: https://github.com/rust-lang/rust/issues/36892
6207 [36894]: https://github.com/rust-lang/rust/pull/36894
6208 [36917]: https://github.com/rust-lang/rust/pull/36917
6209 [36993]: https://github.com/rust-lang/rust/pull/36993
6210 [37037]: https://github.com/rust-lang/rust/pull/37037
6211 [37064]: https://github.com/rust-lang/rust/pull/37064
6212 [37094]: https://github.com/rust-lang/rust/pull/37094
6213 [37108]: https://github.com/rust-lang/rust/pull/37108
6214 [37111]: https://github.com/rust-lang/rust/pull/37111
6215 [37161]: https://github.com/rust-lang/rust/pull/37161
6216 [37162]: https://github.com/rust-lang/rust/pull/37162
6217 [37167]: https://github.com/rust-lang/rust/pull/37167
6218 [37178]: https://github.com/rust-lang/rust/pull/37178
6219 [37200]: https://github.com/rust-lang/rust/pull/37200
6220 [37213]: https://github.com/rust-lang/rust/pull/37213
6221 [37221]: https://github.com/rust-lang/rust/pull/37221
6222 [37224]: https://github.com/rust-lang/rust/pull/37224
6223 [37230]: https://github.com/rust-lang/rust/pull/37230
6224 [37231]: https://github.com/rust-lang/rust/pull/37231
6225 [37247]: https://github.com/rust-lang/rust/pull/37247
6226 [37267]: https://github.com/rust-lang/rust/pull/37267
6227 [37270]: https://github.com/rust-lang/rust/pull/37270
6228 [37273]: https://github.com/rust-lang/rust/pull/37273
6229 [37280]: https://github.com/rust-lang/rust/pull/37280
6230 [37298]: https://github.com/rust-lang/rust/pull/37298
6231 [37306]: https://github.com/rust-lang/rust/pull/37306
6232 [37310]: https://github.com/rust-lang/rust/pull/37310
6233 [37312]: https://github.com/rust-lang/rust/pull/37312
6234 [37313]: https://github.com/rust-lang/rust/pull/37313
6235 [37315]: https://github.com/rust-lang/rust/pull/37315
6236 [37318]: https://github.com/rust-lang/rust/pull/37318
6237 [37322]: https://github.com/rust-lang/rust/pull/37322
6238 [37326]: https://github.com/rust-lang/rust/pull/37326
6239 [37351]: https://github.com/rust-lang/rust/pull/37351
6240 [37356]: https://github.com/rust-lang/rust/pull/37356
6241 [37367]: https://github.com/rust-lang/rust/pull/37367
6242 [37373]: https://github.com/rust-lang/rust/pull/37373
6243 [37378]: https://github.com/rust-lang/rust/pull/37378
6244 [37389]: https://github.com/rust-lang/rust/pull/37389
6245 [37392]: https://github.com/rust-lang/rust/pull/37392
6246 [37427]: https://github.com/rust-lang/rust/pull/37427
6247 [37439]: https://github.com/rust-lang/rust/pull/37439
6248 [37445]: https://github.com/rust-lang/rust/pull/37445
6249 [37470]: https://github.com/rust-lang/rust/pull/37470
6250 [37569]: https://github.com/rust-lang/rust/pull/37569
6251 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6252 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6253 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6254 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6255 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6256 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6257 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6258
6259
6260 Version 1.13.0 (2016-11-10)
6261 ===========================
6262
6263 Language
6264 --------
6265
6266 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6267   errors, like the `try!` macro, described in [RFC 0243].
6268 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6269 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6270 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6271 * [Fix lifetime rules for 'if' conditions][36029]
6272 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6273
6274 Compiler
6275 --------
6276
6277 * [Add the `-C link-arg` argument][36574]
6278 * [Remove the old AST-based backend from rustc_trans][35764]
6279 * [Don't enable NEON by default on armv7 Linux][35814]
6280 * [Fix debug line number info for macro expansions][35238]
6281 * [Do not emit "class method" debuginfo for types that are not
6282   DICompositeType][36008]
6283 * [Warn about multiple conflicting #[repr] hints][34623]
6284 * [When sizing DST, don't double-count nested struct prefixes][36351]
6285 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6286 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6287 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6288 * [Expand macros without recursing to avoid stack overflows][36214]
6289
6290 Diagnostics
6291 -----------
6292
6293 * [Replace macro backtraces with labeled local uses][35702]
6294 * [Improve error message for misplaced doc comments][33922]
6295 * [Buffer unix and lock windows to prevent message interleaving][35975]
6296 * [Update lifetime errors to specifically note temporaries][36171]
6297 * [Special case a few colors for Windows][36178]
6298 * [Suggest `use self` when such an import resolves][36289]
6299 * [Be more specific when type parameter shadows primitive type][36338]
6300 * Many minor improvements
6301
6302 Compile-time Optimizations
6303 --------------------------
6304
6305 * [Compute and cache HIR hashes at beginning][35854]
6306 * [Don't hash types in loan paths][36004]
6307 * [Cache projections in trans][35761]
6308 * [Optimize the parser's last token handling][36527]
6309 * [Only instantiate #[inline] functions in codegen units referencing
6310   them][36524]. This leads to big improvements in cases where crates export
6311   define many inline functions without using them directly.
6312 * [Lazily allocate TypedArena's first chunk][36592]
6313 * [Don't allocate during default HashSet creation][36734]
6314
6315 Stabilized APIs
6316 ---------------
6317
6318 * [`checked_abs`]
6319 * [`wrapping_abs`]
6320 * [`overflowing_abs`]
6321 * [`RefCell::try_borrow`]
6322 * [`RefCell::try_borrow_mut`]
6323
6324 Libraries
6325 ---------
6326
6327 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6328 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6329   covariant][35354]
6330 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6331 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6332 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6333 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6334 * [Use arc4rand on FreeBSD][35884]
6335 * [memrchr: Correct aligned offset computation][35969]
6336 * [Improve Demangling of Rust Symbols][36059]
6337 * [Use monotonic time in condition variables][35048]
6338 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6339 * [Implement conversion traits for `char`][35755]
6340 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6341 * [Zero first byte of CString on drop][36264]
6342 * [Inherit overflow checks for sum and product][36372]
6343 * [Add missing Eq implementations][36423]
6344 * [Implement `Debug` for `DirEntry`][36631]
6345 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6346   `errno`][36754]
6347 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6348 * [Implement more traits for `std::io::ErrorKind`][35911]
6349 * [Optimize BinaryHeap bounds checking][36072]
6350 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6351   `extend_with_element`][36355]
6352 * [Fix overflow checking in unsigned pow()][34942]
6353
6354 Cargo
6355 -----
6356
6357 * This release includes security fixes to both curl and OpenSSL.
6358 * [Fix transitive doctests when panic=abort][cargo/3021]
6359 * [Add --all-features flag to cargo][cargo/3038]
6360 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6361 * [Don't parse the home directory more than once][cargo/3078]
6362 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6363 * [Update OpenSSL to 1.0.2j][cargo/3121]
6364 * [Add license and license_file to cargo metadata output][cargo/3110]
6365 * [Make crates-io registry URL optional in config; ignore all changes to
6366   source.crates-io][cargo/3089]
6367 * [Don't download dependencies from other platforms][cargo/3123]
6368 * [Build transitive dev-dependencies when needed][cargo/3125]
6369 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6370 * [Avoid updating registry when adding existing deps][cargo/3144]
6371 * [Warn about path overrides that won't work][cargo/3136]
6372 * [Use workspaces during `cargo install`][cargo/3146]
6373 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6374 * [Add --message-format flag][cargo/3000]
6375 * [Pass target environment for rustdoc][cargo/3205]
6376 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6377 * [Update curl and curl-sys][cargo/3241]
6378 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6379
6380 Tooling
6381 -------
6382
6383 * [rustdoc: Add the `--sysroot` argument][36586]
6384 * [rustdoc: Fix a couple of issues with the search results][35655]
6385 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6386 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6387 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6388
6389 Misc
6390 ----
6391
6392 * [Remove unmaintained style guide][35124]
6393 * [Add s390x support][36369]
6394 * [Initial work at Haiku OS support][36727]
6395 * [Add mips-uclibc targets][35734]
6396 * [Crate-ify compiler-rt into compiler-builtins][35021]
6397 * [Add rustc version info (git hash + date) to dist tarball][36213]
6398 * Many documentation improvements
6399
6400 Compatibility Notes
6401 -------------------
6402
6403 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6404 * [Deny (by default) transmuting from fn item types to pointer-sized
6405   types][34923]. Continuing the long transition to zero-sized fn items,
6406   per [RFC 401].
6407 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6408   Part of [RFC 1506].
6409 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6410 * [Fix lifetime rules for 'if' conditions][36029].
6411 * [Inherit overflow checks for sum and product][36372].
6412 * [Forbid user-defined macros named "macro_rules"][36730].
6413
6414 [33922]: https://github.com/rust-lang/rust/pull/33922
6415 [34623]: https://github.com/rust-lang/rust/pull/34623
6416 [34923]: https://github.com/rust-lang/rust/pull/34923
6417 [34942]: https://github.com/rust-lang/rust/pull/34942
6418 [34982]: https://github.com/rust-lang/rust/pull/34982
6419 [35021]: https://github.com/rust-lang/rust/pull/35021
6420 [35048]: https://github.com/rust-lang/rust/pull/35048
6421 [35074]: https://github.com/rust-lang/rust/pull/35074
6422 [35124]: https://github.com/rust-lang/rust/pull/35124
6423 [35234]: https://github.com/rust-lang/rust/pull/35234
6424 [35238]: https://github.com/rust-lang/rust/pull/35238
6425 [35354]: https://github.com/rust-lang/rust/pull/35354
6426 [35559]: https://github.com/rust-lang/rust/pull/35559
6427 [35585]: https://github.com/rust-lang/rust/pull/35585
6428 [35627]: https://github.com/rust-lang/rust/pull/35627
6429 [35655]: https://github.com/rust-lang/rust/pull/35655
6430 [35702]: https://github.com/rust-lang/rust/pull/35702
6431 [35707]: https://github.com/rust-lang/rust/pull/35707
6432 [35728]: https://github.com/rust-lang/rust/pull/35728
6433 [35734]: https://github.com/rust-lang/rust/pull/35734
6434 [35755]: https://github.com/rust-lang/rust/pull/35755
6435 [35761]: https://github.com/rust-lang/rust/pull/35761
6436 [35764]: https://github.com/rust-lang/rust/pull/35764
6437 [35814]: https://github.com/rust-lang/rust/pull/35814
6438 [35854]: https://github.com/rust-lang/rust/pull/35854
6439 [35871]: https://github.com/rust-lang/rust/pull/35871
6440 [35884]: https://github.com/rust-lang/rust/pull/35884
6441 [35911]: https://github.com/rust-lang/rust/pull/35911
6442 [35969]: https://github.com/rust-lang/rust/pull/35969
6443 [35975]: https://github.com/rust-lang/rust/pull/35975
6444 [36004]: https://github.com/rust-lang/rust/pull/36004
6445 [36008]: https://github.com/rust-lang/rust/pull/36008
6446 [36014]: https://github.com/rust-lang/rust/pull/36014
6447 [36029]: https://github.com/rust-lang/rust/pull/36029
6448 [36059]: https://github.com/rust-lang/rust/pull/36059
6449 [36072]: https://github.com/rust-lang/rust/pull/36072
6450 [36101]: https://github.com/rust-lang/rust/pull/36101
6451 [36104]: https://github.com/rust-lang/rust/pull/36104
6452 [36171]: https://github.com/rust-lang/rust/pull/36171
6453 [36173]: https://github.com/rust-lang/rust/pull/36173
6454 [36178]: https://github.com/rust-lang/rust/pull/36178
6455 [36213]: https://github.com/rust-lang/rust/pull/36213
6456 [36214]: https://github.com/rust-lang/rust/pull/36214
6457 [36264]: https://github.com/rust-lang/rust/pull/36264
6458 [36266]: https://github.com/rust-lang/rust/pull/36266
6459 [36289]: https://github.com/rust-lang/rust/pull/36289
6460 [36338]: https://github.com/rust-lang/rust/pull/36338
6461 [36351]: https://github.com/rust-lang/rust/pull/36351
6462 [36355]: https://github.com/rust-lang/rust/pull/36355
6463 [36369]: https://github.com/rust-lang/rust/pull/36369
6464 [36372]: https://github.com/rust-lang/rust/pull/36372
6465 [36423]: https://github.com/rust-lang/rust/pull/36423
6466 [36482]: https://github.com/rust-lang/rust/pull/36482
6467 [36505]: https://github.com/rust-lang/rust/pull/36505
6468 [36524]: https://github.com/rust-lang/rust/pull/36524
6469 [36527]: https://github.com/rust-lang/rust/pull/36527
6470 [36551]: https://github.com/rust-lang/rust/pull/36551
6471 [36574]: https://github.com/rust-lang/rust/pull/36574
6472 [36586]: https://github.com/rust-lang/rust/pull/36586
6473 [36592]: https://github.com/rust-lang/rust/pull/36592
6474 [36631]: https://github.com/rust-lang/rust/pull/36631
6475 [36639]: https://github.com/rust-lang/rust/pull/36639
6476 [36721]: https://github.com/rust-lang/rust/pull/36721
6477 [36727]: https://github.com/rust-lang/rust/pull/36727
6478 [36730]: https://github.com/rust-lang/rust/pull/36730
6479 [36734]: https://github.com/rust-lang/rust/pull/36734
6480 [36754]: https://github.com/rust-lang/rust/pull/36754
6481 [36995]: https://github.com/rust-lang/rust/pull/36995
6482 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6483 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6484 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6485 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6486 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6487 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6488 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6489 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6490 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6491 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6492 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6493 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6494 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6495 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6496 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6497 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6498 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6499 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6500 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6501 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6502 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6503 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6504 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6505 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6506 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6507 [rustup]: https://www.rustup.rs
6508 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6509 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6510 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6511 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6512 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6513 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6514 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6515
6516
6517 Version 1.12.1 (2016-10-20)
6518 ===========================
6519
6520 Regression Fixes
6521 ----------------
6522
6523 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6524 * [Confusion with double negation and booleans][36856]
6525 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6526 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6527 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6528 * [Corrupted memory after updated to 1.12][36936]
6529 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6530 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6531 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6532
6533 [36381]: https://github.com/rust-lang/rust/issues/36381
6534 [36856]: https://github.com/rust-lang/rust/issues/36856
6535 [36875]: https://github.com/rust-lang/rust/issues/36875
6536 [36924]: https://github.com/rust-lang/rust/issues/36924
6537 [36926]: https://github.com/rust-lang/rust/issues/36926
6538 [36936]: https://github.com/rust-lang/rust/issues/36936
6539 [37026]: https://github.com/rust-lang/rust/issues/37026
6540 [37112]: https://github.com/rust-lang/rust/issues/37112
6541 [37153]: https://github.com/rust-lang/rust/issues/37153
6542
6543
6544 Version 1.12.0 (2016-09-29)
6545 ===========================
6546
6547 Highlights
6548 ----------
6549
6550 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6551   This translation pass is far simpler than the previous AST->LLVM pass, and
6552   creates opportunities to perform new optimizations directly on the MIR. It
6553   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6554 * [`rustc` presents a new, more readable error format, along with
6555   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6556   Most common editors supporting Rust have been updated to work with it. It was
6557   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6558
6559 Compiler
6560 --------
6561
6562 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6563   This translation pass is far simpler than the previous AST->LLVM pass, and
6564   creates opportunities to perform new optimizations directly on the MIR. It
6565   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6566 * [Print the Rust target name, not the LLVM target name, with
6567   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6568 * [The computation of `TypeId` is correct in some cases where it was previously
6569   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6570 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6571 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6572   `--print relocation-models`, and `--print code-models` print the available
6573   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6574   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6575 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6576   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6577   These targets produce statically-linked binaries. There are no binary release
6578   builds yet though.
6579
6580 Diagnostics
6581 -----------
6582
6583 * [`rustc` presents a new, more readable error format, along with
6584   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6585   Most common editors supporting Rust have been updated to work with it. It was
6586   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6587 * [In error descriptions, references are now described in plain English,
6588   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6589 * [In error type descriptions, unknown numeric types are named `{integer}` or
6590   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6591 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6592
6593 Language
6594 --------
6595
6596 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6597 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6598 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6599   useful](https://github.com/rust-lang/rust/pull/34908)
6600 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6601   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6602 * [Semicolons are properly required as statement delimiters inside
6603   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6604 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6605
6606 Stabilized APIs
6607 ---------------
6608
6609 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6610 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6611 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6612 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6613 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6614 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6615 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6616 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6617 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6618 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6619   Both on Unix and Windows.
6620 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6621 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6622 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6623 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6624 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6625 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6626 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6627 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6628
6629 Libraries
6630 ---------
6631
6632 * [The `format!` macro and friends now allow a single argument to be formatted
6633   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6634 * [The lifetime bounds on `[T]::binary_search_by` and
6635   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6636 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6637 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6638 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6639 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6640 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6641 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6642 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6643 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6644   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6645 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6646   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6647 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6648 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6649   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6650 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6651 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6652 * [`mpsc::sync_channel` `Receiver`s return any available message before
6653   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6654 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6655 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6656
6657 Cargo
6658 -----
6659
6660 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6661 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6662 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6663 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6664 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6665 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6666 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6667 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6668 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6669 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6670 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6671 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6672 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6673 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6674 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6675 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6676
6677 Performance
6678 -----------
6679
6680 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6681 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6682
6683 Tooling
6684 -------
6685
6686 * [Test binaries now support a `--test-threads` argument to specify the number
6687   of threads used to run tests, and which acts the same as the
6688   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6689 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6690 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6691 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6692 * [Rust releases now come with source packages that can be installed by rustup
6693   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6694   The resulting source code can be used by tools and IDES, located in the
6695   sysroot under `lib/rustlib/src`.
6696
6697 Misc
6698 ----
6699
6700 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6701 * Many minor improvements to the documentation.
6702 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6703
6704 Compatibility Notes
6705 -------------------
6706
6707 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6708   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6709 * [When formatting strings, if "precision" is specified, the "fill",
6710   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6711 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6712
6713
6714 Version 1.11.0 (2016-08-18)
6715 ===========================
6716
6717 Language
6718 --------
6719
6720 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6721 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6722 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6723 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6724
6725 Stabilized APIs
6726 ---------------
6727
6728 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6729 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6730 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6731 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6732 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6733 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6734   (in libcore - previously stabilized in libstd)
6735 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6736   (in libcore - previously stabilized in libstd)
6737 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6738   (in libcore - previously stabilized in libstd)
6739 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6740   (in libcore - previously stabilized in libstd)
6741 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6742 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6743 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6744 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6745
6746 Libraries
6747 ---------
6748
6749 * [The `thread_local!` macro supports multiple definitions in a single
6750    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6751 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6752 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6753   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6754 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6755 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6756 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6757 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6758
6759 Cargo
6760 -----
6761
6762 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6763 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6764 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6765 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6766 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6767   and `-vv` prints warnings for all crates.
6768 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6769 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6770   This provides room for expansion by arbitrary tools.
6771 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6772 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6773 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6774 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6775 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6776 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6777 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6778
6779 Performance
6780 -----------
6781
6782 * [Caching projections speeds up type check dramatically for some
6783   workloads](https://github.com/rust-lang/rust/pull/33816)
6784 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6785   This hasher is faster, but is believed to provide sufficient
6786   protection from collision attacks.
6787 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6788
6789 Rustdoc
6790 -------
6791
6792 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6793 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6794 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6795 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6796 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6797
6798 Tooling
6799 -------
6800
6801 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6802 * [When emitting debug info, rustc emits frame pointers for closures,
6803   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6804 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6805 * Many more errors have been given error codes and extended
6806   explanations
6807 * API documentation continues to be improved, with many new examples
6808
6809 Misc
6810 ----
6811
6812 * [rustc no longer hangs when dependencies recursively re-export
6813   submodules](https://github.com/rust-lang/rust/pull/34542)
6814 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6815 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6816   rewritten](https://github.com/rust-lang/rust/pull/33895)
6817 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6818   No targets use this yet, but it works toward AVR support.
6819
6820 Compatibility Notes
6821 -------------------
6822
6823 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6824 * [The new follow-set rules that place restrictions on `macro_rules!`
6825   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6826   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6827   and has been a warning since 1.10.
6828 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6829   This causes breakage in some corner cases.
6830
6831
6832 Version 1.10.0 (2016-07-07)
6833 ===========================
6834
6835 Language
6836 --------
6837
6838 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6839   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6840 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6841 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6842 * [`panic!` can be converted to a runtime abort with the
6843   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6844   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6845 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6846   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6847   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6848   Note that Cargo does not yet directly support cdylibs.
6849
6850 Stabilized APIs
6851 ---------------
6852
6853 * `os::windows::fs::OpenOptionsExt::access_mode`
6854 * `os::windows::fs::OpenOptionsExt::share_mode`
6855 * `os::windows::fs::OpenOptionsExt::custom_flags`
6856 * `os::windows::fs::OpenOptionsExt::attributes`
6857 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6858 * `os::unix::fs::OpenOptionsExt::custom_flags`
6859 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6860 * `Default for sync::Weak`
6861 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6862 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6863 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6864 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6865 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6866 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6867 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6868 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6869 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6870 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6871 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6872 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6873 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6874 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6875 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6876 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6877 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6878 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6879 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6880 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6881 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6882 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6883 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6884 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6885 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6886 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6887 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6888 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6889 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6890 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6891 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6892 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6893 * Read/Write/RawFd impls for `UnixStream`
6894 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6895 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6896 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6897 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6898 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6899 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6900 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6901 * RawFd impls for `UnixListener`
6902 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6903 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6904 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6905 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6906 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6907 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6908 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6909 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6910 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6911 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6912 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6913 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6914 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6915 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6916 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6917 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6918 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6919 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6920 * RawFd impls for `UnixDatagram`
6921 * `{BTree,Hash}Map::values_mut`
6922 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6923
6924 Libraries
6925 ---------
6926
6927 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6928   The semantics of this minor method are subtle and probably not what
6929   most people want.
6930 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6931 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6932   will fall back to `/dev/urandom` temporarily to avoid blocking
6933   during early boot](https://github.com/rust-lang/rust/pull/33086).
6934 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6935 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6936 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6937 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6938 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6939 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6940   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6941
6942 Cargo
6943 -----
6944 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6945   This controls the runtime behavior of the `panic!` macro
6946   and can be either "unwind" (the default), or "abort".
6947   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6948 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6949 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6950 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6951   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6952 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6953 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6954 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6955   By default they are retried twice, which can be customized with the
6956   `net.retry` value in `.cargo/config`.
6957 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6958 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6959 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6960 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6961   Makes it possible to install multiple crates in parallel.
6962 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6963 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6964 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6965 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6966 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6967 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6968
6969 Performance
6970 -----------
6971
6972 * [rustc memory usage was reduced by refactoring the context used for
6973   type checking](https://github.com/rust-lang/rust/pull/33425).
6974 * [Speed up creation of `HashMap`s by caching the random keys used
6975   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6976 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6977 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6978 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6979   10x faster than the previous lookup tables.
6980 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6981
6982 Usability
6983 ---------
6984
6985 * Many incremental improvements to documentation and rustdoc.
6986 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6987 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6988 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6989 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6990 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6991 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6992 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6993
6994 Misc
6995 ----
6996
6997 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6998 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6999 * [`std` no longer prints backtraces on platforms where the running
7000   module must be loaded with `env::current_exe`, which can't be relied
7001   on](https://github.com/rust-lang/rust/pull/33554).
7002 * This release includes std binaries for the i586-unknown-linux-gnu,
7003   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
7004   i586 target is for old x86 hardware without SSE2, and the armv7
7005   target is for Android running on modern ARM architectures.
7006 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
7007   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
7008 * [On Unix the runtime aborts by calling `libc::abort` instead of
7009   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
7010 * [Rust is now bootstrapped from the previous release of Rust,
7011   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
7012
7013 Compatibility Notes
7014 -------------------
7015
7016 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
7017 * [`target_env` for Linux ARM targets is just `gnu`, not
7018   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
7019 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
7020 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
7021 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
7022   Affects how macros are parsed.
7023 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
7024 * [Feature-gated attributes on macro-generated macro invocations are
7025   now rejected](https://github.com/rust-lang/rust/pull/32791).
7026 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
7027   This caused some minor changes to type inference.
7028
7029
7030 Version 1.9.0 (2016-05-26)
7031 ==========================
7032
7033 Language
7034 --------
7035
7036 * The `#[deprecated]` attribute when applied to an API will generate
7037   warnings when used. The warnings may be suppressed with
7038   `#[allow(deprecated)]`. [RFC 1270].
7039 * [`fn` item types are zero sized, and each `fn` names a unique
7040   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7041   `transmute` on a `fn` type will generate a warning for a few cycles,
7042   then will be converted to an error.
7043 * [Field and method resolution understand visibility, so private
7044   fields and methods cannot prevent the proper use of public fields
7045   and methods][1.9fv].
7046 * [The parser considers unicode codepoints in the
7047   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
7048
7049 Stabilized APIs
7050 ---------------
7051
7052 * [`std::panic`]
7053 * [`std::panic::catch_unwind`] (renamed from `recover`)
7054 * [`std::panic::resume_unwind`] (renamed from `propagate`)
7055 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
7056 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
7057 * [`str::is_char_boundary`]
7058 * [`<*const T>::as_ref`]
7059 * [`<*mut T>::as_ref`]
7060 * [`<*mut T>::as_mut`]
7061 * [`AsciiExt::make_ascii_uppercase`]
7062 * [`AsciiExt::make_ascii_lowercase`]
7063 * [`char::decode_utf16`]
7064 * [`char::DecodeUtf16`]
7065 * [`char::DecodeUtf16Error`]
7066 * [`char::DecodeUtf16Error::unpaired_surrogate`]
7067 * [`BTreeSet::take`]
7068 * [`BTreeSet::replace`]
7069 * [`BTreeSet::get`]
7070 * [`HashSet::take`]
7071 * [`HashSet::replace`]
7072 * [`HashSet::get`]
7073 * [`OsString::with_capacity`]
7074 * [`OsString::clear`]
7075 * [`OsString::capacity`]
7076 * [`OsString::reserve`]
7077 * [`OsString::reserve_exact`]
7078 * [`OsStr::is_empty`]
7079 * [`OsStr::len`]
7080 * [`std::os::unix::thread`]
7081 * [`RawPthread`]
7082 * [`JoinHandleExt`]
7083 * [`JoinHandleExt::as_pthread_t`]
7084 * [`JoinHandleExt::into_pthread_t`]
7085 * [`HashSet::hasher`]
7086 * [`HashMap::hasher`]
7087 * [`CommandExt::exec`]
7088 * [`File::try_clone`]
7089 * [`SocketAddr::set_ip`]
7090 * [`SocketAddr::set_port`]
7091 * [`SocketAddrV4::set_ip`]
7092 * [`SocketAddrV4::set_port`]
7093 * [`SocketAddrV6::set_ip`]
7094 * [`SocketAddrV6::set_port`]
7095 * [`SocketAddrV6::set_flowinfo`]
7096 * [`SocketAddrV6::set_scope_id`]
7097 * [`slice::copy_from_slice`]
7098 * [`ptr::read_volatile`]
7099 * [`ptr::write_volatile`]
7100 * [`OpenOptions::create_new`]
7101 * [`TcpStream::set_nodelay`]
7102 * [`TcpStream::nodelay`]
7103 * [`TcpStream::set_ttl`]
7104 * [`TcpStream::ttl`]
7105 * [`TcpStream::set_only_v6`]
7106 * [`TcpStream::only_v6`]
7107 * [`TcpStream::take_error`]
7108 * [`TcpStream::set_nonblocking`]
7109 * [`TcpListener::set_ttl`]
7110 * [`TcpListener::ttl`]
7111 * [`TcpListener::set_only_v6`]
7112 * [`TcpListener::only_v6`]
7113 * [`TcpListener::take_error`]
7114 * [`TcpListener::set_nonblocking`]
7115 * [`UdpSocket::set_broadcast`]
7116 * [`UdpSocket::broadcast`]
7117 * [`UdpSocket::set_multicast_loop_v4`]
7118 * [`UdpSocket::multicast_loop_v4`]
7119 * [`UdpSocket::set_multicast_ttl_v4`]
7120 * [`UdpSocket::multicast_ttl_v4`]
7121 * [`UdpSocket::set_multicast_loop_v6`]
7122 * [`UdpSocket::multicast_loop_v6`]
7123 * [`UdpSocket::set_multicast_ttl_v6`]
7124 * [`UdpSocket::multicast_ttl_v6`]
7125 * [`UdpSocket::set_ttl`]
7126 * [`UdpSocket::ttl`]
7127 * [`UdpSocket::set_only_v6`]
7128 * [`UdpSocket::only_v6`]
7129 * [`UdpSocket::join_multicast_v4`]
7130 * [`UdpSocket::join_multicast_v6`]
7131 * [`UdpSocket::leave_multicast_v4`]
7132 * [`UdpSocket::leave_multicast_v6`]
7133 * [`UdpSocket::take_error`]
7134 * [`UdpSocket::connect`]
7135 * [`UdpSocket::send`]
7136 * [`UdpSocket::recv`]
7137 * [`UdpSocket::set_nonblocking`]
7138
7139 Libraries
7140 ---------
7141
7142 * [`std::sync::Once` is poisoned if its initialization function
7143   fails][1.9o].
7144 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7145 * [Most types implement `fmt::Debug`][1.9db].
7146 * [The default buffer size used by `BufReader` and `BufWriter` was
7147   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7148   used by other languages.
7149 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7150   `Duration` additionally implements `*=` and `/=`][1.9ta].
7151 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7152 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7153 * [`Chain` implements `BufRead`][1.9ch].
7154 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7155
7156 Cargo
7157 -----
7158
7159 * [Cargo can now run concurrently][1.9cc].
7160 * [Top-level overrides allow specific revisions of crates to be
7161   overridden through the entire crate graph][1.9ct].  This is intended
7162   to make upgrades easier for large projects, by allowing crates to be
7163   forked temporarily until they've been upgraded and republished.
7164 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7165 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7166   on the commandline][1.9cf]. `rustc` arguments can also be specified
7167   in the `build.rustflags` configuration key.
7168
7169 Performance
7170 -----------
7171
7172 * [The time complexity of comparing variables for equivalence during type
7173   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7174   to major compilation time improvement in some scenarios.
7175 * [`ToString` is specialized for `str`, giving it the same performance
7176   as `to_owned`][1.9ts].
7177 * [Spawning processes with `Command::output` no longer creates extra
7178   threads][1.9sp].
7179 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7180   for C-like enums][1.9cl].
7181
7182 Misc
7183 ----
7184
7185 * [Passing the `--quiet` flag to a test runner will produce
7186   much-abbreviated output][1.9q].
7187 * The Rust Project now publishes std binaries for the
7188   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7189   `i586-pc-windows-msvc` targets.
7190
7191 Compatibility Notes
7192 -------------------
7193
7194 * [`std::sync::Once` is poisoned if its initialization function
7195   fails][1.9o].
7196 * [It is illegal to define methods with the same name in overlapping
7197   inherent `impl` blocks][1.9sn].
7198 * [`fn` item types are zero sized, and each `fn` names a unique
7199   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7200   `transmute` on a `fn` type will generate a warning for a few cycles,
7201   then will be converted to an error.
7202 * [Improvements to const evaluation may trigger new errors when integer
7203   literals are out of range][1.9ce].
7204
7205
7206 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7207 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7208 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7209 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7210 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7211 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7212 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7213 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7214 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7215 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7216 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7217 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7218 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7219 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7220 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7221 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7222 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7223 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7224 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7225 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7226 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7227 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7228 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7229 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7230 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7231 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7232 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7233 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7234 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7235 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7236 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7237 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7238 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7239 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7240 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7241 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7242 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7243 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7244 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7245 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7246 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7247 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7248 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7249 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7250 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7251 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7252 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7253 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7254 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7255 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7256 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7257 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7258 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7259 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7260 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7261 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7262 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7263 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7264 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7265 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7266 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7267 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7268 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7269 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7270 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7271 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7272 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7273 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7274 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7275 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7276 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7277 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7278 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7279 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7280 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7281 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7282 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7283 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7284 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7285 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7286 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7287 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7288 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7289 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7290 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7291 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7292 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7293 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7294 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7295 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7296 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7297 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7298 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7299 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7300 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7301 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7302 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7303 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7304 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7305 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7306 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7307 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7308 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7309 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7310 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7311 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7312 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7313 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7314 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7315 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7316
7317
7318 Version 1.8.0 (2016-04-14)
7319 ==========================
7320
7321 Language
7322 --------
7323
7324 * Rust supports overloading of compound assignment statements like
7325   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7326   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7327   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7328   traits. [RFC 953].
7329 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7330   addition to the non-braced form, `struct Foo;`. [RFC 218].
7331
7332 Libraries
7333 ---------
7334
7335 * Stabilized APIs:
7336   * [`str::encode_utf16`] (renamed from `utf16_units`)
7337   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7338   * [`Ref::map`]
7339   * [`RefMut::map`]
7340   * [`ptr::drop_in_place`]
7341   * [`time::Instant`]
7342   * [`time::SystemTime`]
7343   * [`Instant::now`]
7344   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7345   * [`Instant::elapsed`]
7346   * [`SystemTime::now`]
7347   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7348   * [`SystemTime::elapsed`]
7349   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7350   * [`SystemTimeError`]
7351   * [`SystemTimeError::duration`]
7352   * Various impls for `SystemTimeError`
7353   * [`UNIX_EPOCH`]
7354   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7355     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7356     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7357 * [The `write!` and `writeln!` macros correctly emit errors if any of
7358   their arguments can't be formatted][1.8w].
7359 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7360 * [The Unix-specific `raw` modules, which contain a number of
7361   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7362   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7363   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7364   across platforms was making it difficult to implement `std`
7365   correctly. Those that need these definitions should use the `libc`
7366   crate. [RFC 1415].
7367 * The Unix-specific `MetadataExt` traits, including
7368   `os::unix::fs::MetadataExt`, which expose values such as inode
7369   numbers [no longer return platform-specific types][1.8r], but
7370   instead return widened integers. [RFC 1415].
7371 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7372 * [Atomic loads and stores are not volatile][1.8a].
7373 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7374
7375 Performance
7376 -----------
7377
7378 * [Inlining hash functions lead to a 3% compile-time improvement in
7379   some workloads][1.8h].
7380 * When using jemalloc, its symbols are [unprefixed so that it
7381   overrides the libc malloc implementation][1.8h]. This means that for
7382   rustc, LLVM is now using jemalloc, which results in a 6%
7383   compile-time improvement on a specific workload.
7384 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7385
7386 Misc
7387 ----
7388
7389 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7390   i686-pc-windows-msvc is now considered a tier-1 platform.
7391 * [The `--print targets` flag prints a list of supported targets][1.8t].
7392 * [The `--print cfg` flag prints the `cfg`s defined for the current
7393   target][1.8cf].
7394 * [`rustc` can be built with an new Cargo-based build system, written
7395   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7396   build system. To enable it configure with `configure --rustbuild`.
7397 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7398   variants while also indicating the total number of missing variants
7399   if more than 3][1.8m].
7400 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7401 * The Rust Project now publishes binary releases of the standard
7402   library for a number of tier-2 targets:
7403   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7404   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7405   `x86_64-rumprun-netbsd`. These can be installed with
7406   tools such as [multirust][1.8mr].
7407
7408 Cargo
7409 -----
7410
7411 * [`cargo init` creates a new Cargo project in the current
7412   directory][1.8ci].  It is otherwise like `cargo new`.
7413 * [Cargo has configuration keys for `-v` and
7414   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7415   `[term]` section of `.cargo/config`.
7416 * [Configuration keys that evaluate to strings or integers can be set
7417   via environment variables][1.8ce]. For example the `build.jobs` key
7418   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7419   precedence over config files.
7420 * [Target-specific dependencies support Rust `cfg` syntax for
7421   describing targets][1.8cfg] so that dependencies for multiple
7422   targets can be specified together. [RFC 1361].
7423 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7424   `RUSTDOC` take precedence over the `build.target-dir`,
7425   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7426 * [The child process tree is killed on Windows when Cargo is
7427   killed][1.8ck].
7428 * [The `build.target` configuration value sets the target platform,
7429   like `--target`][1.8ct].
7430
7431 Compatibility Notes
7432 -------------------
7433
7434 * [Unstable compiler flags have been further restricted][1.8u]. Since
7435   1.0 `-Z` flags have been considered unstable, and other flags that
7436   were considered unstable additionally required passing `-Z
7437   unstable-options` to access. Unlike unstable language and library
7438   features though, these options have been accessible on the stable
7439   release channel. Going forward, *new unstable flags will not be
7440   available on the stable release channel*, and old unstable flags
7441   will warn about their usage. In the future, all unstable flags will
7442   be unavailable on the stable release channel.
7443 * [It is no longer possible to `match` on empty enum variants using
7444   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7445 * The Unix-specific `MetadataExt` traits, including
7446   `os::unix::fs::MetadataExt`, which expose values such as inode
7447   numbers [no longer return platform-specific types][1.8r], but
7448   instead return widened integers. [RFC 1415].
7449 * [Modules sourced from the filesystem cannot appear within arbitrary
7450   blocks, but only within other modules][1.8mf].
7451 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7452 * On Unix, [stack overflow triggers a runtime abort instead of a
7453   SIGSEGV][1.8so].
7454 * [`Command::spawn` and its equivalents return an error if any of
7455   its command-line arguments contain interior `NUL`s][1.8n].
7456 * [Tuple and unit enum variants from other crates are in the type
7457   namespace][1.8tn].
7458 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7459   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7460   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7461   instead of `foo.lib`.
7462
7463
7464 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7465 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7466 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7467 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7468 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7469 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7470 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7471 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7472 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7473 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7474 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7475 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7476 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7477 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7478 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7479 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7480 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7481 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7482 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7483 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7484 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7485 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7486 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7487 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7488 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7489 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7490 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7491 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7492 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7493 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7494 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7495 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7496 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7497 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7498 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7499 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7500 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7501 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7502 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7503 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7504 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7505 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7506 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7507 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7508 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7509 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7510 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7511 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7512 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7513 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7514 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7515 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7516 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7517 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7518 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7519 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7520 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7521 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7522 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7523 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7524
7525
7526 Version 1.7.0 (2016-03-03)
7527 ==========================
7528
7529 Libraries
7530 ---------
7531
7532 * Stabilized APIs
7533   * `Path`
7534     * [`Path::strip_prefix`] (renamed from relative_from)
7535     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7536   * `Ipv4Addr`
7537     * [`Ipv4Addr::is_loopback`]
7538     * [`Ipv4Addr::is_private`]
7539     * [`Ipv4Addr::is_link_local`]
7540     * [`Ipv4Addr::is_multicast`]
7541     * [`Ipv4Addr::is_broadcast`]
7542     * [`Ipv4Addr::is_documentation`]
7543   * `Ipv6Addr`
7544     * [`Ipv6Addr::is_unspecified`]
7545     * [`Ipv6Addr::is_loopback`]
7546     * [`Ipv6Addr::is_multicast`]
7547   * `Vec`
7548     * [`Vec::as_slice`]
7549     * [`Vec::as_mut_slice`]
7550   * `String`
7551     * [`String::as_str`]
7552     * [`String::as_mut_str`]
7553   * Slices
7554     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7555     be the same length
7556     * `<[T]>::`[`sort_by_key`]
7557   * checked, saturated, and overflowing operations
7558     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7559     * [`i32::saturating_mul`]
7560     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7561     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7562     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7563     * [`u32::saturating_mul`]
7564     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7565     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7566     * and checked, saturated, and overflowing operations for other primitive types
7567   * FFI
7568     * [`ffi::IntoStringError`]
7569     * [`CString::into_string`]
7570     * [`CString::into_bytes`]
7571     * [`CString::into_bytes_with_nul`]
7572     * `From<CString> for Vec<u8>`
7573   * `IntoStringError`
7574     * [`IntoStringError::into_cstring`]
7575     * [`IntoStringError::utf8_error`]
7576     * `Error for IntoStringError`
7577   * Hashing
7578     * [`std::hash::BuildHasher`]
7579     * [`BuildHasher::Hasher`]
7580     * [`BuildHasher::build_hasher`]
7581     * [`std::hash::BuildHasherDefault`]
7582     * [`HashMap::with_hasher`]
7583     * [`HashMap::with_capacity_and_hasher`]
7584     * [`HashSet::with_hasher`]
7585     * [`HashSet::with_capacity_and_hasher`]
7586     * [`std::collections::hash_map::RandomState`]
7587     * [`RandomState::new`]
7588 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7589   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7590   from bytes is faster.
7591 * [The performance of `LineWriter` (and thus `io::stdout`) was
7592   improved by using `memchr` to search for newlines][1.7m].
7593 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7594   `f64` variants were stabilized previously.
7595 * [`BTreeMap` was rewritten to use less memory and improve the performance
7596   of insertion and iteration, the latter by as much as 5x][1.7bm].
7597 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7598   covariant over their contained type][1.7bt].
7599 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7600   over their contained type][1.7ll].
7601 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7602   searching methods.
7603 * [`Any` is implemented for unsized types][1.7a].
7604 * [`Hash` is implemented for `Duration`][1.7h].
7605
7606 Misc
7607 ----
7608
7609 * [When running tests with `--test`, rustdoc will pass `--cfg`
7610   arguments to the compiler][1.7dt].
7611 * [The compiler is built with RPATH information by default][1.7rpa].
7612   This means that it will be possible to run `rustc` when installed in
7613   unusual configurations without configuring the dynamic linker search
7614   path explicitly.
7615 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7616   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7617   over `LD_LIBRARY_PATH`.
7618
7619 Cargo
7620 -----
7621
7622 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7623   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7624 * [The `rerun-if-changed` build script directive no longer causes the
7625   build script to incorrectly run twice in certain scenarios][1.7rr].
7626
7627 Compatibility Notes
7628 -------------------
7629
7630 * Soundness fixes to the interactions between associated types and
7631   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7632   code that violates the new rules. This is a significant change that
7633   is known to break existing code, so it has emitted warnings for the
7634   new error cases since 1.4 to give crate authors time to adapt. The
7635   details of what is changing are subtle; read the RFC for more.
7636 * [Several bugs in the compiler's visibility calculations were
7637   fixed][1.7v]. Since this was found to break significant amounts of
7638   code, the new errors will be emitted as warnings for several release
7639   cycles, under the `private_in_public` lint.
7640 * Defaulted type parameters were accidentally accepted in positions
7641   that were not intended. In this release, [defaulted type parameters
7642   appearing outside of type definitions will generate a
7643   warning][1.7d], which will become an error in future releases.
7644 * [Parsing "." as a float results in an error instead of 0][1.7p].
7645   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7646 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7647
7648 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7649 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7650 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7651 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7652 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7653 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7654 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7655 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7656 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7657 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7658 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7659 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7660 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7661 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7662 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7663 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7664 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7665 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7666 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7667 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7668 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7669 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7670 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7671 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7672 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7673 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7674 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7675 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7676 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7677 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7678 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7679 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7680 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7681 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7682 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7683 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7684 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7685 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7686 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7687 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7688 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7689 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7690 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7691 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7692 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7693 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7694 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7695 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7696 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7697 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7698 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7699 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7700 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7701 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7702 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7703 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7704 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7705 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7706 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7707 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7708 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7709 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7710 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7711 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7712 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7713 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7714 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7715 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7716 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7717 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7718 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7719 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7720 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7721 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7722 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7723 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7724 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7725 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7726 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7727
7728
7729 Version 1.6.0 (2016-01-21)
7730 ==========================
7731
7732 Language
7733 --------
7734
7735 * The `#![no_std]` attribute causes a crate to not be linked to the
7736   standard library, but only the [core library][1.6co], as described
7737   in [RFC 1184]. The core library defines common types and traits but
7738   has no platform dependencies whatsoever, and is the basis for Rust
7739   software in environments that cannot support a full port of the
7740   standard library, such as operating systems. Most of the core
7741   library is now stable.
7742
7743 Libraries
7744 ---------
7745
7746 * Stabilized APIs:
7747   [`Read::read_exact`],
7748   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7749   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7750   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7751   [`os::unix::fs::DirBuilderExt`],
7752   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7753   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7754   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7755   [`collections::hash_map::Drain`],
7756   [`collections::hash_map::HashMap::drain`],
7757   [`collections::hash_set::Drain`],
7758   [`collections::hash_set::HashSet::drain`],
7759   [`collections::binary_heap::Drain`],
7760   [`collections::binary_heap::BinaryHeap::drain`],
7761   [`Vec::extend_from_slice`] (renamed from `push_all`),
7762   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7763   [`RwLock::into_inner`],
7764   [`Iterator::min_by_key`] (renamed from `min_by`),
7765   [`Iterator::max_by_key`] (renamed from `max_by`).
7766 * The [core library][1.6co] is stable, as are most of its APIs.
7767 * [The `assert_eq!` macro supports arguments that don't implement
7768   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7769   `assert!`.
7770 * Several timer functions that take duration in milliseconds [are
7771   deprecated in favor of those that take `Duration`][1.6ms]. These
7772   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7773   `thread::park_timeout_ms`.
7774 * The algorithm by which `Vec` reserves additional elements was
7775   [tweaked to not allocate excessive space][1.6a] while still growing
7776   exponentially.
7777 * `From` conversions are [implemented from integers to floats][1.6f]
7778   in cases where the conversion is lossless. Thus they are not
7779   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7780   or `f64`. They are also not implemented for `isize` and `usize`
7781   because the implementations would be platform-specific. `From` is
7782   also implemented from `f32` to `f64`.
7783 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7784 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7785 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7786 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7787   improvements.
7788 * Sorting slices that are already sorted [is 50% faster in some
7789   cases][1.6s].
7790
7791 Cargo
7792 -----
7793
7794 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7795 * Cargo build scripts can specify their dependencies by emitting the
7796   [`rerun-if-changed`][1.6rr] key.
7797 * crates.io will reject publication of crates with dependencies that
7798   have a wildcard version constraint. Crates with wildcard
7799   dependencies were seen to cause a variety of problems, as described
7800   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7801   warning.
7802 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7803   release folder.  A variety of artifacts that Cargo failed to clean
7804   are now correctly deleted.
7805
7806 Misc
7807 ----
7808
7809 * The `unreachable_code` lint [warns when a function call's argument
7810   diverges][1.6dv].
7811 * The parser indicates [failures that may be caused by
7812   confusingly-similar Unicode characters][1.6uc]
7813 * Certain macro errors [are reported at definition time][1.6m], not
7814   expansion.
7815
7816 Compatibility Notes
7817 -------------------
7818
7819 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7820   environment variable when locating crates. This was a pre-cargo
7821   feature for integrating with the package manager that was
7822   accidentally never removed.
7823 * [A number of bugs were fixed in the privacy checker][1.6p] that
7824   could cause previously-accepted code to break.
7825 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7826 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7827   struct pattern syntax (`Foo(..)`) can no longer be used to match
7828   unit structs. This is a warning now, but will become an error in
7829   future releases. Patterns that share the same name as a const are
7830   now an error.
7831 * A bug was fixed that causes [rustc not to apply default type
7832   parameters][1.6xc] when resolving certain method implementations of
7833   traits defined in other crates.
7834
7835 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7836 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7837 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7838 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7839 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7840 [1.6co]: http://doc.rust-lang.org/core/index.html
7841 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7842 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7843 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7844 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7845 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7846 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7847 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7848 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7849 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7850 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7851 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7852 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7853 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7854 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7855 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7856 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7857 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7858 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7859 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7860 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7861 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7862 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7863 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7864 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7865 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7866 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7867 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7868 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7869 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7870 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7871 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7872 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7873 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7874 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7875 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7876 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7877 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7878 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7879 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7880 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7881 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7882
7883
7884 Version 1.5.0 (2015-12-10)
7885 ==========================
7886
7887 * ~700 changes, numerous bugfixes
7888
7889 Highlights
7890 ----------
7891
7892 * Stabilized APIs:
7893   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7894   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7895   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7896   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7897   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7898   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7899   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7900   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7901   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7902   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7903   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7904   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7905   [`Path::read_link`], [`Path::symlink_metadata`],
7906   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7907   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7908   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7909   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7910   [`slice::split_first_mut`], [`slice::split_first`],
7911   [`slice::split_last_mut`], [`slice::split_last`],
7912   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7913   [`str::MatchIndices`], [`str::RMatchIndices`],
7914   [`str::match_indices`], [`str::rmatch_indices`],
7915   [`str::slice_mut_unchecked`], [`string::ParseError`].
7916 * Rust applications hosted on crates.io can be installed locally to
7917   `~/.cargo/bin` with the [`cargo install`] command. Among other
7918   things this makes it easier to augment Cargo with new subcommands:
7919   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7920   invoked as `cargo foo`.
7921 * Crates with wildcard (`*`) dependencies will [emit warnings when
7922   published][1.5w]. In 1.6 it will no longer be possible to publish
7923   crates with wildcard dependencies.
7924
7925 Breaking Changes
7926 ----------------
7927
7928 * The rules determining when a particular lifetime must outlive
7929   a particular value (known as '[dropck]') have been [modified
7930   to not rely on parametricity][1.5p].
7931 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7932   and `Arc`][1.5a]. Because these smart pointer types implement
7933   `Deref`, this causes breakage in cases where the interior type
7934   contains methods of the same name.
7935 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7936   that they could drop their content. Soundness fix.
7937 * All method invocations are [properly checked][1.5wf1] for
7938   [well-formedness][1.5wf2]. Soundness fix.
7939 * Traits whose supertraits contain `Self` are [not object
7940   safe][1.5o]. Soundness fix.
7941 * Target specifications support a [`no_default_libraries`][1.5nd]
7942   setting that controls whether `-nodefaultlibs` is passed to the
7943   linker, and in turn the `is_like_windows` setting no longer affects
7944   the `-nodefaultlibs` flag.
7945 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7946 * The `#[inline]` and `#[repr]` attributes [can only appear
7947   in valid locations][1.5at].
7948 * Native libraries linked from the local crate are [passed to
7949   the linker before native libraries from upstream crates][1.5nl].
7950 * Two rarely-used attributes, `#[no_debug]` and
7951   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7952 * Negation of unsigned integers, which has been a warning for
7953   several releases, [is now behind a feature gate and will
7954   generate errors][1.5nu].
7955 * The parser accidentally accepted visibility modifiers on
7956   enum variants, a bug [which has been fixed][1.5ev].
7957 * [A bug was fixed that allowed `use` statements to import unstable
7958   features][1.5use].
7959
7960 Language
7961 --------
7962
7963 * When evaluating expressions at compile-time that are not
7964   compile-time constants (const-evaluating expressions in non-const
7965   contexts), incorrect code such as overlong bitshifts and arithmetic
7966   overflow will [generate a warning instead of an error][1.5ce],
7967   delaying the error until runtime. This will allow the
7968   const-evaluator to be expanded in the future backwards-compatibly.
7969 * The `improper_ctypes` lint [no longer warns about using `isize` and
7970   `usize` in FFI][1.5ict].
7971
7972 Libraries
7973 ---------
7974
7975 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7976   invariant][1.5c].
7977 * `Default` is [implemented for mutable slices][1.5d].
7978 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7979 * There are now `From` conversions [between floating point
7980   types][1.5f] where the conversions are lossless.
7981 * There are now `From` conversions [between integer types][1.5i] where
7982   the conversions are lossless.
7983 * [`fs::Metadata` implements `Clone`][1.5fs].
7984 * The `parse` method [accepts a leading "+" when parsing
7985   integers][1.5pi].
7986 * [`AsMut` is implemented for `Vec`][1.5am].
7987 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7988   been optimized][1.5cf] and no longer rely on the default impl.
7989 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7990   `unsafe extern "C"` function types now [implement `Clone`,
7991   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7992   `fmt::Debug` for up to 12 arguments][1.5fp].
7993 * [Dropping `Vec`s is much faster in unoptimized builds when the
7994   element types don't implement `Drop`][1.5dv].
7995 * A bug that caused in incorrect behavior when [combining `VecDeque`
7996   with zero-sized types][1.5vdz] was resolved.
7997 * [`PartialOrd` for slices is faster][1.5po].
7998
7999 Miscellaneous
8000 -------------
8001
8002 * [Crate metadata size was reduced by 20%][1.5md].
8003 * [Improvements to code generation reduced the size of libcore by 3.3
8004   MB and rustc's memory usage by 18MB][1.5m].
8005 * [Improvements to deref translation increased performance in
8006   unoptimized builds][1.5dr].
8007 * Various errors in trait resolution [are deduplicated to only be
8008   reported once][1.5te].
8009 * Rust has preliminary [support for rumprun kernels][1.5rr].
8010 * Rust has preliminary [support for NetBSD on amd64][1.5na].
8011
8012 [1.5use]: https://github.com/rust-lang/rust/pull/28364
8013 [1.5po]: https://github.com/rust-lang/rust/pull/28436
8014 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
8015 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
8016 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
8017 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
8018 [1.5md]: https://github.com/rust-lang/rust/pull/28521
8019 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
8020 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
8021 [1.5na]: https://github.com/rust-lang/rust/pull/28543
8022 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
8023 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
8024 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
8025 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
8026 [1.5te]: https://github.com/rust-lang/rust/pull/28645
8027 [1.5at]: https://github.com/rust-lang/rust/pull/28650
8028 [1.5am]: https://github.com/rust-lang/rust/pull/28663
8029 [1.5m]: https://github.com/rust-lang/rust/pull/28778
8030 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
8031 [1.5a]: https://github.com/rust-lang/rust/pull/28811
8032 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
8033 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
8034 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
8035 [1.5i]: https://github.com/rust-lang/rust/pull/28921
8036 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
8037 [1.5f]: https://github.com/rust-lang/rust/pull/29129
8038 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
8039 [1.5s]: https://github.com/rust-lang/rust/pull/29190
8040 [1.5d]: https://github.com/rust-lang/rust/pull/29245
8041 [1.5o]: https://github.com/rust-lang/rust/pull/29259
8042 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
8043 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8044 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
8045 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
8046 [1.5c]: https://github.com/rust-lang/rust/pull/29110
8047 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
8048 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
8049 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
8050 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
8051 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
8052 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
8053 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
8054 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
8055 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
8056 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
8057 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
8058 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
8059 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
8060 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
8061 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
8062 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
8063 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
8064 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
8065 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
8066 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
8067 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
8068 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
8069 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
8070 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
8071 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
8072 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
8073 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
8074 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
8075 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
8076 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
8077 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
8078 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
8079 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
8080 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
8081 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
8082 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
8083 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
8084 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
8085 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
8086 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
8087 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
8088 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
8089 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
8090 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
8091 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
8092 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
8093 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
8094 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
8095 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
8096 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
8097 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
8098 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
8099 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
8100 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
8101
8102 Version 1.4.0 (2015-10-29)
8103 ==========================
8104
8105 * ~1200 changes, numerous bugfixes
8106
8107 Highlights
8108 ----------
8109
8110 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
8111   GNU) are now supported and recommended for use.
8112
8113 Breaking Changes
8114 ----------------
8115
8116 * [Several changes have been made to fix type soundness and improve
8117   the behavior of associated types][sound]. See [RFC 1214]. Although
8118   we have mostly introduced these changes as warnings this release, to
8119   become errors next release, there are still some scenarios that will
8120   see immediate breakage.
8121 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
8122   line breaks in addition to `\n`][crlf].
8123 * [Loans of `'static` lifetime extend to the end of a function][stat].
8124 * [`str::parse` no longer introduces avoidable rounding error when
8125   parsing floating point numbers. Together with earlier changes to
8126   float formatting/output, "round trips" like f.to_string().parse()
8127   now preserve the value of f exactly. Additionally, leading plus
8128   signs are now accepted][fp3].
8129
8130
8131 Language
8132 --------
8133
8134 * `use` statements that import multiple items [can now rename
8135   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8136 * [Binops work correctly on fat pointers][binfat].
8137 * `pub extern crate`, which does not behave as expected, [issues a
8138   warning][pec] until a better solution is found.
8139
8140 Libraries
8141 ---------
8142
8143 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8144   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8145   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8146   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8147   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8148   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8149   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8150   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8151   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8152   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8153   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8154   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8155   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8156   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8157   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8158   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8159   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8160   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8161   [`thread::sleep`].
8162 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8163   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8164   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8165   `f64::from_str_radix`.
8166 * [Reverse-searching strings is faster with the 'two-way'
8167   algorithm][s].
8168 * [`std::io::copy` allows `?Sized` arguments][cc].
8169 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8170   [override `count`, `nth` and `last` with an O(1)
8171   implementation][it].
8172 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8173 * [`IntoRawFd` has been added to the Unix-specific prelude,
8174   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8175   prelude][pr].
8176 * [`Extend<String>` and `FromIterator<String` are both implemented for
8177   `String`][es].
8178 * [`IntoIterator` is implemented for references to `Option` and
8179   `Result`][into2].
8180 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8181   Copy`][ext] as part of [RFC 839]. This will cause type inference
8182   breakage in rare situations.
8183 * [`BinaryHeap` implements `Debug`][bh2].
8184 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8185   arrays][bm].
8186 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8187   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8188 * [String comparison is faster][faststr].
8189 * `&mut T` where `T: std::fmt::Write` [also implements
8190   `std::fmt::Write`][mutw].
8191 * [A stable regression in `VecDeque::push_back` and other
8192   capacity-altering methods that caused panics for zero-sized types
8193   was fixed][vd].
8194 * [Function pointers implement traits for up to 12 parameters][fp2].
8195
8196 Miscellaneous
8197 -------------
8198
8199 * The compiler [no longer uses the 'morestack' feature to prevent
8200   stack overflow][mm]. Instead it uses guard pages and stack
8201   probes (though stack probes are not yet implemented on any platform
8202   but Windows).
8203 * [The compiler matches traits faster when projections are involved][p].
8204 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8205   `usize`][ffi].
8206 * [Cargo now displays useful information about what its doing during
8207   `cargo update`][cu].
8208
8209 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8210 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8211 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8212 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8213 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8214 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8215 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8216 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8217 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8218 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8219 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8220 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8221 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8222 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8223 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8224 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8225 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8226 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8227 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8228 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8229 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8230 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8231 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8232 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8233 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8234 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8235 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8236 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8237 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8238 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8239 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8240 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8241 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8242 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8243 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8244 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8245 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8246 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8247 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8248 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8249 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8250 [bh2]: https://github.com/rust-lang/rust/pull/28156
8251 [binfat]: https://github.com/rust-lang/rust/pull/28270
8252 [bm]: https://github.com/rust-lang/rust/pull/28197
8253 [cc]: https://github.com/rust-lang/rust/pull/27531
8254 [crlf]: https://github.com/rust-lang/rust/pull/28034
8255 [cu]: https://github.com/rust-lang/cargo/pull/1931
8256 [d]: https://github.com/rust-lang/rust/pull/27825
8257 [dep]: https://github.com/rust-lang/rust/pull/28339
8258 [es]: https://github.com/rust-lang/rust/pull/27956
8259 [ext]: https://github.com/rust-lang/rust/pull/28094
8260 [faststr]: https://github.com/rust-lang/rust/pull/28338
8261 [ffi]: https://github.com/rust-lang/rust/pull/28779
8262 [fp]: https://github.com/rust-lang/rust/pull/28268
8263 [fp2]: https://github.com/rust-lang/rust/pull/28560
8264 [fp3]: https://github.com/rust-lang/rust/pull/27307
8265 [i]: https://github.com/rust-lang/rust/pull/27451
8266 [into2]: https://github.com/rust-lang/rust/pull/28039
8267 [it]: https://github.com/rust-lang/rust/pull/27652
8268 [mm]: https://github.com/rust-lang/rust/pull/27338
8269 [mutw]: https://github.com/rust-lang/rust/pull/28368
8270 [sound]: https://github.com/rust-lang/rust/pull/27641
8271 [p]: https://github.com/rust-lang/rust/pull/27866
8272 [pec]: https://github.com/rust-lang/rust/pull/28486
8273 [pr]: https://github.com/rust-lang/rust/pull/27896
8274 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8275 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8276 [s]: https://github.com/rust-lang/rust/pull/27474
8277 [stab]: https://github.com/rust-lang/rust/pull/28339
8278 [stat]: https://github.com/rust-lang/rust/pull/28321
8279 [vd]: https://github.com/rust-lang/rust/pull/28494
8280
8281 Version 1.3.0 (2015-09-17)
8282 ==============================
8283
8284 * ~900 changes, numerous bugfixes
8285
8286 Highlights
8287 ----------
8288
8289 * The [new object lifetime defaults][nold] have been [turned
8290   on][nold2] after a cycle of warnings about the change. Now types
8291   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8292   being interpreted as `&'a Box<Trait+'a>` to `&'a
8293   Box<Trait+'static>`.
8294 * [The Rustonomicon][nom] is a new book in the official documentation
8295   that dives into writing unsafe Rust.
8296 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8297   timekeeping is employed by other std APIs, as well as out-of-tree
8298   time crates.
8299
8300 Breaking Changes
8301 ----------------
8302
8303 * The [new object lifetime defaults][nold] have been [turned
8304   on][nold2] after a cycle of warnings about the change.
8305 * There is a known [regression][lr] in how object lifetime elision is
8306   interpreted, the proper solution for which is undetermined.
8307 * The `#[prelude_import]` attribute, an internal implementation
8308   detail, was accidentally stabilized previously. [It has been put
8309   behind the `prelude_import` feature gate][pi]. This change is
8310   believed to break no existing code.
8311 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8312   [more sane for dynamically sized types][dst3]. Code that relied on
8313   the previous behavior is thought to be broken.
8314 * The `dropck` rules, which checks that destructors can't access
8315   destroyed values, [have been updated][dropck] to match the
8316   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8317   cause some previously-compiling code to no longer build.
8318
8319 Language
8320 --------
8321
8322 * The [new object lifetime defaults][nold] have been [turned
8323   on][nold2] after a cycle of warnings about the change.
8324 * Semicolons may [now follow types and paths in
8325   macros](https://github.com/rust-lang/rust/pull/27000).
8326 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8327   [more sane for dynamically sized types][dst3]. Code that relied on
8328   the previous behavior is not known to exist, and suspected to be
8329   broken.
8330 * `'static` variables [may now be recursive][st].
8331 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8332   implementations correctly.
8333 * The `dropck` rules, which checks that destructors can't access
8334   destroyed values, [have been updated][dropck] to match the
8335   [RFC][dropckrfc].
8336
8337 Libraries
8338 ---------
8339
8340 * The [`Duration`] API, [has been stabilized][ds], as well as the
8341   `std::time` module, which presently contains only `Duration`.
8342 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8343 * The owned C string, [`CString`], implements [`Borrow`] and the
8344   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8345   these allow C strings to be borrowed and cloned in generic code.
8346 * [`CStr`] implements [`Debug`].
8347 * [`AtomicPtr`] implements [`Debug`].
8348 * [`Error`] trait objects [can be downcast to their concrete types][e]
8349   in many common configurations, using the [`is`], [`downcast`],
8350   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8351   [`Any`] trait.
8352 * Searching for substrings now [employs the two-way algorithm][search]
8353   instead of doing a naive search. This gives major speedups to a
8354   number of methods, including [`contains`][sc], [`find`][sf],
8355   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8356   [`ends_with`][sew] are also faster.
8357 * The performance of `PartialEq` for slices is [much faster][ps].
8358 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8359   is overridden and optimized by the implementations for scalars.
8360 * The [`Hasher`] trait now has a number of specialized `write_*`
8361   methods for primitive types, for efficiency.
8362 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8363   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8364   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8365   of [`std::error::Error::cause`][iec] also delegates to the inner
8366   error.
8367 * [`process::Child`][pc] gained the [`id`] method, which returns a
8368   `u32` representing the platform-specific process identifier.
8369 * The [`connect`] method on slices is deprecated, replaced by the new
8370   [`join`] method (note that both of these are on the *unstable*
8371   [`SliceConcatExt`] trait, but through the magic of the prelude are
8372   available to stable code anyway).
8373 * The [`Div`] operator is implemented for [`Wrapping`] types.
8374 * [`DerefMut` is implemented for `String`][dms].
8375 * Performance of SipHash (the default hasher for `HashMap`) is
8376   [better for long data][sh].
8377 * [`AtomicPtr`] implements [`Send`].
8378 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8379   are now [specialized to use uninitialized buffers for increased
8380   performance][rte].
8381 * Lifetime parameters of foreign functions [are now resolved
8382   properly][f].
8383
8384 Misc
8385 ----
8386
8387 * Rust can now, with some coercion, [produce programs that run on
8388   Windows XP][xp], though XP is not considered a supported platform.
8389 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8390   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8391   recommended for use in 1.3, though should be fully-functional
8392   in the [64-bit 1.4 beta][b14].
8393 * On Fedora-based systems installation will [properly configure the
8394   dynamic linker][fl].
8395 * The compiler gained many new extended error descriptions, which can
8396   be accessed with the `--explain` flag.
8397 * The `dropck` pass, which checks that destructors can't access
8398   destroyed values, [has been rewritten][dropck]. This fixes some
8399   soundness holes, and as such will cause some previously-compiling
8400   code to no longer build.
8401 * `rustc` now uses [LLVM to write archive files where possible][ar].
8402   Eventually this will eliminate the compiler's dependency on the ar
8403   utility.
8404 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8405   supported FreeBSD on x86_64).
8406 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8407   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8408   more strict.
8409 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8410   will kill the process instead of leaking][nlp].
8411
8412 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8413 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8414 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8415 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8416 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8417 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8418 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8419 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8420 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8421 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8422 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8423 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8424 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8425 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8426 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8427 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8428 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8429 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8430 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8431 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8432 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8433 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8434 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8435 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8436 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8437 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8438 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8439 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8440 [ar]: https://github.com/rust-lang/rust/pull/26926
8441 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8442 [dms]: https://github.com/rust-lang/rust/pull/26241
8443 [dropck]: https://github.com/rust-lang/rust/pull/27261
8444 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8445 [ds]: https://github.com/rust-lang/rust/pull/26818
8446 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8447 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8448 [dst3]: https://github.com/rust-lang/rust/pull/27351
8449 [e]: https://github.com/rust-lang/rust/pull/24793
8450 [f]: https://github.com/rust-lang/rust/pull/26588
8451 [fb]: https://github.com/rust-lang/rust/pull/26959
8452 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8453 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8454 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8455 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8456 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8457 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8458 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8459 [lic]: https://github.com/rust-lang/rust/pull/26583
8460 [lnu]: https://github.com/rust-lang/rust/pull/27026
8461 [lr]: https://github.com/rust-lang/rust/issues/27248
8462 [lum]: https://github.com/rust-lang/rust/pull/26378
8463 [lur]: https://github.com/rust-lang/rust/pull/26783
8464 [nlp]: https://github.com/rust-lang/rust/pull/27176
8465 [nold2]: https://github.com/rust-lang/rust/pull/27045
8466 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8467 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8468 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8469 [pi]: https://github.com/rust-lang/rust/pull/26699
8470 [ps]: https://github.com/rust-lang/rust/pull/26884
8471 [rte]: https://github.com/rust-lang/rust/pull/26950
8472 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8473 [search]: https://github.com/rust-lang/rust/pull/26327
8474 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8475 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8476 [sh]: https://github.com/rust-lang/rust/pull/27280
8477 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8478 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8479 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8480 [st]: https://github.com/rust-lang/rust/pull/26630
8481 [win1]: https://github.com/rust-lang/rust/pull/26569
8482 [win2]: https://github.com/rust-lang/rust/pull/26741
8483 [win3]: https://github.com/rust-lang/rust/pull/26741
8484 [win4]: https://github.com/rust-lang/rust/pull/27210
8485 [xp]: https://github.com/rust-lang/rust/pull/26569
8486
8487 Version 1.2.0 (2015-08-07)
8488 ==========================
8489
8490 * ~1200 changes, numerous bugfixes
8491
8492 Highlights
8493 ----------
8494
8495 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8496   like `Rc` to contain types without a fixed size, arrays and trait
8497   objects, finally enabling use of `Rc<[T]>` and completing the
8498   implementation of DST.
8499 * [Parallel codegen][parcodegen] is now working again, which can
8500   substantially speed up large builds in debug mode; It also gets
8501   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8502   jobs). It's not enabled by default, but will be "in the near
8503   future". It can be activated with the `-C codegen-units=N` flag to
8504   `rustc`.
8505 * This is the first release with [experimental support for linking
8506   with the MSVC linker and lib C on Windows (instead of using the GNU
8507   variants via MinGW)][win]. It is yet recommended only for the most
8508   intrepid Rustaceans.
8509 * Benchmark compilations are showing a 30% improvement in
8510   bootstrapping over 1.1.
8511
8512 Breaking Changes
8513 ----------------
8514
8515 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8516   unicode case mapping, which is a previously-planned change in
8517   behavior and considered a bugfix.
8518 * [`mem::align_of`] now specifies [the *minimum alignment* for
8519   T][align], which is usually the alignment programs are interested
8520   in, and the same value reported by clang's
8521   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8522   break real code.
8523 * [The `#[packed]` attribute is no longer silently accepted by the
8524   compiler][packed]. This attribute did nothing and code that
8525   mentioned it likely did not work as intended.
8526 * Associated type defaults are [now behind the
8527   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8528   defaults *did not work*, but could be mentioned syntactically. As
8529   such this breakage has minimal impact.
8530
8531 Language
8532 --------
8533
8534 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8535   matching against dereferenceable values.
8536
8537 Libraries
8538 ---------
8539
8540 * The [`Extend`] trait, which grows a collection from an iterator, is
8541   implemented over iterators of references, for `String`, `Vec`,
8542   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8543   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8544 * The [`iter::once`] function returns an iterator that yields a single
8545   element, and [`iter::empty`] returns an iterator that yields no
8546   elements.
8547 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8548   over substring matches.
8549 * [`Cell`] and [`RefCell`] both implement `Eq`.
8550 * A number of methods for wrapping arithmetic are added to the
8551   integral types, [`wrapping_div`], [`wrapping_rem`],
8552   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8553   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8554   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8555   type.. It is illegal for the default arithmetic operations in Rust
8556   to overflow; the desire to wrap must be explicit.
8557 * The `{:#?}` formatting specifier [displays the alternate,
8558   pretty-printed][debugfmt] form of the `Debug` formatter. This
8559   feature was actually introduced prior to 1.0 with little
8560   fanfare.
8561 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8562   for writing data to formatted strings, similar to [`io::Write`].
8563 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8564   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8565   are used by code generators to emit implementations of [`Debug`].
8566 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8567   methods that convert case, following Unicode case mapping.
8568 * It is now easier to handle poisoned locks. The [`PoisonError`]
8569   type, returned by failing lock operations, exposes `into_inner`,
8570   `get_ref`, and `get_mut`, which all give access to the inner lock
8571   guard, and allow the poisoned lock to continue to operate. The
8572   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8573   poisoned lock without attempting to take the lock.
8574 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8575   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8576   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8577   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8578   `ChildStderr`.
8579 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8580   malformed input.
8581
8582 Misc
8583 ----
8584
8585 * `rustc` employs smarter heuristics for guessing at [typos].
8586 * `rustc` emits more efficient code for [no-op conversions between
8587   unsafe pointers][nop].
8588 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8589   resulting in faster compile times and smaller code.
8590
8591 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8592 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8593 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8594 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8595 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8596 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8597 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8598 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8599 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8600 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8601 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8602 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8603 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8604 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8605 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8606 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8607 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8608 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8609 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8610 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8611 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8612 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8613 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8614 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8615 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8616 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8617 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8618 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8619 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8620 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8621 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8622 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8623 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8624 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8625 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8626 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8627 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8628 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8629 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8630 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8631 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8632 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8633 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8634 [align]: https://github.com/rust-lang/rust/pull/25646
8635 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8636 [typos]: https://github.com/rust-lang/rust/pull/26087
8637 [nop]: https://github.com/rust-lang/rust/pull/26336
8638 [fat]: https://github.com/rust-lang/rust/pull/26411
8639 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8640 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8641 [packed]: https://github.com/rust-lang/rust/pull/25541
8642 [ad]: https://github.com/rust-lang/rust/pull/27382
8643 [win]: https://github.com/rust-lang/rust/pull/25350
8644
8645 Version 1.1.0 (2015-06-25)
8646 =========================
8647
8648 * ~850 changes, numerous bugfixes
8649
8650 Highlights
8651 ----------
8652
8653 * The [`std::fs` module has been expanded][fs] to expand the set of
8654   functionality exposed:
8655   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8656     don't incur a syscall on some platforms.
8657   * A `symlink_metadata` function has been added.
8658   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8659     access to all underlying information.
8660 * The compiler now contains extended explanations of many errors. When an error
8661   with an explanation occurs the compiler suggests using the `--explain` flag
8662   to read the explanation. Error explanations are also [available online][err-index].
8663 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8664   well as other work, the time to bootstrap the compiler decreased by
8665   32%.
8666
8667 Libraries
8668 ---------
8669
8670 * The [`str::split_whitespace`] method splits a string on unicode
8671   whitespace boundaries.
8672 * On both Windows and Unix, new extension traits provide conversion of
8673   I/O types to and from the underlying system handles. On Unix, these
8674   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8675   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8676   `TcpListener`, and `UpdSocket`. Further implementations for
8677   `std::process` will be stabilized later.
8678 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8679   Windows, symlinks can be created with
8680   `std::os::windows::symlink_dir` and
8681   `std::os::windows::symlink_file`.
8682 * The `mpsc::Receiver` type can now be converted into an iterator with
8683   `into_iter` on the [`IntoIterator`] trait.
8684 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8685   implementation of the [`From`] trait.
8686 * The `Debug` implementation for `RangeFull` [creates output that is
8687   more consistent with other implementations][rf].
8688 * [`Debug` is implemented for `File`][file].
8689 * The `Default` implementation for `Arc` [no longer requires `Sync +
8690   Send`][arc].
8691 * [The `Iterator` methods `count`, `nth`, and `last` have been
8692   overridden for slices to have O(1) performance instead of O(n)][si].
8693 * Incorrect handling of paths on Windows has been improved in both the
8694   compiler and the standard library.
8695 * [`AtomicPtr` gained a `Default` implementation][ap].
8696 * In accordance with Rust's policy on arithmetic overflow `abs` now
8697   [panics on overflow when debug assertions are enabled][abs].
8698 * The [`Cloned`] iterator, which was accidentally left unstable for
8699   1.0 [has been stabilized][c].
8700 * The [`Incoming`] iterator, which iterates over incoming TCP
8701   connections, and which was accidentally unnamable in 1.0, [is now
8702   properly exported][inc].
8703 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8704   `sift_up` or `sift_down` panic][bh].
8705 * The [`split_off`] method of `LinkedList` [no longer corrupts
8706   the list in certain scenarios][ll].
8707
8708 Misc
8709 ----
8710
8711 * Type checking performance [has improved notably][sk] with
8712   [multiple improvements][pre].
8713 * The compiler [suggests code changes][ch] for more errors.
8714 * rustc and it's build system have experimental support for [building
8715   toolchains against MUSL][m] instead of glibc on Linux.
8716 * The compiler defines the `target_env` cfg value, which is used for
8717   distinguishing toolchains that are otherwise for the same
8718   platform. Presently this is set to `gnu` for common GNU Linux
8719   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8720 * The [`cargo rustc`][crc] command invokes a build with custom flags
8721   to rustc.
8722 * [Android executables are always position independent][pie].
8723 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8724   with `Drop`][drop].
8725
8726 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8727 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8728 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8729 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8730 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8731 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8732 [rf]: https://github.com/rust-lang/rust/pull/24491
8733 [err-index]: https://doc.rust-lang.org/error-index.html
8734 [sk]: https://github.com/rust-lang/rust/pull/24615
8735 [pre]: https://github.com/rust-lang/rust/pull/25323
8736 [file]: https://github.com/rust-lang/rust/pull/24598
8737 [ch]: https://github.com/rust-lang/rust/pull/24683
8738 [arc]: https://github.com/rust-lang/rust/pull/24695
8739 [si]: https://github.com/rust-lang/rust/pull/24701
8740 [ap]: https://github.com/rust-lang/rust/pull/24834
8741 [m]: https://github.com/rust-lang/rust/pull/24777
8742 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8743 [crc]: https://github.com/rust-lang/cargo/pull/1568
8744 [pie]: https://github.com/rust-lang/rust/pull/24953
8745 [abs]: https://github.com/rust-lang/rust/pull/25441
8746 [c]: https://github.com/rust-lang/rust/pull/25496
8747 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8748 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8749 [inc]: https://github.com/rust-lang/rust/pull/25522
8750 [bh]: https://github.com/rust-lang/rust/pull/25856
8751 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8752 [ll]: https://github.com/rust-lang/rust/pull/26022
8753 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8754 [drop]: https://github.com/rust-lang/rust/pull/24935
8755
8756 Version 1.0.0 (2015-05-15)
8757 ========================
8758
8759 * ~1500 changes, numerous bugfixes
8760
8761 Highlights
8762 ----------
8763
8764 * The vast majority of the standard library is now `#[stable]`. It is
8765   no longer possible to use unstable features with a stable build of
8766   the compiler.
8767 * Many popular crates on [crates.io] now work on the stable release
8768   channel.
8769 * Arithmetic on basic integer types now [checks for overflow in debug
8770   builds][overflow].
8771
8772 Language
8773 --------
8774
8775 * Several [restrictions have been added to trait coherence][coh] in
8776   order to make it easier for upstream authors to change traits
8777   without breaking downstream code.
8778 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8779   improve error messages and macro behavior. For example, `0b1234` is
8780   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8781 * Trait bounds [are always invariant][inv], eliminating the need for
8782   the `PhantomFn` and `MarkerTrait` lang items, which have been
8783   removed.
8784 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8785   "foo" as bar` syntax has been replaced with `extern crate foo as
8786   bar`, and Cargo now automatically translates "-" in *package* names
8787   to underscore for the crate name.
8788 * [Lifetime shadowing is an error][lt].
8789 * [`Send` no longer implies `'static`][send-rfc].
8790 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8791   `MyType::default()`.
8792 * Primitive types [now have inherent methods][prim-inherent],
8793   obviating the need for extension traits like `SliceExt`.
8794 * Methods with `Self: Sized` in their `where` clause are [considered
8795   object-safe][self-sized], allowing many extension traits like
8796   `IteratorExt` to be merged into the traits they extended.
8797 * You can now [refer to associated types][assoc-where] whose
8798   corresponding trait bounds appear only in a `where` clause.
8799 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8800   like `Send` and `Sync` are now library-defined.
8801 * A [Reflect trait][reflect] was introduced, which means that
8802   downcasting via the `Any` trait is effectively limited to concrete
8803   types. This helps retain the potentially-important "parametricity"
8804   property: generic code cannot behave differently for different type
8805   arguments except in minor ways.
8806 * The `unsafe_destructor` feature is now deprecated in favor of the
8807   [new `dropck`][dropck]. This change is a major reduction in unsafe
8808   code.
8809
8810 Libraries
8811 ---------
8812
8813 * The `thread_local` module [has been renamed to `std::thread`][th].
8814 * The methods of `IteratorExt` [have been moved to the `Iterator`
8815   trait itself][ie].
8816 * Several traits that implement Rust's conventions for type
8817   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8818   [centralized in the `std::convert` module][con].
8819 * The `FromError` trait [was removed in favor of `From`][fe].
8820 * The basic sleep function [has moved to
8821   `std::thread::sleep_ms`][slp].
8822 * The `splitn` function now takes an `n` parameter that represents the
8823   number of items yielded by the returned iterator [instead of the
8824   number of 'splits'][spl].
8825 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8826 * [Derived implementations of `PartialOrd` now order enums according
8827   to their explicitly-assigned discriminants][po].
8828 * [Methods for searching strings are generic over `Pattern`s][pat],
8829   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8830   some others.
8831 * [In method resolution, object methods are resolved before inherent
8832   methods][meth].
8833 * [`String::from_str` has been deprecated in favor of the `From` impl,
8834   `String::from`][sf].
8835 * [`io::Error` implements `Sync`][ios].
8836 * [The `words` method on `&str` has been replaced with
8837   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8838   a word?'
8839 * The new path and IO modules are complete and `#[stable]`. This
8840   was the major library focus for this cycle.
8841 * The path API was [revised][path-normalize] to normalize `.`,
8842   adjusting the tradeoffs in favor of the most common usage.
8843 * A large number of remaining APIs in `std` were also stabilized
8844   during this cycle; about 75% of the non-deprecated API surface
8845   is now stable.
8846 * The new [string pattern API][string-pattern] landed, which makes
8847   the string slice API much more internally consistent and flexible.
8848 * A new set of [generic conversion traits][conversion] replaced
8849   many existing ad hoc traits.
8850 * Generic numeric traits were [completely removed][num-traits]. This
8851   was made possible thanks to inherent methods for primitive types,
8852   and the removal gives maximal flexibility for designing a numeric
8853   hierarchy in the future.
8854 * The `Fn` traits are now related via [inheritance][fn-inherit]
8855   and provide ergonomic [blanket implementations][fn-blanket].
8856 * The `Index` and `IndexMut` traits were changed to
8857   [take the index by value][index-value], enabling code like
8858   `hash_map["string"]` to work.
8859 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8860   `Copy` data is known to be `Clone` as well.
8861
8862 Misc
8863 ----
8864
8865 * Many errors now have extended explanations that can be accessed with
8866   the `--explain` flag to `rustc`.
8867 * Many new examples have been added to the standard library
8868   documentation.
8869 * rustdoc has received a number of improvements focused on completion
8870   and polish.
8871 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8872 * Much headway was made on ecosystem-wide CI, making it possible
8873   to [compare builds for breakage][ci-compare].
8874
8875
8876 [crates.io]: http://crates.io
8877 [clo]: https://github.com/rust-lang/rust/pull/24034
8878 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8879 [con]: https://github.com/rust-lang/rust/pull/23875
8880 [cr]: https://github.com/rust-lang/rust/pull/23419
8881 [fe]: https://github.com/rust-lang/rust/pull/23879
8882 [ie]: https://github.com/rust-lang/rust/pull/23300
8883 [inv]: https://github.com/rust-lang/rust/pull/23938
8884 [ios]: https://github.com/rust-lang/rust/pull/24133
8885 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8886 [lt]: https://github.com/rust-lang/rust/pull/24057
8887 [meth]: https://github.com/rust-lang/rust/pull/24056
8888 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8889 [po]: https://github.com/rust-lang/rust/pull/24270
8890 [sf]: https://github.com/rust-lang/rust/pull/24517
8891 [slp]: https://github.com/rust-lang/rust/pull/23949
8892 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8893 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8894 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8895 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8896 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8897 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8898 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8899 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8900 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8901 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8902 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8903 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8904 [reflect]: https://github.com/rust-lang/rust/pull/23712
8905 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8906 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8907 [index-value]: https://github.com/rust-lang/rust/pull/23601
8908 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8909 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8910 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8911 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8912 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8913 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8914
8915
8916 Version 1.0.0-alpha.2 (2015-02-20)
8917 =====================================
8918
8919 * ~1300 changes, numerous bugfixes
8920
8921 * Highlights
8922
8923     * The various I/O modules were [overhauled][io-rfc] to reduce
8924       unnecessary abstractions and provide better interoperation with
8925       the underlying platform. The old `io` module remains temporarily
8926       at `std::old_io`.
8927     * The standard library now [participates in feature gating][feat],
8928       so use of unstable libraries now requires a `#![feature(...)]`
8929       attribute. The impact of this change is [described on the
8930       forum][feat-forum]. [RFC][feat-rfc].
8931
8932 * Language
8933
8934     * `for` loops [now operate on the `IntoIterator` trait][into],
8935       which eliminates the need to call `.iter()`, etc. to iterate
8936       over collections. There are some new subtleties to remember
8937       though regarding what sort of iterators various types yield, in
8938       particular that `for foo in bar { }` yields values from a move
8939       iterator, destroying the original collection. [RFC][into-rfc].
8940     * Objects now have [default lifetime bounds][obj], so you don't
8941       have to write `Box<Trait+'static>` when you don't care about
8942       storing references. [RFC][obj-rfc].
8943     * In types that implement `Drop`, [lifetimes must outlive the
8944       value][drop]. This will soon make it possible to safely
8945       implement `Drop` for types where `#[unsafe_destructor]` is now
8946       required. Read the [gorgeous RFC][drop-rfc] for details.
8947     * The fully qualified <T as Trait>::X syntax lets you set the Self
8948       type for a trait method or associated type. [RFC][ufcs-rfc].
8949     * References to types that implement `Deref<U>` now [automatically
8950       coerce to references][deref] to the dereferenced type `U`,
8951       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8952       should eliminate many unsightly uses of `&*`, as when converting
8953       from references to vectors into references to
8954       slices. [RFC][deref-rfc].
8955     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8956       `|:|`) is obsolete and closure kind is inferred from context.
8957     * [`Self` is a keyword][Self].
8958
8959 * Libraries
8960
8961     * The `Show` and `String` formatting traits [have been
8962       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8963       their related purposes. Automatically getting a string
8964       conversion to use with `format!("{:?}", something_to_debug)` is
8965       now written `#[derive(Debug)]`.
8966     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8967       OsStr}`, provide strings in platform-specific encodings for easier
8968       interop with system APIs. [RFC][osstr-rfc].
8969     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8970       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8971       creating raw pointers.
8972
8973 * Tooling
8974
8975     * Certain long error messages of the form 'expected foo found bar'
8976       are now [split neatly across multiple
8977       lines][multiline]. Examples in the PR.
8978     * On Unix Rust can be [uninstalled][un] by running
8979       `/usr/local/lib/rustlib/uninstall.sh`.
8980     * The `#[rustc_on_unimplemented]` attribute, requiring the
8981       'on_unimplemented' feature, lets rustc [display custom error
8982       messages when a trait is expected to be implemented for a type
8983       but is not][onun].
8984
8985 * Misc
8986
8987     * Rust is tested against a [LALR grammar][lalr], which parses
8988       almost all the Rust files that rustc does.
8989
8990 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8991 [close]: https://github.com/rust-lang/rust/pull/21843
8992 [deref]: https://github.com/rust-lang/rust/pull/21351
8993 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8994 [drop]: https://github.com/rust-lang/rust/pull/21972
8995 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8996 [feat]: https://github.com/rust-lang/rust/pull/21248
8997 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8998 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8999 [fmt]: https://github.com/rust-lang/rust/pull/21457
9000 [into]: https://github.com/rust-lang/rust/pull/20790
9001 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
9002 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9003 [lalr]: https://github.com/rust-lang/rust/pull/21452
9004 [multiline]: https://github.com/rust-lang/rust/pull/19870
9005 [obj]: https://github.com/rust-lang/rust/pull/22230
9006 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
9007 [onun]: https://github.com/rust-lang/rust/pull/20889
9008 [osstr]: https://github.com/rust-lang/rust/pull/21488
9009 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
9010 [Self]: https://github.com/rust-lang/rust/pull/22158
9011 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
9012 [un]: https://github.com/rust-lang/rust/pull/22256
9013
9014
9015 Version 1.0.0-alpha (2015-01-09)
9016 ==================================
9017
9018   * ~2400 changes, numerous bugfixes
9019
9020   * Highlights
9021
9022     * The language itself is considered feature complete for 1.0,
9023       though there will be many usability improvements and bugfixes
9024       before the final release.
9025     * Nearly 50% of the public API surface of the standard library has
9026       been declared 'stable'. Those interfaces are unlikely to change
9027       before 1.0.
9028     * The long-running debate over integer types has been
9029       [settled][ints]: Rust will ship with types named `isize` and
9030       `usize`, rather than `int` and `uint`, for pointer-sized
9031       integers. Guidelines will be rolled out during the alpha cycle.
9032     * Most crates that are not `std` have been moved out of the Rust
9033       distribution into the Cargo ecosystem so they can evolve
9034       separately and don't need to be stabilized as quickly, including
9035       'time', 'getopts', 'num', 'regex', and 'term'.
9036     * Documentation continues to be expanded with more API coverage, more
9037       examples, and more in-depth explanations. The guides have been
9038       consolidated into [The Rust Programming Language][trpl].
9039     * "[Rust By Example][rbe]" is now maintained by the Rust team.
9040     * All official Rust binary installers now come with [Cargo], the
9041       Rust package manager.
9042
9043 * Language
9044
9045     * Closures have been [completely redesigned][unboxed] to be
9046       implemented in terms of traits, can now be used as generic type
9047       bounds and thus monomorphized and inlined, or via an opaque
9048       pointer (boxed) as in the old system. The new system is often
9049       referred to as 'unboxed' closures.
9050     * Traits now support [associated types][assoc], allowing families
9051       of related types to be defined together and used generically in
9052       powerful ways.
9053     * Enum variants are [namespaced by their type names][enum].
9054     * [`where` clauses][where] provide a more versatile and attractive
9055       syntax for specifying generic bounds, though the previous syntax
9056       remains valid.
9057     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
9058       numeric types.
9059     * Rust [no longer has a runtime][rt] of any description, and only
9060       supports OS threads, not green threads.
9061     * At long last, Rust has been overhauled for 'dynamically-sized
9062       types' ([DST]), which integrates 'fat pointers' (object types,
9063       arrays, and `str`) more deeply into the type system, making it
9064       more consistent.
9065     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
9066       `..j` that produce range types and which, when combined with the
9067       `Index` operator and multidispatch, leads to a convenient slice
9068       notation, `[i..j]`.
9069     * The new range syntax revealed an ambiguity in the fixed-length
9070       array syntax, so now fixed length arrays [are written `[T;
9071       N]`][arrays].
9072     * The `Copy` trait is no longer implemented automatically. Unsafe
9073       pointers no longer implement `Sync` and `Send` so types
9074       containing them don't automatically either. `Sync` and `Send`
9075       are now 'unsafe traits' so one can "forcibly" implement them via
9076       `unsafe impl` if a type confirms to the requirements for them
9077       even though the internals do not (e.g. structs containing unsafe
9078       pointers like `Arc`). These changes are intended to prevent some
9079       footguns and are collectively known as [opt-in built-in
9080       traits][oibit] (though `Sync` and `Send` will soon become pure
9081       library types unknown to the compiler).
9082     * Operator traits now take their operands [by value][ops], and
9083       comparison traits can use multidispatch to compare one type
9084       against multiple other types, allowing e.g. `String` to be
9085       compared with `&str`.
9086     * `if let` and `while let` are no longer feature-gated.
9087     * Rust has adopted a more [uniform syntax for escaping unicode
9088       characters][unicode].
9089     * `macro_rules!` [has been declared stable][mac]. Though it is a
9090       flawed system it is sufficiently popular that it must be usable
9091       for 1.0. Effort has gone into [future-proofing][mac-future] it
9092       in ways that will allow other macro systems to be developed in
9093       parallel, and won't otherwise impact the evolution of the
9094       language.
9095     * The prelude has been [pared back significantly][prelude] such
9096       that it is the minimum necessary to support the most pervasive
9097       code patterns, and through [generalized where clauses][where]
9098       many of the prelude extension traits have been consolidated.
9099     * Rust's rudimentary reflection [has been removed][refl], as it
9100       incurred too much code generation for little benefit.
9101     * [Struct variants][structvars] are no longer feature-gated.
9102     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
9103       known as 'higher-ranked trait bounds', this crucially allows
9104       unboxed closures to work.
9105     * Macros invocations surrounded by parens or square brackets and
9106       not terminated by a semicolon are [parsed as
9107       expressions][macros], which makes expressions like `vec![1i32,
9108       2, 3].len()` work as expected.
9109     * Trait objects now implement their traits automatically, and
9110       traits that can be coerced to objects now must be [object
9111       safe][objsafe].
9112     * Automatically deriving traits is now done with `#[derive(...)]`
9113       not `#[deriving(...)]` for [consistency with other naming
9114       conventions][derive].
9115     * Importing the containing module or enum at the same time as
9116       items or variants they contain is [now done with `self` instead
9117       of `mod`][self], as in use `foo::{self, bar}`
9118     * Glob imports are no longer feature-gated.
9119     * The `box` operator and `box` patterns have been feature-gated
9120       pending a redesign. For now unique boxes should be allocated
9121       like other containers, with `Box::new`.
9122
9123 * Libraries
9124
9125     * A [series][coll1] of [efforts][coll2] to establish
9126       [conventions][coll3] for collections types has resulted in API
9127       improvements throughout the standard library.
9128     * New [APIs for error handling][err] provide ergonomic interop
9129       between error types, and [new conventions][err-conv] describe
9130       more clearly the recommended error handling strategies in Rust.
9131     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9132       it is easier to discuss failure in the context of error handling
9133       without making clarifications as to whether you are referring to
9134       the 'fail' macro or failure more generally.
9135     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9136       syscall when available.
9137     * The 'serialize' crate has been renamed 'rustc-serialize' and
9138       moved out of the distribution to Cargo. Although it is widely
9139       used now, it is expected to be superseded in the near future.
9140     * The `Show` formatter, typically implemented with
9141       `#[derive(Show)]` is [now requested with the `{:?}`
9142       specifier][show] and is intended for use by all types, for uses
9143       such as `println!` debugging. The new `String` formatter must be
9144       implemented by hand, uses the `{}` specifier, and is intended
9145       for full-fidelity conversions of things that can logically be
9146       represented as strings.
9147
9148 * Tooling
9149
9150     * [Flexible target specification][flex] allows rustc's code
9151       generation to be configured to support otherwise-unsupported
9152       platforms.
9153     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9154       respective debuggers with Rust-appropriate pretty-printing.
9155     * The Windows installation of Rust is distributed with the
9156       MinGW components currently required to link binaries on that
9157       platform.
9158
9159 * Misc
9160
9161     * Nullable enum optimizations have been extended to more types so
9162       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9163       space than the inner types themselves.
9164     * Work has begun on supporting AArch64.
9165
9166 [Cargo]: https://crates.io
9167 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9168 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9169 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9170 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9171 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9172 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9173 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9174 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9175 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9176 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9177 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9178 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9179 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9180 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9181 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9182 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9183 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9184 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9185 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9186 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9187 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9188 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9189 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9190 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9191 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9192 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9193 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9194 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9195 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9196 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9197 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9198 [trpl]: https://doc.rust-lang.org/book/index.html
9199 [rbe]: http://rustbyexample.com/
9200
9201
9202 Version 0.12.0 (2014-10-09)
9203 =============================
9204
9205   * ~1900 changes, numerous bugfixes
9206
9207   * Highlights
9208
9209     * The introductory documentation (now called The Rust Guide) has
9210       been completely rewritten, as have a number of supplementary
9211       guides.
9212     * Rust's package manager, Cargo, continues to improve and is
9213       sometimes considered to be quite awesome.
9214     * Many API's in `std` have been reviewed and updated for
9215       consistency with the in-development Rust coding
9216       guidelines. The standard library documentation tracks
9217       stabilization progress.
9218     * Minor libraries have been moved out-of-tree to the rust-lang org
9219       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9220       be installed with Cargo.
9221     * Lifetime elision allows lifetime annotations to be left off of
9222       function declarations in many common scenarios.
9223     * Rust now works on 64-bit Windows.
9224
9225   * Language
9226     * Indexing can be overloaded with the `Index` and `IndexMut`
9227       traits.
9228     * The `if let` construct takes a branch only if the `let` pattern
9229       matches, currently behind the 'if_let' feature gate.
9230     * 'where clauses', a more flexible syntax for specifying trait
9231       bounds that is more aesthetic, have been added for traits and
9232       free functions. Where clauses will in the future make it
9233       possible to constrain associated types, which would be
9234       impossible with the existing syntax.
9235     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9236       the 'slicing_syntax' feature gate, and can be overloaded with
9237       the `Slice` or `SliceMut` traits.
9238     * The syntax for matching of sub-slices has been changed to use a
9239       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9240       consistency with other uses of `..` and to future-proof
9241       potential additional uses of the syntax.
9242     * The syntax for matching inclusive ranges in patterns has changed
9243       from `0..3` to `0...4` to be consistent with the exclusive range
9244       syntax for slicing.
9245     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9246       c]`) has been put behind the 'advanced_slice_patterns' feature
9247       gate and may be removed in the future.
9248     * Components of tuples and tuple structs can be extracted using
9249       the `value.0` syntax, currently behind the `tuple_indexing`
9250       feature gate.
9251     * The `#[crate_id]` attribute is no longer supported; versioning
9252       is handled by the package manager.
9253     * Renaming crate imports are now written `extern crate foo as bar`
9254       instead of `extern crate bar = foo`.
9255     * Renaming use statements are now written `use foo as bar` instead
9256       of `use bar = foo`.
9257     * `let` and `match` bindings and argument names in macros are now
9258       hygienic.
9259     * The new, more efficient, closure types ('unboxed closures') have
9260       been added under a feature gate, 'unboxed_closures'. These will
9261       soon replace the existing closure types, once higher-ranked
9262       trait lifetimes are added to the language.
9263     * `move` has been added as a keyword, for indicating closures
9264       that capture by value.
9265     * Mutation and assignment is no longer allowed in pattern guards.
9266     * Generic structs and enums can now have trait bounds.
9267     * The `Share` trait is now called `Sync` to free up the term
9268       'shared' to refer to 'shared reference' (the default reference
9269       type.
9270     * Dynamically-sized types have been mostly implemented,
9271       unifying the behavior of fat-pointer types with the rest of the
9272       type system.
9273     * As part of dynamically-sized types, the `Sized` trait has been
9274       introduced, which qualifying types implement by default, and
9275       which type parameters expect by default. To specify that a type
9276       parameter does not need to be sized, write `<Sized? T>`. Most
9277       types are `Sized`, notable exceptions being unsized arrays
9278       (`[T]`) and trait types.
9279     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9280     * Lifetime bounds can now be applied to type parameters and object
9281       types.
9282     * The old, reference counted GC type, `Gc<T>` which was once
9283       denoted by the `@` sigil, has finally been removed. GC will be
9284       revisited in the future.
9285
9286   * Libraries
9287     * Library documentation has been improved for a number of modules.
9288     * Bit-vectors, collections::bitv has been modernized.
9289     * The url crate is deprecated in favor of
9290       http://github.com/servo/rust-url, which can be installed with
9291       Cargo.
9292     * Most I/O stream types can be cloned and subsequently closed from
9293       a different thread.
9294     * A `std::time::Duration` type has been added for use in I/O
9295       methods that rely on timers, as well as in the 'time' crate's
9296       `Timespec` arithmetic.
9297     * The runtime I/O abstraction layer that enabled the green thread
9298       scheduler to do non-thread-blocking I/O has been removed, along
9299       with the libuv-based implementation employed by the green thread
9300       scheduler. This will greatly simplify the future I/O work.
9301     * `collections::btree` has been rewritten to have a more
9302       idiomatic and efficient design.
9303
9304   * Tooling
9305     * rustdoc output now indicates the stability levels of API's.
9306     * The `--crate-name` flag can specify the name of the crate
9307       being compiled, like `#[crate_name]`.
9308     * The `-C metadata` specifies additional metadata to hash into
9309       symbol names, and `-C extra-filename` specifies additional
9310       information to put into the output filename, for use by the
9311       package manager for versioning.
9312     * debug info generation has continued to improve and should be
9313       more reliable under both gdb and lldb.
9314     * rustc has experimental support for compiling in parallel
9315       using the `-C codegen-units` flag.
9316     * rustc no longer encodes rpath information into binaries by
9317       default.
9318
9319   * Misc
9320     * Stack usage has been optimized with LLVM lifetime annotations.
9321     * Official Rust binaries on Linux are more compatible with older
9322       kernels and distributions, built on CentOS 5.10.
9323
9324
9325 Version 0.11.0 (2014-07-02)
9326 ==========================
9327
9328   * ~1700 changes, numerous bugfixes
9329
9330   * Language
9331     * ~[T] has been removed from the language. This type is superseded by
9332       the Vec<T> type.
9333     * ~str has been removed from the language. This type is superseded by
9334       the String type.
9335     * ~T has been removed from the language. This type is superseded by the
9336       Box<T> type.
9337     * @T has been removed from the language. This type is superseded by the
9338       standard library's std::gc::Gc<T> type.
9339     * Struct fields are now all private by default.
9340     * Vector indices and shift amounts are both required to be a `uint`
9341       instead of any integral type.
9342     * Byte character, byte string, and raw byte string literals are now all
9343       supported by prefixing the normal literal with a `b`.
9344     * Multiple ABIs are no longer allowed in an ABI string
9345     * The syntax for lifetimes on closures/procedures has been tweaked
9346       slightly: `<'a>|A, B|: 'b + K -> T`
9347     * Floating point modulus has been removed from the language; however it
9348       is still provided by a library implementation.
9349     * Private enum variants are now disallowed.
9350     * The `priv` keyword has been removed from the language.
9351     * A closure can no longer be invoked through a &-pointer.
9352     * The `use foo, bar, baz;` syntax has been removed from the language.
9353     * The transmute intrinsic no longer works on type parameters.
9354     * Statics now allow blocks/items in their definition.
9355     * Trait bounds are separated from objects with + instead of : now.
9356     * Objects can no longer be read while they are mutably borrowed.
9357     * The address of a static is now marked as insignificant unless the
9358       #[inline(never)] attribute is placed it.
9359     * The #[unsafe_destructor] attribute is now behind a feature gate.
9360     * Struct literals are no longer allowed in ambiguous positions such as
9361       if, while, match, and for..in.
9362     * Declaration of lang items and intrinsics are now feature-gated by
9363       default.
9364     * Integral literals no longer default to `int`, and floating point
9365       literals no longer default to `f64`. Literals must be suffixed with an
9366       appropriate type if inference cannot determine the type of the
9367       literal.
9368     * The Box<T> type is no longer implicitly borrowed to &mut T.
9369     * Procedures are now required to not capture borrowed references.
9370
9371   * Libraries
9372     * The standard library is now a "facade" over a number of underlying
9373       libraries. This means that development on the standard library should
9374       be speedier due to smaller crates, as well as a clearer line between
9375       all dependencies.
9376     * A new library, libcore, lives under the standard library's facade
9377       which is Rust's "0-assumption" library, suitable for embedded and
9378       kernel development for example.
9379     * A regex crate has been added to the standard distribution. This crate
9380       includes statically compiled regular expressions.
9381     * The unwrap/unwrap_err methods on Result require a Show bound for
9382       better error messages.
9383     * The return types of the std::comm primitives have been centralized
9384       around the Result type.
9385     * A number of I/O primitives have gained the ability to time out their
9386       operations.
9387     * A number of I/O primitives have gained the ability to close their
9388       reading/writing halves to cancel pending operations.
9389     * Reverse iterator methods have been removed in favor of `rev()` on
9390       their forward-iteration counterparts.
9391     * A bitflags! macro has been added to enable easy interop with C and
9392       management of bit flags.
9393     * A debug_assert! macro is now provided which is disabled when
9394       `--cfg ndebug` is passed to the compiler.
9395     * A graphviz crate has been added for creating .dot files.
9396     * The std::cast module has been migrated into std::mem.
9397     * The std::local_data api has been migrated from freestanding functions
9398       to being based on methods.
9399     * The Pod trait has been renamed to Copy.
9400     * jemalloc has been added as the default allocator for types.
9401     * The API for allocating memory has been changed to use proper alignment
9402       and sized deallocation
9403     * Connecting a TcpStream or binding a TcpListener is now based on a
9404       string address and a u16 port. This allows connecting to a hostname as
9405       opposed to an IP.
9406     * The Reader trait now contains a core method, read_at_least(), which
9407       correctly handles many repeated 0-length reads.
9408     * The process-spawning API is now centered around a builder-style
9409       Command struct.
9410     * The :? printing qualifier has been moved from the standard library to
9411       an external libdebug crate.
9412     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9413       have been renamed to Eq/Ord.
9414     * The select/plural methods have been removed from format!. The escapes
9415       for { and } have also changed from \{ and \} to {{ and }},
9416       respectively.
9417     * The TaskBuilder API has been re-worked to be a true builder, and
9418       extension traits for spawning native/green tasks have been added.
9419
9420   * Tooling
9421     * All breaking changes to the language or libraries now have their
9422       commit message annotated with `[breaking-change]` to allow for easy
9423       discovery of breaking changes.
9424     * The compiler will now try to suggest how to annotate lifetimes if a
9425       lifetime-related error occurs.
9426     * Debug info continues to be improved greatly with general bug fixes and
9427       better support for situations like link time optimization (LTO).
9428     * Usage of syntax extensions when cross-compiling has been fixed.
9429     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9430       -fdata-sections and --gc-sections has been enabled by default
9431     * The compiler is now stricter about where it will load module files
9432       from when a module is declared via `mod foo;`.
9433     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9434       Syntax extensions are now discovered via a "plugin registrar" type
9435       which will be extended in the future to other various plugins.
9436     * Lints have been restructured to allow for dynamically loadable lints.
9437     * A number of rustdoc improvements:
9438       * The HTML output has been visually redesigned.
9439       * Markdown is now powered by hoedown instead of sundown.
9440       * Searching heuristics have been greatly improved.
9441       * The search index has been reduced in size by a great amount.
9442       * Cross-crate documentation via `pub use` has been greatly improved.
9443       * Primitive types are now hyperlinked and documented.
9444     * Documentation has been moved from static.rust-lang.org/doc to
9445       doc.rust-lang.org
9446     * A new sandbox, play.rust-lang.org, is available for running and
9447       sharing rust code examples on-line.
9448     * Unused attributes are now more robustly warned about.
9449     * The dead_code lint now warns about unused struct fields.
9450     * Cross-compiling to iOS is now supported.
9451     * Cross-compiling to mipsel is now supported.
9452     * Stability attributes are now inherited by default and no longer apply
9453       to intra-crate usage, only inter-crate usage.
9454     * Error message related to non-exhaustive match expressions have been
9455       greatly improved.
9456
9457
9458 Version 0.10 (2014-04-03)
9459 =========================
9460
9461   * ~1500 changes, numerous bugfixes
9462
9463   * Language
9464     * A new RFC process is now in place for modifying the language.
9465     * Patterns with `@`-pointers have been removed from the language.
9466     * Patterns with unique vectors (`~[T]`) have been removed from the
9467       language.
9468     * Patterns with unique strings (`~str`) have been removed from the
9469       language.
9470     * `@str` has been removed from the language.
9471     * `@[T]` has been removed from the language.
9472     * `@self` has been removed from the language.
9473     * `@Trait` has been removed from the language.
9474     * Headers on `~` allocations which contain `@` boxes inside the type for
9475       reference counting have been removed.
9476     * The semantics around the lifetimes of temporary expressions have changed,
9477       see #3511 and #11585 for more information.
9478     * Cross-crate syntax extensions are now possible, but feature gated. See
9479       #11151 for more information. This includes both `macro_rules!` macros as
9480       well as syntax extensions such as `format!`.
9481     * New lint modes have been added, and older ones have been turned on to be
9482       warn-by-default.
9483       * Unnecessary parentheses
9484       * Uppercase statics
9485       * Camel Case types
9486       * Uppercase variables
9487       * Publicly visible private types
9488       * `#[deriving]` with raw pointers
9489     * Unsafe functions can no longer be coerced to closures.
9490     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9491     * The `#[simd]` attribute is now behind a feature gate.
9492     * Visibility is no longer allowed on `extern crate` statements, and
9493       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9494     * Trailing commas are now allowed in argument lists and tuple patterns.
9495     * The `do` keyword has been removed, it is now a reserved keyword.
9496     * Default type parameters have been implemented, but are feature gated.
9497     * Borrowed variables through captures in closures are now considered soundly.
9498     * `extern mod` is now `extern crate`
9499     * The `Freeze` trait has been removed.
9500     * The `Share` trait has been added for types that can be shared among
9501       threads.
9502     * Labels in macros are now hygienic.
9503     * Expression/statement macro invocations can be delimited with `{}` now.
9504     * Treatment of types allowed in `static mut` locations has been tweaked.
9505     * The `*` and `.` operators are now overloadable through the `Deref` and
9506       `DerefMut` traits.
9507     * `~Trait` and `proc` no longer have `Send` bounds by default.
9508     * Partial type hints are now supported with the `_` type marker.
9509     * An `Unsafe` type was introduced for interior mutability. It is now
9510       considered undefined to transmute from `&T` to `&mut T` without using the
9511       `Unsafe` type.
9512     * The #[linkage] attribute was implemented for extern statics/functions.
9513     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9514     * `Pod` was renamed to `Copy`.
9515
9516   * Libraries
9517     * The `libextra` library has been removed. It has now been decomposed into
9518       component libraries with smaller and more focused nuggets of
9519       functionality. The full list of libraries can be found on the
9520       documentation index page.
9521     * std: `std::condition` has been removed. All I/O errors are now propagated
9522       through the `Result` type. In order to assist with error handling, a
9523       `try!` macro for unwrapping errors with an early return and a lint for
9524       unused results has been added. See #12039 for more information.
9525     * std: The `vec` module has been renamed to `slice`.
9526     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9527       This will become the only growable vector in the future.
9528     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9529       are now found at `std::io::BufferedReader` instead of
9530       `std::io::buffered::BufferedReader`.
9531     * std: `print` and `println` are no longer in the prelude, the `print!` and
9532       `println!` macros are intended to be used instead.
9533     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9534       attempts to statically prevent cycles.
9535     * std: The standard distribution is adopting the policy of pushing failure
9536       to the user rather than failing in libraries. Many functions (such as
9537       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9538     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9539       deriving mode: `#[deriving(Show)]`.
9540     * std: `ToStr` is now implemented for all types implementing `Show`.
9541     * std: The formatting trait methods now take `&self` instead of `&T`
9542     * std: The `invert()` method on iterators has been renamed to `rev()`
9543     * std: `std::num` has seen a reduction in the genericity of its traits,
9544       consolidating functionality into a few core traits.
9545     * std: Backtraces are now printed on task failure if the environment
9546       variable `RUST_BACKTRACE` is present.
9547     * std: Naming conventions for iterators have been standardized. More details
9548       can be found on the wiki's style guide.
9549     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9550       still implement the function.
9551     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9552     * std: `assert_approx_eq!` has been removed
9553     * std: The `e` and `E` formatting specifiers for floats have been added to
9554       print them in exponential notation.
9555     * std: The `Times` trait has been removed
9556     * std: Indications of variance and opting out of builtin bounds is done
9557       through marker types in `std::kinds::marker` now
9558     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9559       `#[deriving(Hash)]` is now possible.
9560     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9561     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9562     * std: `Chan::new` is now `channel()`.
9563     * std: A new synchronous channel type has been implemented.
9564     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9565     * std: `hashmap` and `trie` have been moved to `libcollections`
9566     * std: `run` has been rolled into `io::process`
9567     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9568     * std: The equality and comparison traits have seen some reorganization.
9569     * std: `rand` has moved to `librand`.
9570     * std: `to_{lower,upper}case` has been implemented for `char`.
9571     * std: Logging has been moved to `liblog`.
9572     * collections: `HashMap` has been rewritten for higher performance and less
9573       memory usage.
9574     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9575       it can be booted manually. The runtime guide has more information and
9576       examples.
9577     * native: All I/O functionality except signals has been implemented.
9578     * green: Task spawning with `libgreen` has been optimized with stack caching
9579       and various trimming of code.
9580     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9581     * sync: The `extra::sync` module has been updated to modern rust (and moved
9582       to the `sync` library), tweaking and improving various interfaces while
9583       dropping redundant functionality.
9584     * sync: A new `Barrier` type has been added to the `sync` library.
9585     * sync: An efficient mutex for native and green tasks has been implemented.
9586     * serialize: The `base64` module has seen some improvement. It treats
9587       newlines better, has non-string error values, and has seen general
9588       cleanup.
9589     * fourcc: A `fourcc!` macro was introduced
9590     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9591       hexadecimal literal.
9592
9593   * Tooling
9594     * `rustpkg` has been deprecated and removed from the main repository. Its
9595       replacement, `cargo`, is under development.
9596     * Nightly builds of rust are now available
9597     * The memory usage of rustc has been improved many times throughout this
9598       release cycle.
9599     * The build process supports disabling rpath support for the rustc binary
9600       itself.
9601     * Code generation has improved in some cases, giving more information to the
9602       LLVM optimization passes to enable more extensive optimizations.
9603     * Debuginfo compatibility with lldb on OSX has been restored.
9604     * The master branch is now gated on an android bot, making building for
9605       android much more reliable.
9606     * Output flags have been centralized into one `--emit` flag.
9607     * Crate type flags have been centralized into one `--crate-type` flag.
9608     * Codegen flags have been consolidated behind a `-C` flag.
9609     * Linking against outdated crates now has improved error messages.
9610     * Error messages with lifetimes will often suggest how to annotate the
9611       function to fix the error.
9612     * Many more types are documented in the standard library, and new guides
9613       were written.
9614     * Many `rustdoc` improvements:
9615       * code blocks are syntax highlighted.
9616       * render standalone markdown files.
9617       * the --test flag tests all code blocks by default.
9618       * exported macros are displayed.
9619       * re-exported types have their documentation inlined at the location of the
9620         first re-export.
9621       * search works across crates that have been rendered to the same output
9622         directory.
9623
9624
9625 Version 0.9 (2014-01-09)
9626 ==========================
9627
9628    * ~1800 changes, numerous bugfixes
9629
9630    * Language
9631       * The `float` type has been removed. Use `f32` or `f64` instead.
9632       * A new facility for enabling experimental features (feature gating) has
9633         been added, using the crate-level `#[feature(foo)]` attribute.
9634       * Managed boxes (@) are now behind a feature gate
9635         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9636         standard library's `Gc` or `Rc` types instead.
9637       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9638       * Jumping back to the top of a loop is now done with `continue` instead of
9639         `loop`.
9640       * Strings can no longer be mutated through index assignment.
9641       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9642         hash delimiters, as in `r###"foo"###`.
9643       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9644         called once.
9645       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9646       * `@fn`s have been removed.
9647       * `do` only works with procs in order to make it obvious what the cost
9648         of `do` is.
9649       * Single-element tuple-like structs can no longer be dereferenced to
9650         obtain the inner value. A more comprehensive solution for overloading
9651         the dereference operator will be provided in the future.
9652       * The `#[link(...)]` attribute has been replaced with
9653         `#[crate_id = "name#vers"]`.
9654       * Empty `impl`s must be terminated with empty braces and may not be
9655         terminated with a semicolon.
9656       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9657         no longer has any special meaning.
9658       * The old `fmt!` string formatting macro has been removed.
9659       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9660         `print!` and `println!`.
9661       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9662       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9663         `extern mod foo = "bar"` instead.
9664       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9665       * Macros can have attributes.
9666       * Macros can expand to items with attributes.
9667       * Macros can expand to multiple items.
9668       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9669       * Comments may be nested.
9670       * Values automatically coerce to trait objects they implement, without
9671         an explicit `as`.
9672       * Enum discriminants are no longer an entire word but as small as needed to
9673         contain all the variants. The `repr` attribute can be used to override
9674         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9675         `#[repr(C)]` to match C enums.
9676       * Non-string literals are not allowed in attributes (they never worked).
9677       * The FFI now supports variadic functions.
9678       * Octal numeric literals, as in `0o7777`.
9679       * The `concat!` syntax extension performs compile-time string concatenation.
9680       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9681         removed as Rust no longer uses segmented stacks.
9682       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9683       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9684         not `*`; ignoring remaining fields of a struct is also done with `..`,
9685         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9686       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9687       * `rustc` supports the "system" calling convention, which defaults to the
9688         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9689         "C" elsewhere.
9690       * The `type_overflow` lint (default: warn) checks literals for overflow.
9691       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9692       * The `attribute_usage` lint (default: warn) warns about unknown
9693         attributes.
9694       * The `unknown_features` lint (default: warn) warns about unknown
9695         feature gates.
9696       * The `dead_code` lint (default: warn) checks for dead code.
9697       * Rust libraries can be linked statically to one another
9698       * `#[link_args]` is behind the `link_args` feature gate.
9699       * Native libraries are now linked with `#[link(name = "foo")]`
9700       * Native libraries can be statically linked to a rust crate
9701         (`#[link(name = "foo", kind = "static")]`).
9702       * Native OS X frameworks are now officially supported
9703         (`#[link(name = "foo", kind = "framework")]`).
9704       * The `#[thread_local]` attribute creates thread-local (not task-local)
9705         variables. Currently behind the `thread_local` feature gate.
9706       * The `return` keyword may be used in closures.
9707       * Types that can be copied via a memcpy implement the `Pod` kind.
9708       * The `cfg` attribute can now be used on struct fields and enum variants.
9709
9710    * Libraries
9711       * std: The `option` and `result` API's have been overhauled to make them
9712         simpler, more consistent, and more composable.
9713       * std: The entire `std::io` module has been replaced with one that is
9714         more comprehensive and that properly interfaces with the underlying
9715         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9716         implemented.
9717       * std: `io::util` contains a number of useful implementations of
9718         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9719         `ZeroReader`, `TeeReader`.
9720       * std: The reference counted pointer type `extra::rc` moved into std.
9721       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9722         just a wrapper around it).
9723       * std: The `Either` type has been removed.
9724       * std: `fmt::Default` can be implemented for any type to provide default
9725         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9726       * std: The `rand` API continues to be tweaked.
9727       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9728         on failure in gdb, is now named `rust_fail`.
9729       * std: The `each_key` and `each_value` methods on `HashMap` have been
9730         replaced by the `keys` and `values` iterators.
9731       * std: Functions dealing with type size and alignment have moved from the
9732         `sys` module to the `mem` module.
9733       * std: The `path` module was written and API changed.
9734       * std: `str::from_utf8` has been changed to cast instead of allocate.
9735       * std: `starts_with` and `ends_with` methods added to vectors via the
9736         `ImmutableEqVector` trait, which is in the prelude.
9737       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9738         if the index is out of bounds.
9739       * std: Task failure no longer propagates between tasks, as the model was
9740         complex, expensive, and incompatible with thread-based tasks.
9741       * std: The `Any` type can be used for dynamic typing.
9742       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9743         `task::try`.
9744       * std: Methods that produce iterators generally do not have an `_iter`
9745         suffix now.
9746       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9747         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9748       * std: `util::ignore` renamed to `prelude::drop`.
9749       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9750         trait.
9751       * std: `vec::raw` has seen a lot of cleanup and API changes.
9752       * std: The standard library no longer includes any C++ code, and very
9753         minimal C, eliminating the dependency on libstdc++.
9754       * std: Runtime scheduling and I/O functionality has been factored out into
9755         extensible interfaces and is now implemented by two different crates:
9756         libnative, for native threading and I/O; and libgreen, for green threading
9757         and I/O. This paves the way for using the standard library in more limited
9758         embedded environments.
9759       * std: The `comm` module has been rewritten to be much faster, have a
9760         simpler, more consistent API, and to work for both native and green
9761         threading.
9762       * std: All libuv dependencies have been moved into the rustuv crate.
9763       * native: New implementations of runtime scheduling on top of OS threads.
9764       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9765         and other I/O.
9766       * green: The green thread scheduler and message passing types are almost
9767         entirely lock-free.
9768       * extra: The `flatpipes` module had bitrotted and was removed.
9769       * extra: All crypto functions have been removed and Rust now has a policy of
9770         not reimplementing crypto in the standard library. In the future crypto
9771         will be provided by external crates with bindings to established libraries.
9772       * extra: `c_vec` has been modernized.
9773       * extra: The `sort` module has been removed. Use the `sort` method on
9774         mutable slices.
9775
9776    * Tooling
9777       * The `rust` and `rusti` commands have been removed, due to lack of
9778         maintenance.
9779       * `rustdoc` was completely rewritten.
9780       * `rustdoc` can test code examples in documentation.
9781       * `rustpkg` can test packages with the argument, 'test'.
9782       * `rustpkg` supports arbitrary dependencies, including C libraries.
9783       * `rustc`'s support for generating debug info is improved again.
9784       * `rustc` has better error reporting for unbalanced delimiters.
9785       * `rustc`'s JIT support was removed due to bitrot.
9786       * Executables and static libraries can be built with LTO (-Z lto)
9787       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9788         build tools.
9789
9790
9791 Version 0.8 (2013-09-26)
9792 ============================
9793
9794    * ~2200 changes, numerous bugfixes
9795
9796    * Language
9797       * The `for` loop syntax has changed to work with the `Iterator` trait.
9798       * At long last, unwinding works on Windows.
9799       * Default methods are ready for use.
9800       * Many trait inheritance bugs fixed.
9801       * Owned and borrowed trait objects work more reliably.
9802       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9803       * rustc can omit emission of code for the `debug!` macro if it is passed
9804         `--cfg ndebug`
9805       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9806         for foo.rs, then foo/mod.rs, and will generate an error when both are
9807         present.
9808       * Strings no longer contain trailing nulls. The new `std::c_str` module
9809         provides new mechanisms for converting to C strings.
9810       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9811       * The FFI has been overhauled such that foreign functions are called directly,
9812         instead of through a stack-switching wrapper.
9813       * Calling a foreign function must be done through a Rust function with the
9814         `#[fixed_stack_segment]` attribute.
9815       * The `externfn!` macro can be used to declare both a foreign function and
9816         a `#[fixed_stack_segment]` wrapper at once.
9817       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9818       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9819       * `priv` is disallowed everywhere except for struct fields and enum variants.
9820       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9821       * `ref` bindings in irrefutable patterns work correctly now.
9822       * `char` is now prevented from containing invalid code points.
9823       * Casting to `bool` is no longer allowed.
9824       * `\0` is now accepted as an escape in chars and strings.
9825       * `yield` is a reserved keyword.
9826       * `typeof` is a reserved keyword.
9827       * Crates may be imported by URL with `extern mod foo = "url";`.
9828       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9829       * Static vectors can be initialized with repeating elements,
9830         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9831       * Static structs can be initialized with functional record update,
9832         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9833       * `cfg!` can be used to conditionally execute code based on the crate
9834         configuration, similarly to `#[cfg(...)]`.
9835       * The `unnecessary_qualification` lint detects unneeded module
9836         prefixes (default: allow).
9837       * Arithmetic operations have been implemented on the SIMD types in
9838         `std::unstable::simd`.
9839       * Exchange allocation headers were removed, reducing memory usage.
9840       * `format!` implements a completely new, extensible, and higher-performance
9841         string formatting system. It will replace `fmt!`.
9842       * `print!` and `println!` write formatted strings (using the `format!`
9843         extension) to stdout.
9844       * `write!` and `writeln!` write formatted strings (using the `format!`
9845         extension) to the new Writers in `std::rt::io`.
9846       * The library section in which a function or static is placed may
9847         be specified with `#[link_section = "..."]`.
9848       * The `proto!` syntax extension for defining bounded message protocols
9849         was removed.
9850       * `macro_rules!` is hygienic for `let` declarations.
9851       * The `#[export_name]` attribute specifies the name of a symbol.
9852       * `unreachable!` can be used to indicate unreachable code, and fails
9853         if executed.
9854
9855    * Libraries
9856       * std: Transitioned to the new runtime, written in Rust.
9857       * std: Added an experimental I/O library, `rt::io`, based on the new
9858         runtime.
9859       * std: A new generic `range` function was added to the prelude, replacing
9860         `uint::range` and friends.
9861       * std: `range_rev` no longer exists. Since range is an iterator it can be
9862         reversed with `range(lo, hi).invert()`.
9863       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9864         renamed to `unwrap_or`.
9865       * std: The `iterator` module was renamed to `iter`.
9866       * std: Integral types now support the `checked_add`, `checked_sub`, and
9867         `checked_mul` operations for detecting overflow.
9868       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9869         consistency.
9870       * std: Methods are standardizing on conventions for casting methods:
9871         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9872         and cheap casts.
9873       * std: The `CString` type in `c_str` provides new ways to convert to and
9874         from C strings.
9875       * std: `DoubleEndedIterator` can yield elements in two directions.
9876       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9877         two splices.
9878       * std: `str::from_bytes` renamed to `str::from_utf8`.
9879       * std: `pop_opt` and `shift_opt` methods added to vectors.
9880       * std: The task-local data interface no longer uses @, and keys are
9881         no longer function pointers.
9882       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9883       * std: Added `SharedPort` to `comm`.
9884       * std: `Eq` has a default method for `ne`; only `eq` is required
9885         in implementations.
9886       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9887         is required in implementations.
9888       * std: `is_utf8` performance is improved, impacting many string functions.
9889       * std: `os::MemoryMap` provides cross-platform mmap.
9890       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9891         are not 'in-bounds' are considered undefined.
9892       * std: Many freestanding functions in `vec` removed in favor of methods.
9893       * std: Many freestanding functions on scalar types removed in favor of
9894         methods.
9895       * std: Many options to task builders were removed since they don't make
9896         sense in the new scheduler design.
9897       * std: More containers implement `FromIterator` so can be created by the
9898         `collect` method.
9899       * std: More complete atomic types in `unstable::atomics`.
9900       * std: `comm::PortSet` removed.
9901       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9902         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9903         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9904         default implementations.
9905       * std: Various `from_str` functions were removed in favor of a generic
9906         `from_str` which is available in the prelude.
9907       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9908       * extra: `dlist`, the doubly-linked list was modernized.
9909       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9910       * extra: Added `glob` module, replacing `std::os::glob`.
9911       * extra: `rope` was removed.
9912       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9913       * extra: `net`, and `timer` were removed. The experimental replacements
9914         are `std::rt::io::net` and `std::rt::io::timer`.
9915       * extra: Iterators implemented for `SmallIntMap`.
9916       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9917       * extra: `SmallIntSet` removed. Use `BitvSet`.
9918       * extra: Performance of JSON parsing greatly improved.
9919       * extra: `semver` updated to SemVer 2.0.0.
9920       * extra: `term` handles more terminals correctly.
9921       * extra: `dbg` module removed.
9922       * extra: `par` module removed.
9923       * extra: `future` was cleaned up, with some method renames.
9924       * extra: Most free functions in `getopts` were converted to methods.
9925
9926    * Other
9927       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9928       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9929         similarly to gcc's `--march` flag.
9930       * rustc's performance compiling small crates is much better.
9931       * rustpkg has received many improvements.
9932       * rustpkg supports git tags as package IDs.
9933       * rustpkg builds into target-specific directories so it can be used for
9934         cross-compiling.
9935       * The number of concurrent test tasks is controlled by the environment
9936         variable RUST_TEST_TASKS.
9937       * The test harness can now report metrics for benchmarks.
9938       * All tools have man pages.
9939       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9940       * The runtime uses jemalloc for allocations.
9941       * Segmented stacks are temporarily disabled as part of the transition to
9942         the new runtime. Stack overflows are possible!
9943       * A new documentation backend, rustdoc_ng, is available for use. It is
9944         still invoked through the normal `rustdoc` command.
9945
9946
9947 Version 0.7 (2013-07-03)
9948 =======================
9949
9950    * ~2000 changes, numerous bugfixes
9951
9952    * Language
9953       * `impl`s no longer accept a visibility qualifier. Put them on methods
9954         instead.
9955       * The borrow checker has been rewritten with flow-sensitivity, fixing
9956         many bugs and inconveniences.
9957       * The `self` parameter no longer implicitly means `&'self self`,
9958         and can be explicitly marked with a lifetime.
9959       * Overloadable compound operators (`+=`, etc.) have been temporarily
9960         removed due to bugs.
9961       * The `for` loop protocol now requires `for`-iterators to return `bool`
9962         so they compose better.
9963       * The `Durable` trait is replaced with the `'static` bounds.
9964       * Trait default methods work more often.
9965       * Structs with the `#[packed]` attribute have byte alignment and
9966         no padding between fields.
9967       * Type parameters bound by `Copy` must now be copied explicitly with
9968         the `copy` keyword.
9969       * It is now illegal to move out of a dereferenced unsafe pointer.
9970       * `Option<~T>` is now represented as a nullable pointer.
9971       * `@mut` does dynamic borrow checks correctly.
9972       * The `main` function is only detected at the topmost level of the crate.
9973         The `#[main]` attribute is still valid anywhere.
9974       * Struct fields may no longer be mutable. Use inherited mutability.
9975       * The `#[no_send]` attribute makes a type that would otherwise be
9976         `Send`, not.
9977       * The `#[no_freeze]` attribute makes a type that would otherwise be
9978         `Freeze`, not.
9979       * Unbounded recursion will abort the process after reaching the limit
9980         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9981       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9982         are never implicitly copyable.
9983       * `#[static_assert]` makes compile-time assertions about static bools.
9984       * At long last, 'argument modes' no longer exist.
9985       * The rarely used `use mod` statement no longer exists.
9986
9987    * Syntax extensions
9988       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9989         argument list.
9990       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9991         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9992         `#[deriving(...)]`.
9993       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9994         and unsuffixed integer literals.
9995
9996    * Libraries
9997       * The `core` crate was renamed to `std`.
9998       * The `std` crate was renamed to `extra`.
9999       * More and improved documentation.
10000       * std: `iterator` module for external iterator objects.
10001       * Many old-style (internal, higher-order function) iterators replaced by
10002         implementations of `Iterator`.
10003       * std: Many old internal vector and string iterators,
10004         incl. `any`, `all`. removed.
10005       * std: The `finalize` method of `Drop` renamed to `drop`.
10006       * std: The `drop` method now takes `&mut self` instead of `&self`.
10007       * std: The prelude no longer re-exports any modules, only types and traits.
10008       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
10009         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
10010       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
10011         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
10012       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
10013         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
10014       * std: Many types implement `Clone`.
10015       * std: `path` type renamed to `Path`.
10016       * std: `mut` module and `Mut` type removed.
10017       * std: Many standalone functions removed in favor of methods and iterators
10018         in `vec`, `str`. In the future methods will also work as functions.
10019       * std: `reinterpret_cast` removed. Use `transmute`.
10020       * std: ascii string handling in `std::ascii`.
10021       * std: `Rand` is implemented for ~/@.
10022       * std: `run` module for spawning processes overhauled.
10023       * std: Various atomic types added to `unstable::atomic`.
10024       * std: Various types implement `Zero`.
10025       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
10026       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
10027       * std: Added `os::mkdir_recursive`.
10028       * std: Added `os::glob` function performs filesystems globs.
10029       * std: `FuzzyEq` renamed to `ApproxEq`.
10030       * std: `Map` now defines `pop` and `swap` methods.
10031       * std: `Cell` constructors converted to static methods.
10032       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
10033       * extra: `flate` module moved from `std` to `extra`.
10034       * extra: `fileinput` module for iterating over a series of files.
10035       * extra: `Complex` number type and `complex` module.
10036       * extra: `Rational` number type and `rational` module.
10037       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
10038       * extra: `term` uses terminfo now, is more correct.
10039       * extra: `arc` functions converted to methods.
10040       * extra: Implementation of fixed output size variations of SHA-2.
10041
10042    * Tooling
10043       * `unused_variables` lint mode for unused variables (default: warn).
10044       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
10045         (default: warn).
10046       * `unused_mut` lint mode for identifying unused `mut` qualifiers
10047         (default: warn).
10048       * `dead_assignment` lint mode for unread variables (default: warn).
10049       * `unnecessary_allocation` lint mode detects some heap allocations that are
10050         immediately borrowed so could be written without allocating (default: warn).
10051       * `missing_doc` lint mode (default: allow).
10052       * `unreachable_code` lint mode (default: warn).
10053       * The `rusti` command has been rewritten and a number of bugs addressed.
10054       * rustc outputs in color on more terminals.
10055       * rustc accepts a `--link-args` flag to pass arguments to the linker.
10056       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
10057       * Compiling with `-g` will make the binary record information about
10058         dynamic borrowcheck failures for debugging.
10059       * rustdoc has a nicer stylesheet.
10060       * Various improvements to rustdoc.
10061       * Improvements to rustpkg (see the detailed release notes).
10062
10063
10064 Version 0.6 (2013-04-03)
10065 ========================
10066
10067    * ~2100 changes, numerous bugfixes
10068
10069    * Syntax changes
10070       * The self type parameter in traits is now spelled `Self`
10071       * The `self` parameter in trait and impl methods must now be explicitly
10072         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
10073       * Static methods no longer require the `static` keyword and instead
10074         are distinguished by the lack of a `self` parameter
10075       * Replaced the `Durable` trait with the `'static` lifetime
10076       * The old closure type syntax with the trailing sigil has been
10077         removed in favor of the more consistent leading sigil
10078       * `super` is a keyword, and may be prefixed to paths
10079       * Trait bounds are separated with `+` instead of whitespace
10080       * Traits are implemented with `impl Trait for Type`
10081         instead of `impl Type: Trait`
10082       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
10083       * The `export` keyword has finally been removed
10084       * The `move` keyword has been removed (see "Semantic changes")
10085       * The interior mutability qualifier on vectors, `[mut T]`, has been
10086         removed. Use `&mut [T]`, etc.
10087       * `mut` is no longer valid in `~mut T`. Use inherited mutability
10088       * `fail` is no longer a keyword. Use `fail!()`
10089       * `assert` is no longer a keyword. Use `assert!()`
10090       * `log` is no longer a keyword. use `debug!`, etc.
10091       * 1-tuples may be represented as `(T,)`
10092       * Struct fields may no longer be `mut`. Use inherited mutability,
10093         `@mut T`, `core::mut` or `core::cell`
10094       * `extern mod { ... }` is no longer valid syntax for foreign
10095         function modules. Use extern blocks: `extern { ... }`
10096       * Newtype enums removed. Use tuple-structs.
10097       * Trait implementations no longer support visibility modifiers
10098       * Pattern matching over vectors improved and expanded
10099       * `const` renamed to `static` to correspond to lifetime name,
10100         and make room for future `static mut` unsafe mutable globals.
10101       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
10102       * `Clone` implementations can be automatically generated with
10103         `#[deriving(Clone)]`
10104       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
10105         instead of `foo as Bar`.
10106       * Fixed length vector types are now written as `[int, .. 3]`
10107         instead of `[int * 3]`.
10108       * Fixed length vector types can express the length as a constant
10109         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
10110
10111    * Semantic changes
10112       * Types with owned pointers or custom destructors move by default,
10113         eliminating the `move` keyword
10114       * All foreign functions are considered unsafe
10115       * &mut is now unaliasable
10116       * Writes to borrowed @mut pointers are prevented dynamically
10117       * () has size 0
10118       * The name of the main function can be customized using #[main]
10119       * The default type of an inferred closure is &fn instead of @fn
10120       * `use` statements may no longer be "chained" - they cannot import
10121         identifiers imported by previous `use` statements
10122       * `use` statements are crate relative, importing from the "top"
10123         of the crate by default. Paths may be prefixed with `super::`
10124         or `self::` to change the search behavior.
10125       * Method visibility is inherited from the implementation declaration
10126       * Structural records have been removed
10127       * Many more types can be used in static items, including enums
10128         'static-lifetime pointers and vectors
10129       * Pattern matching over vectors improved and expanded
10130       * Typechecking of closure types has been overhauled to
10131         improve inference and eliminate unsoundness
10132       * Macros leave scope at the end of modules, unless that module is
10133         tagged with #[macro_escape]
10134
10135    * Libraries
10136       * Added big integers to `std::bigint`
10137       * Removed `core::oldcomm` module
10138       * Added pipe-based `core::comm` module
10139       * Numeric traits have been reorganized under `core::num`
10140       * `vec::slice` finally returns a slice
10141       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10142       * Containers reorganized around traits in `core::container`
10143       * `core::dvec` removed, `~[T]` is a drop-in replacement
10144       * `core::send_map` renamed to `core::hashmap`
10145       * `std::map` removed; replaced with `core::hashmap`
10146       * `std::treemap` reimplemented as an owned balanced tree
10147       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10148       * `core::trie` added as a fast ordered map for integer keys
10149       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10150       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10151         overload the comparison operators, whereas `TotalOrd` is used
10152         by certain container types
10153
10154    * Other
10155       * Replaced the 'cargo' package manager with 'rustpkg'
10156       * Added all-purpose 'rust' tool
10157       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10158       * rustc now *attempts* to offer spelling suggestions
10159       * Improved support for ARM and Android
10160       * Preliminary MIPS backend
10161       * Improved foreign function ABI implementation for x86, x86_64
10162       * Various memory usage improvements
10163       * Rust code may be embedded in foreign code under limited circumstances
10164       * Inline assembler supported by new asm!() syntax extension.
10165
10166
10167 Version 0.5 (2012-12-21)
10168 ===========================
10169
10170    * ~900 changes, numerous bugfixes
10171
10172    * Syntax changes
10173       * Removed `<-` move operator
10174       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10175       * Removed old fixed length vector syntax - `[T]/N`
10176       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10177       * Macros may now expand to items and statements
10178       * `a.b()` is always parsed as a method call, never as a field projection
10179       * `Eq` and `IterBytes` implementations can be automatically generated
10180         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10181       * Removed the special crate language for `.rc` files
10182       * Function arguments may consist of any irrefutable pattern
10183
10184    * Semantic changes
10185       * `&` and `~` pointers may point to objects
10186       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10187       * Enum variants may be structs
10188       * Destructors can be added to all nominal types with the Drop trait
10189       * Structs and nullary enum variants may be constants
10190       * Values that cannot be implicitly copied are now automatically moved
10191         without writing `move` explicitly
10192       * `&T` may now be coerced to `*T`
10193       * Coercions happen in `let` statements as well as function calls
10194       * `use` statements now take crate-relative paths
10195       * The module and type namespaces have been merged so that static
10196         method names can be resolved under the trait in which they are
10197         declared
10198
10199    * Improved support for language features
10200       * Trait inheritance works in many scenarios
10201       * More support for explicit self arguments in methods - `self`, `&self`
10202         `@self`, and `~self` all generally work as expected
10203       * Static methods work in more situations
10204       * Experimental: Traits may declare default methods for the implementations
10205         to use
10206
10207    * Libraries
10208       * New condition handling system in `core::condition`
10209       * Timsort added to `std::sort`
10210       * New priority queue, `std::priority_queue`
10211       * Pipes for serializable types, `std::flatpipes'
10212       * Serialization overhauled to be trait-based
10213       * Expanded `getopts` definitions
10214       * Moved futures to `std`
10215       * More functions are pure now
10216       * `core::comm` renamed to `oldcomm`. Still deprecated
10217       * `rustdoc` and `cargo` are libraries now
10218
10219    * Misc
10220       * Added a preliminary REPL, `rusti`
10221       * License changed from MIT to dual MIT/APL2
10222
10223
10224 Version 0.4 (2012-10-15)
10225 ==========================
10226
10227    * ~2000 changes, numerous bugfixes
10228
10229    * Syntax
10230       * All keywords are now strict and may not be used as identifiers anywhere
10231       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10232         'of', 'with', 'to', 'class'.
10233       * Classes are replaced with simpler structs
10234       * Explicit method self types
10235       * `ret` became `return` and `alt` became `match`
10236       * `import` is now `use`; `use is now `extern mod`
10237       * `extern mod { ... }` is now `extern { ... }`
10238       * `use mod` is the recommended way to import modules
10239       * `pub` and `priv` replace deprecated export lists
10240       * The syntax of `match` pattern arms now uses fat arrow (=>)
10241       * `main` no longer accepts an args vector; use `os::args` instead
10242
10243    * Semantics
10244       * Trait implementations are now coherent, ala Haskell typeclasses
10245       * Trait methods may be static
10246       * Argument modes are deprecated
10247       * Borrowed pointers are much more mature and recommended for use
10248       * Strings and vectors in the static region are stored in constant memory
10249       * Typestate was removed
10250       * Resolution rewritten to be more reliable
10251       * Support for 'dual-mode' data structures (freezing and thawing)
10252
10253    * Libraries
10254       * Most binary operators can now be overloaded via the traits in
10255         `core::ops'
10256       * `std::net::url` for representing URLs
10257       * Sendable hash maps in `core::send_map`
10258       * `core::task' gained a (currently unsafe) task-local storage API
10259
10260    * Concurrency
10261       * An efficient new intertask communication primitive called the pipe,
10262         along with a number of higher-level channel types, in `core::pipes`
10263       * `std::arc`, an atomically reference counted, immutable, shared memory
10264         type
10265       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10266       * Futures are now based on pipes and sendable
10267       * More robust linked task failure
10268       * Improved task builder API
10269
10270    * Other
10271       * Improved error reporting
10272       * Preliminary JIT support
10273       * Preliminary work on precise GC
10274       * Extensive architectural improvements to rustc
10275       * Begun a transition away from buggy C++-based reflection (shape) code to
10276         Rust-based (visitor) code
10277       * All hash functions and tables converted to secure, randomized SipHash
10278
10279
10280 Version 0.3  (2012-07-12)
10281 ========================
10282
10283    * ~1900 changes, numerous bugfixes
10284
10285    * New coding conveniences
10286       * Integer-literal suffix inference
10287       * Per-item control over warnings, errors
10288       * #[cfg(windows)] and #[cfg(unix)] attributes
10289       * Documentation comments
10290       * More compact closure syntax
10291       * 'do' expressions for treating higher-order functions as
10292         control structures
10293       * *-patterns (wildcard extended to all constructor fields)
10294
10295    * Semantic cleanup
10296       * Name resolution pass and exhaustiveness checker rewritten
10297       * Region pointers and borrow checking supersede alias
10298         analysis
10299       * Init-ness checking is now provided by a region-based liveness
10300         pass instead of the typestate pass; same for last-use analysis
10301       * Extensive work on region pointers
10302
10303    * Experimental new language features
10304       * Slices and fixed-size, interior-allocated vectors
10305       * #!-comments for lang versioning, shell execution
10306       * Destructors and iface implementation for classes;
10307         type-parameterized classes and class methods
10308       * 'const' type kind for types that can be used to implement
10309         shared-memory concurrency patterns
10310
10311    * Type reflection
10312
10313    * Removal of various obsolete features
10314       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10315                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10316
10317       * Constructs: do-while loops ('do' repurposed), fn binding,
10318                     resources (replaced by destructors)
10319
10320    * Compiler reorganization
10321       * Syntax-layer of compiler split into separate crate
10322       * Clang (from LLVM project) integrated into build
10323       * Typechecker split into sub-modules
10324
10325    * New library code
10326       * New time functions
10327       * Extension methods for many built-in types
10328       * Arc: atomic-refcount read-only / exclusive-use shared cells
10329       * Par: parallel map and search routines
10330       * Extensive work on libuv interface
10331       * Much vector code moved to libraries
10332       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10333         #include, #include_str, #include_bin
10334
10335    * Tool improvements
10336       * Cargo automatically resolves dependencies
10337
10338
10339 Version 0.2  (2012-03-29)
10340 =========================
10341
10342    * >1500 changes, numerous bugfixes
10343
10344    * New docs and doc tooling
10345
10346    * New port: FreeBSD x86_64
10347
10348    * Compilation model enhancements
10349       * Generics now specialized, multiply instantiated
10350       * Functions now inlined across separate crates
10351
10352    * Scheduling, stack and threading fixes
10353       * Noticeably improved message-passing performance
10354       * Explicit schedulers
10355       * Callbacks from C
10356       * Helgrind clean
10357
10358    * Experimental new language features
10359       * Operator overloading
10360       * Region pointers
10361       * Classes
10362
10363    * Various language extensions
10364       * C-callback function types: 'crust fn ...'
10365       * Infinite-loop construct: 'loop { ... }'
10366       * Shorten 'mutable' to 'mut'
10367       * Required mutable-local qualifier: 'let mut ...'
10368       * Basic glob-exporting: 'export foo::*;'
10369       * Alt now exhaustive, 'alt check' for runtime-checked
10370       * Block-function form of 'for' loop, with 'break' and 'ret'.
10371
10372    * New library code
10373       * AST quasi-quote syntax extension
10374       * Revived libuv interface
10375       * New modules: core::{future, iter}, std::arena
10376       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10377       * Extensive cleanup, regularization in libstd, libcore
10378
10379
10380 Version 0.1  (2012-01-20)
10381 ===============================
10382
10383    * Most language features work, including:
10384       * Unique pointers, unique closures, move semantics
10385       * Interface-constrained generics
10386       * Static interface dispatch
10387       * Stack growth
10388       * Multithread task scheduling
10389       * Typestate predicates
10390       * Failure unwinding, destructors
10391       * Pattern matching and destructuring assignment
10392       * Lightweight block-lambda syntax
10393       * Preliminary macro-by-example
10394
10395    * Compiler works with the following configurations:
10396       * Linux: x86 and x86_64 hosts and targets
10397       * macOS: x86 and x86_64 hosts and targets
10398       * Windows: x86 hosts and targets
10399
10400    * Cross compilation / multi-target configuration supported.
10401
10402    * Preliminary API-documentation and package-management tools included.
10403
10404 Known issues:
10405
10406    * Documentation is incomplete.
10407
10408    * Performance is below intended target.
10409
10410    * Standard library APIs are subject to extensive change, reorganization.
10411
10412    * Language-level versioning is not yet operational - future code will
10413      break unexpectedly.