]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Use Places to express closure/generator Captures
[rust.git] / RELEASES.md
1 Version 1.47.0 (2020-10-08)
2 ==========================
3
4 Language
5 --------
6 - [Closures will now warn when not used.][74869]
7
8 Compiler
9 --------
10 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
11   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
12   platforms.
13 - [Upgraded to LLVM 11.][73526]
14 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
15 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
16 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
17
18 \* Refer to Rust's [platform support page][forge-platform-support] for more
19 information on Rust's tiered platform support.
20
21 Libraries
22 ---------
23 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
24 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
25   those of length less than 33.][74060]
26 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
27 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
28   `PartialEq`, and `PartialOrd`.][73583]
29
30 Stabilized APIs
31 ---------------
32 - [`Ident::new_raw`]
33 - [`Range::is_empty`]
34 - [`RangeInclusive::is_empty`]
35 - [`Result::as_deref`]
36 - [`Result::as_deref_mut`]
37 - [`Vec::leak`]
38 - [`pointer::offset_from`]
39 - [`f32::TAU`]
40 - [`f64::TAU`]
41
42 The following previously stable APIs have now been made const.
43
44 - [The `new` method for all `NonZero` integers.][73858]
45 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
46   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
47   methods for all integers.][73858]
48 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
49   signed integers.][73858]
50 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
51   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
52   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
53   `is_ascii_control` methods for `char` and `u8`.][73858]
54
55 Cargo
56 -----
57 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
58   You can override this by setting the following in your `Cargo.toml`.
59   ```toml
60   [profile.release.build-override]
61   opt-level = 3
62   ```
63 - [`cargo-help` will now display man pages for commands rather just the
64   `--help` text.][cargo/8456]
65 - [`cargo-metadata` now emits a `test` field indicating if a target has
66   tests enabled.][cargo/8478]
67 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
68 - [`cargo-publish` will now use an alternative registry by default if it's the
69   only registry specified in `package.publish`.][cargo/8571]
70
71 Misc
72 ----
73 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
74   type based search.][75366]
75 - [Added the Ayu theme to rustdoc.][71237]
76
77 Compatibility Notes
78 -------------------
79 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
80 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
81 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
82   help to preserve more span information.][73084] These changes may cause
83   compiliation errors if your macro was unhygenic or didn't correctly handle
84   `Delimiter::None`.
85 - [Moved support for the CloudABI target to tier 3.][75568]
86 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
87 - [Added the `rustc-docs` component.][75560] This allows you to install
88   and read the documentation for the compiler internal APIs. (Currently only
89   available for `x86_64-unknown-linux-gnu`.)
90
91 Internal Only
92 --------
93 - [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.
94
95 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
96 [75048]: https://github.com/rust-lang/rust/pull/75048/
97 [74163]: https://github.com/rust-lang/rust/pull/74163/
98 [71237]: https://github.com/rust-lang/rust/pull/71237/
99 [74869]: https://github.com/rust-lang/rust/pull/74869/
100 [73858]: https://github.com/rust-lang/rust/pull/73858/
101 [75716]: https://github.com/rust-lang/rust/pull/75716/
102 [75908]: https://github.com/rust-lang/rust/pull/75908/
103 [75516]: https://github.com/rust-lang/rust/pull/75516/
104 [75560]: https://github.com/rust-lang/rust/pull/75560/
105 [75568]: https://github.com/rust-lang/rust/pull/75568/
106 [75366]: https://github.com/rust-lang/rust/pull/75366/
107 [75204]: https://github.com/rust-lang/rust/pull/75204/
108 [74650]: https://github.com/rust-lang/rust/pull/74650/
109 [74419]: https://github.com/rust-lang/rust/pull/74419/
110 [73964]: https://github.com/rust-lang/rust/pull/73964/
111 [74021]: https://github.com/rust-lang/rust/pull/74021/
112 [74060]: https://github.com/rust-lang/rust/pull/74060/
113 [73893]: https://github.com/rust-lang/rust/pull/73893/
114 [73526]: https://github.com/rust-lang/rust/pull/73526/
115 [73583]: https://github.com/rust-lang/rust/pull/73583/
116 [73084]: https://github.com/rust-lang/rust/pull/73084/
117 [73197]: https://github.com/rust-lang/rust/pull/73197/
118 [72488]: https://github.com/rust-lang/rust/pull/72488/
119 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
120 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
121 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
122 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
123 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
124 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
125 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
126 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
127 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
128 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
129 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
130 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
131 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
132 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
133 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
134
135
136 Version 1.46.0 (2020-08-27)
137 ==========================
138
139 Language
140 --------
141 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
142 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
143   const functions.][73862]
144 - [The `#[track_caller]` attribute can now be added to functions to use the
145   function's caller's location information for panic messages.][72445]
146 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
147   `x.0.0` over `(x.0).0`.
148 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
149   You currently can't use `mem::transmute` in constant functions.
150
151 Compiler
152 --------
153 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
154 - [Enabled static "Position Independent Executables" by default
155   for `x86_64-unknown-linux-musl`.][70740]
156
157 Libraries
158 ---------
159 - [`mem::forget` is now a `const fn`.][73887]
160 - [`String` now implements `From<char>`.][73466]
161 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
162   integer types.][73032]
163 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
164 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
165   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
166 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
167 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
168 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
169
170 Stabilized APIs
171 ---------------
172 - [`Option::zip`]
173 - [`vec::Drain::as_slice`]
174
175 Cargo
176 -----
177 Added a number of new environment variables that are now available when
178 compiling your crate.
179
180 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
181   the specific binary being compiled and the name of the crate.
182 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
183 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
184
185 Compatibility Notes
186 -------------------
187 - [The target configuration option `abi_blacklist` has been renamed
188   to `unsupported_abis`.][74150] The old name will still continue to work.
189 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
190   This was previously accepted but will become a hard error in a future release.
191 - [Rustc will fail to compile if you have a struct with
192   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
193   allowed on `enum`s.
194 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
195   ensure that spans have the correct information, and may cause breakage if you
196   were relying on receiving spans with dummy information.
197 - [The InnoSetup installer for Windows is no longer available.][72569] This was
198   a legacy installer that was replaced by a MSI installer a few years ago but
199   was still being built.
200 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
201 - [Rustc will no longer accept overlapping trait implementations that only
202   differ in how the lifetime was bound.][72493]
203 - [Rustc now correctly relates the lifetime of an existential associated
204   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
205   you to pass a shorter lifetime than expected.
206 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
207   The library will need to be installed for `rustc` to work, even though we
208   expect it to be already available on most systems.
209 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
210   under QEMU.][74820]
211 - [Pretty printing of some tokens in procedural macros changed.][75453] The
212   exact output returned by rustc's pretty printing is an unstable
213   implementation detail: we recommend any macro relying on it to switch to a
214   more robust parsing system.
215
216 [75453]: https://github.com/rust-lang/rust/issues/75453/
217 [74820]: https://github.com/rust-lang/rust/issues/74820/
218 [74420]: https://github.com/rust-lang/rust/issues/74420/
219 [74109]: https://github.com/rust-lang/rust/pull/74109/
220 [74150]: https://github.com/rust-lang/rust/pull/74150/
221 [73862]: https://github.com/rust-lang/rust/pull/73862/
222 [73887]: https://github.com/rust-lang/rust/pull/73887/
223 [73466]: https://github.com/rust-lang/rust/pull/73466/
224 [73516]: https://github.com/rust-lang/rust/pull/73516/
225 [73293]: https://github.com/rust-lang/rust/pull/73293/
226 [73007]: https://github.com/rust-lang/rust/pull/73007/
227 [73032]: https://github.com/rust-lang/rust/pull/73032/
228 [72920]: https://github.com/rust-lang/rust/pull/72920/
229 [72569]: https://github.com/rust-lang/rust/pull/72569/
230 [72583]: https://github.com/rust-lang/rust/pull/72583/
231 [72584]: https://github.com/rust-lang/rust/pull/72584/
232 [72717]: https://github.com/rust-lang/rust/pull/72717/
233 [72437]: https://github.com/rust-lang/rust/pull/72437/
234 [72445]: https://github.com/rust-lang/rust/pull/72445/
235 [72486]: https://github.com/rust-lang/rust/pull/72486/
236 [72493]: https://github.com/rust-lang/rust/pull/72493/
237 [72331]: https://github.com/rust-lang/rust/pull/72331/
238 [71896]: https://github.com/rust-lang/rust/pull/71896/
239 [71660]: https://github.com/rust-lang/rust/pull/71660/
240 [71322]: https://github.com/rust-lang/rust/pull/71322/
241 [70740]: https://github.com/rust-lang/rust/pull/70740/
242 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
243 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
244 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
245 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
246 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
247
248
249 Version 1.45.2 (2020-08-03)
250 ==========================
251
252 * [Fix bindings in tuple struct patterns][74954]
253 * [Fix track_caller integration with trait objects][74784]
254
255 [74954]: https://github.com/rust-lang/rust/issues/74954
256 [74784]: https://github.com/rust-lang/rust/issues/74784
257
258
259 Version 1.45.1 (2020-07-30)
260 ==========================
261
262 * [Fix const propagation with references.][73613]
263 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
264 * [Avoid spurious implicit region bound.][74509]
265 * [Install clippy on x.py install][74457]
266
267 [73613]: https://github.com/rust-lang/rust/pull/73613
268 [73078]: https://github.com/rust-lang/rust/issues/73078
269 [74509]: https://github.com/rust-lang/rust/pull/74509
270 [74457]: https://github.com/rust-lang/rust/pull/74457
271
272
273 Version 1.45.0 (2020-07-16)
274 ==========================
275
276 Language
277 --------
278 - [Out of range float to int conversions using `as` has been defined as a saturating
279   conversion.][71269] This was previously undefined behaviour, but you can use the
280    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
281    may be desirable in rare performance sensitive situations.
282 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
283   using `u64`.][70705]
284 - [Function like procedural macros can now be used in expression, pattern, and  statement
285   positions.][68717] This means you can now use a function-like procedural macro
286   anywhere you can use a declarative (`macro_rules!`) macro.
287
288 Compiler
289 --------
290 - [You can now override individual target features through the `target-feature`
291   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
292   equivalent to `-C target-feature=+avx2,+fma`.
293 - [Added the `force-unwind-tables` flag.][69984] This option allows
294   rustc to always generate unwind tables regardless of panic strategy.
295 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
296   to include LLVM bitcode into generated `rlib`s (this is on by default).
297 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
298 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
299 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
300 - [Upgraded to LLVM 10.][67759]
301
302 \* Refer to Rust's [platform support page][forge-platform-support] for more
303 information on Rust's tiered platform support.
304
305
306 Libraries
307 ---------
308 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
309   and `Ord`.][72239]
310 - [`proc_macro::TokenStream` now implements `Default`.][72234]
311 - [You can now use `char` with
312   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
313   a range of codepoints.][72413] E.g.
314   you can now write the following;
315   ```rust
316   for ch in 'a'..='z' {
317       print!("{}", ch);
318   }
319   println!();
320   // Prints "abcdefghijklmnopqrstuvwxyz"
321   ```
322 - [`OsString` now implements `FromStr`.][71662]
323 - [The `saturating_neg` method has been added to all signed integer primitive
324   types, and the `saturating_abs` method has been added for all integer
325   primitive types.][71886]
326 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
327   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
328   or `Path`.][71447]
329 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
330 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
331   integer types.][69813]
332 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
333   integer types.][72324]
334 - [The `fetch_update` method has been added to all atomic integer types.][71843]
335
336 Stabilized APIs
337 ---------------
338 - [`Arc::as_ptr`]
339 - [`BTreeMap::remove_entry`]
340 - [`Rc::as_ptr`]
341 - [`rc::Weak::as_ptr`]
342 - [`rc::Weak::from_raw`]
343 - [`rc::Weak::into_raw`]
344 - [`str::strip_prefix`]
345 - [`str::strip_suffix`]
346 - [`sync::Weak::as_ptr`]
347 - [`sync::Weak::from_raw`]
348 - [`sync::Weak::into_raw`]
349 - [`char::UNICODE_VERSION`]
350 - [`Span::resolved_at`]
351 - [`Span::located_at`]
352 - [`Span::mixed_site`]
353 - [`unix::process::CommandExt::arg0`]
354
355 Cargo
356 -----
357
358 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
359   time.][cargo/8066]
360
361 Misc
362 ----
363 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
364   `~~outdated information~~` becomes "~~outdated information~~".
365 - [Added an emoji to Rustdoc's deprecated API message.][72014]
366
367 Compatibility Notes
368 -------------------
369 - [Trying to self initialize a static value (that is creating a value using
370   itself) is unsound and now causes a compile error.][71140]
371 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
372   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
373 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
374   previously undocumented and not intended for public use. Rustdoc still provides
375   a non-zero exit code on errors.
376 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
377   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
378   flags while cargo is adding `embed-bitcode` itself. The recommended way to
379   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
380   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
381
382 Internals Only
383 --------------
384 - [Make clippy a git subtree instead of a git submodule][70655]
385 - [Unify the undo log of all snapshot types][69464]
386
387 [71848]: https://github.com/rust-lang/rust/issues/71848/
388 [73420]: https://github.com/rust-lang/rust/issues/73420/
389 [72324]: https://github.com/rust-lang/rust/pull/72324/
390 [71843]: https://github.com/rust-lang/rust/pull/71843/
391 [71886]: https://github.com/rust-lang/rust/pull/71886/
392 [72234]: https://github.com/rust-lang/rust/pull/72234/
393 [72239]: https://github.com/rust-lang/rust/pull/72239/
394 [72397]: https://github.com/rust-lang/rust/pull/72397/
395 [72413]: https://github.com/rust-lang/rust/pull/72413/
396 [72014]: https://github.com/rust-lang/rust/pull/72014/
397 [72062]: https://github.com/rust-lang/rust/pull/72062/
398 [72094]: https://github.com/rust-lang/rust/pull/72094/
399 [72133]: https://github.com/rust-lang/rust/pull/72133/
400 [67759]: https://github.com/rust-lang/rust/pull/67759/
401 [71900]: https://github.com/rust-lang/rust/pull/71900/
402 [71928]: https://github.com/rust-lang/rust/pull/71928/
403 [71662]: https://github.com/rust-lang/rust/pull/71662/
404 [71716]: https://github.com/rust-lang/rust/pull/71716/
405 [71447]: https://github.com/rust-lang/rust/pull/71447/
406 [71269]: https://github.com/rust-lang/rust/pull/71269/
407 [71095]: https://github.com/rust-lang/rust/pull/71095/
408 [71140]: https://github.com/rust-lang/rust/pull/71140/
409 [70655]: https://github.com/rust-lang/rust/pull/70655/
410 [70705]: https://github.com/rust-lang/rust/pull/70705/
411 [69984]: https://github.com/rust-lang/rust/pull/69984/
412 [69813]: https://github.com/rust-lang/rust/pull/69813/
413 [69464]: https://github.com/rust-lang/rust/pull/69464/
414 [68717]: https://github.com/rust-lang/rust/pull/68717/
415 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
416 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
417 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
418 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
419 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
420 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
421 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
422 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
423 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
424 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
425 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
426 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
427 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
428 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
429 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
430 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
431 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
432
433
434 Version 1.44.1 (2020-06-18)
435 ===========================
436
437 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
438 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
439 * [Fix crashes when finding backtrace on macOS.][71397]
440 * [Clippy applies lint levels into different files.][clippy/5356]
441
442 [71397]: https://github.com/rust-lang/rust/issues/71397
443 [73078]: https://github.com/rust-lang/rust/issues/73078
444 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
445 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
446
447
448 Version 1.44.0 (2020-06-04)
449 ==========================
450
451 Language
452 --------
453 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
454 - [Added the `unused_braces` lint.][70081]
455
456 **Syntax-only changes**
457
458 - [Expansion-driven outline module parsing][69838]
459 ```rust
460 #[cfg(FALSE)]
461 mod foo {
462     mod bar {
463         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
464     }
465 }
466 ```
467
468 These are still rejected semantically, so you will likely receive an error but
469 these changes can be seen and parsed by macros and conditional compilation.
470
471 Compiler
472 --------
473 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
474   Additionally when in incremental mode rustc defaults to 256 codegen units.
475 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
476   a panic is thrown.][67502]
477 - [Added tier 3\* support for the `aarch64-unknown-none` and
478   `aarch64-unknown-none-softfloat` targets.][68334]
479 - [Added tier 3 support for `arm64-apple-tvos` and
480   `x86_64-apple-tvos` targets.][68191]
481
482
483 Libraries
484 ---------
485 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
486   `vec![]` to be able to be used in `const` contexts.
487 - [`convert::Infallible` now implements `Hash`.][70281]
488 - [`OsString` now implements `DerefMut` and `IndexMut` returning
489   a `&mut OsStr`.][70048]
490 - [Unicode 13 is now supported.][69929]
491 - [`String` now implements `From<&mut str>`.][69661]
492 - [`IoSlice` now implements `Copy`.][69403]
493 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
494 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
495 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
496   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
497   integer types.][69373]
498
499 Stabilized APIs
500 ---------------
501 - [`PathBuf::with_capacity`]
502 - [`PathBuf::capacity`]
503 - [`PathBuf::clear`]
504 - [`PathBuf::reserve`]
505 - [`PathBuf::reserve_exact`]
506 - [`PathBuf::shrink_to_fit`]
507 - [`f32::to_int_unchecked`]
508 - [`f64::to_int_unchecked`]
509 - [`Layout::align_to`]
510 - [`Layout::pad_to_align`]
511 - [`Layout::array`]
512 - [`Layout::extend`]
513
514 Cargo
515 -----
516 - [Added the `cargo tree` command which will print a tree graph of
517   your dependencies.][cargo/8062] E.g.
518   ```
519     mdbook v0.3.2 (/Users/src/rust/mdbook)
520   ├── ammonia v3.0.0
521   │   ├── html5ever v0.24.0
522   │   │   ├── log v0.4.8
523   │   │   │   └── cfg-if v0.1.9
524   │   │   ├── mac v0.1.1
525   │   │   └── markup5ever v0.9.0
526   │   │       ├── log v0.4.8 (*)
527   │   │       ├── phf v0.7.24
528   │   │       │   └── phf_shared v0.7.24
529   │   │       │       ├── siphasher v0.2.3
530   │   │       │       └── unicase v1.4.2
531   │   │       │           [build-dependencies]
532   │   │       │           └── version_check v0.1.5
533   ...
534   ```
535   You can also display dependencies on multiple versions of the same crate with
536   `cargo tree -d` (short for `cargo tree --duplicates`).
537
538 Misc
539 ----
540 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
541   the version in the sidebar.][69494]
542
543 Compatibility Notes
544 -------------------
545 - [Rustc now correctly generates static libraries on Windows GNU targets with
546   the `.a` extension, rather than the previous `.lib`.][70937]
547 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
548 - [The `file_name` property in JSON output of macro errors now points the actual
549   source file rather than the previous format of `<NAME macros>`.][70969]
550   **Note:** this may not point to a file that actually exists on the user's system.
551 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
552 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
553   not allow zero initialization such as `NonZeroU8`.][66059] This was
554   previously a warning.
555 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
556   operator has been defined as a saturating operation.][71269] This was previously
557   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
558   continue using the current behaviour, which may be desirable in rare performance
559   sensitive situations.
560
561 Internal Only
562 -------------
563 These changes provide no direct user facing benefits, but represent significant
564 improvements to the internals and overall performance of rustc and
565 related tools.
566
567 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
568 - [Replace big JS dict with JSON parsing.][71250]
569
570 [69373]: https://github.com/rust-lang/rust/pull/69373/
571 [66059]: https://github.com/rust-lang/rust/pull/66059/
572 [68191]: https://github.com/rust-lang/rust/pull/68191/
573 [68899]: https://github.com/rust-lang/rust/pull/68899/
574 [71147]: https://github.com/rust-lang/rust/pull/71147/
575 [71250]: https://github.com/rust-lang/rust/pull/71250/
576 [70937]: https://github.com/rust-lang/rust/pull/70937/
577 [70969]: https://github.com/rust-lang/rust/pull/70969/
578 [70632]: https://github.com/rust-lang/rust/pull/70632/
579 [70281]: https://github.com/rust-lang/rust/pull/70281/
580 [70345]: https://github.com/rust-lang/rust/pull/70345/
581 [70048]: https://github.com/rust-lang/rust/pull/70048/
582 [70081]: https://github.com/rust-lang/rust/pull/70081/
583 [70156]: https://github.com/rust-lang/rust/pull/70156/
584 [71269]: https://github.com/rust-lang/rust/pull/71269/
585 [69838]: https://github.com/rust-lang/rust/pull/69838/
586 [69929]: https://github.com/rust-lang/rust/pull/69929/
587 [69661]: https://github.com/rust-lang/rust/pull/69661/
588 [69778]: https://github.com/rust-lang/rust/pull/69778/
589 [69494]: https://github.com/rust-lang/rust/pull/69494/
590 [69403]: https://github.com/rust-lang/rust/pull/69403/
591 [69033]: https://github.com/rust-lang/rust/pull/69033/
592 [68692]: https://github.com/rust-lang/rust/pull/68692/
593 [68334]: https://github.com/rust-lang/rust/pull/68334/
594 [67502]: https://github.com/rust-lang/rust/pull/67502/
595 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
596 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
597 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
598 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
599 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
600 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
601 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
602 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
603 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
604 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
605 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
606 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
607 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
608
609
610 Version 1.43.1 (2020-05-07)
611 ===========================
612
613 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
614 * [Fixed the stabilization of AVX-512 features.][71473]
615 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
616
617 [71430]: https://github.com/rust-lang/rust/pull/71430
618 [71473]: https://github.com/rust-lang/rust/issues/71473
619 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
620
621
622 Version 1.43.0 (2020-04-23)
623 ==========================
624
625 Language
626 --------
627 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
628   the type inferred correctly.][68129]
629 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
630
631 **Syntax only changes**
632 - [Allow `type Foo: Ord` syntactically.][69361]
633 - [Fuse associated and extern items up to defaultness.][69194]
634 - [Syntactically allow `self` in all `fn` contexts.][68764]
635 - [Merge `fn` syntax + cleanup item parsing.][68728]
636 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
637   For example, you may now write:
638   ```rust
639   macro_rules! mac_trait {
640       ($i:item) => {
641           trait T { $i }
642       }
643   }
644   mac_trait! {
645       fn foo() {}
646   }
647   ```
648
649 These are still rejected *semantically*, so you will likely receive an error but
650 these changes can be seen and parsed by macros and
651 conditional compilation.
652
653
654 Compiler
655 --------
656 - [You can now pass multiple lint flags to rustc to override the previous
657   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
658   everything in the `unused` lint group except `unused-variables` which
659   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
660   everything in the `unused` lint group **including** `unused-variables` since
661   the allow flag is specified before the deny flag (and therefore overridden).
662 - [rustc will now prefer your system MinGW libraries over its bundled libraries
663   if they are available on `windows-gnu`.][67429]
664 - [rustc now buffers errors/warnings printed in JSON.][69227]
665
666 Libraries
667 ---------
668 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
669   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
670   respectively.][69538] **Note** These conversions are only available when `N`
671   is `0..=32`.
672 - [You can now use associated constants on floats and integers directly, rather
673   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
674   `f32::NAN` with no imports.
675 - [`u8::is_ascii` is now `const`.][68984]
676 - [`String` now implements `AsMut<str>`.][68742]
677 - [Added the `primitive` module to `std` and `core`.][67637] This module
678   reexports Rust's primitive types. This is mainly useful in macros
679   where you want avoid these types being shadowed.
680 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
681 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
682
683 Stabilized APIs
684 ---------------
685 - [`Once::is_completed`]
686 - [`f32::LOG10_2`]
687 - [`f32::LOG2_10`]
688 - [`f64::LOG10_2`]
689 - [`f64::LOG2_10`]
690 - [`iter::once_with`]
691
692 Cargo
693 -----
694 - [You can now set config `[profile]`s in your `.cargo/config`, or through
695   your environment.][cargo/7823]
696 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
697   executable path when running integration tests or benchmarks.][cargo/7697]
698   `<name>` is the name of your binary as-is e.g. If you wanted the executable
699   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
700
701 Misc
702 ----
703 - [Certain checks in the `const_err` lint were deemed unrelated to const
704   evaluation][69185], and have been moved to the `unconditional_panic` and
705   `arithmetic_overflow` lints.
706
707 Compatibility Notes
708 -------------------
709
710 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
711   has been a warning since 1.36.0.
712 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
713   led to some instances being accepted, and now correctly emits a hard error.
714
715 [69340]: https://github.com/rust-lang/rust/pull/69340
716
717 Internal Only
718 -------------
719 These changes provide no direct user facing benefits, but represent significant
720 improvements to the internals and overall performance of `rustc` and
721 related tools.
722
723 - [All components are now built with `opt-level=3` instead of `2`.][67878]
724 - [Improved how rustc generates drop code.][67332]
725 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
726 - [traits: preallocate 2 Vecs of known initial size][69022]
727 - [Avoid exponential behaviour when relating types][68772]
728 - [Skip `Drop` terminators for enum variants without drop glue][68943]
729 - [Improve performance of coherence checks][68966]
730 - [Deduplicate types in the generator witness][68672]
731 - [Invert control in struct_lint_level.][68725]
732
733 [67332]: https://github.com/rust-lang/rust/pull/67332/
734 [67429]: https://github.com/rust-lang/rust/pull/67429/
735 [67637]: https://github.com/rust-lang/rust/pull/67637/
736 [67642]: https://github.com/rust-lang/rust/pull/67642/
737 [67878]: https://github.com/rust-lang/rust/pull/67878/
738 [67885]: https://github.com/rust-lang/rust/pull/67885/
739 [68129]: https://github.com/rust-lang/rust/pull/68129/
740 [68672]: https://github.com/rust-lang/rust/pull/68672/
741 [68725]: https://github.com/rust-lang/rust/pull/68725/
742 [68728]: https://github.com/rust-lang/rust/pull/68728/
743 [68738]: https://github.com/rust-lang/rust/pull/68738/
744 [68742]: https://github.com/rust-lang/rust/pull/68742/
745 [68764]: https://github.com/rust-lang/rust/pull/68764/
746 [68772]: https://github.com/rust-lang/rust/pull/68772/
747 [68943]: https://github.com/rust-lang/rust/pull/68943/
748 [68952]: https://github.com/rust-lang/rust/pull/68952/
749 [68966]: https://github.com/rust-lang/rust/pull/68966/
750 [68984]: https://github.com/rust-lang/rust/pull/68984/
751 [69022]: https://github.com/rust-lang/rust/pull/69022/
752 [69185]: https://github.com/rust-lang/rust/pull/69185/
753 [69194]: https://github.com/rust-lang/rust/pull/69194/
754 [69201]: https://github.com/rust-lang/rust/pull/69201/
755 [69227]: https://github.com/rust-lang/rust/pull/69227/
756 [69548]: https://github.com/rust-lang/rust/pull/69548/
757 [69256]: https://github.com/rust-lang/rust/pull/69256/
758 [69361]: https://github.com/rust-lang/rust/pull/69361/
759 [69366]: https://github.com/rust-lang/rust/pull/69366/
760 [69538]: https://github.com/rust-lang/rust/pull/69538/
761 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
762 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
763 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
764 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
765 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
766 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
767 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
768 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
769
770
771 Version 1.42.0 (2020-03-12)
772 ==========================
773
774 Language
775 --------
776 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
777   ```rust
778   fn foo(words: &[&str]) {
779       match words {
780           ["Hello", "World", "!", ..] => println!("Hello World!"),
781           ["Foo", "Bar", ..] => println!("Baz"),
782           rest => println!("{:?}", rest),
783       }
784   }
785   ```
786 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
787   that you can create an enum that has the exact layout and ABI of the type
788   it contains.
789 - [There are some *syntax-only* changes:][67131]
790    - `default` is syntactically allowed before items in `trait` definitions.
791    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
792      leave out their bodies in favor of `;`.
793    - Bounds on associated types in `impl`s are now syntactically allowed
794      (e.g. `type Foo: Ord;`).
795    - `...` (the C-variadic type) may occur syntactically directly as the type of
796       any function parameter.
797
798   These are still rejected *semantically*, so you will likely receive an error
799   but these changes can be seen and parsed by procedural macros and
800   conditional compilation.
801
802 Compiler
803 --------
804 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
805 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
806 - [`Option::{expect,unwrap}` and
807    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
808    pointing to the location where they were called, rather than
809    `core`'s internals. ][67887]
810
811 \* Refer to Rust's [platform support page][forge-platform-support] for more
812 information on Rust's tiered platform support.
813
814 Libraries
815 ---------
816 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
817 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
818    to implement `Sized`.][67935]
819 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
820 - [`Layout::new` is now `const`.][66254]
821 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
822
823
824 Stabilized APIs
825 ---------------
826 - [`CondVar::wait_while`]
827 - [`CondVar::wait_timeout_while`]
828 - [`DebugMap::key`]
829 - [`DebugMap::value`]
830 - [`ManuallyDrop::take`]
831 - [`matches!`]
832 - [`ptr::slice_from_raw_parts_mut`]
833 - [`ptr::slice_from_raw_parts`]
834
835 Cargo
836 -----
837 - [You no longer need to include `extern crate proc_macro;` to be able to
838   `use proc_macro;` in the `2018` edition.][cargo/7700]
839
840 Compatibility Notes
841 -------------------
842 - [`Error::description` has been deprecated, and its use will now produce a
843   warning.][66919] It's recommended to use `Display`/`to_string` instead.
844
845 [68253]: https://github.com/rust-lang/rust/pull/68253/
846 [68348]: https://github.com/rust-lang/rust/pull/68348/
847 [67935]: https://github.com/rust-lang/rust/pull/67935/
848 [68339]: https://github.com/rust-lang/rust/pull/68339/
849 [68122]: https://github.com/rust-lang/rust/pull/68122/
850 [67712]: https://github.com/rust-lang/rust/pull/67712/
851 [67887]: https://github.com/rust-lang/rust/pull/67887/
852 [67131]: https://github.com/rust-lang/rust/pull/67131/
853 [67233]: https://github.com/rust-lang/rust/pull/67233/
854 [66899]: https://github.com/rust-lang/rust/pull/66899/
855 [66919]: https://github.com/rust-lang/rust/pull/66919/
856 [66254]: https://github.com/rust-lang/rust/pull/66254/
857 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
858 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
859 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
860 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
861 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
862 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
863 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
864 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
865 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
866
867
868 Version 1.41.1 (2020-02-27)
869 ===========================
870
871 * [Always check types of static items][69145]
872 * [Always check lifetime bounds of `Copy` impls][69145]
873 * [Fix miscompilation in callers of `Layout::repeat`][69225]
874
875 [69225]: https://github.com/rust-lang/rust/issues/69225
876 [69145]: https://github.com/rust-lang/rust/pull/69145
877
878
879 Version 1.41.0 (2020-01-30)
880 ===========================
881
882 Language
883 --------
884
885 - [You can now pass type parameters to foreign items when implementing
886   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
887 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
888   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
889   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
890 - [You can now use any valid identifier in a `format_args` macro.][66847]
891   Previously identifiers starting with an underscore were not allowed.
892 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
893   enum variants.][66183] These are still rejected semantically, but
894   can be seen and parsed by procedural macros and conditional compilation.
895
896 Compiler
897 --------
898
899 - [Rustc will now warn if you have unused loop `'label`s.][66325]
900 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
901 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
902 - [You can now pass an arguments file passing the `@path` syntax
903   to rustc.][66172] Note that the format differs somewhat from what is
904   found in other tooling; please see [the documentation][argfile-docs] for
905   more information.
906 - [You can now provide `--extern` flag without a path, indicating that it is
907   available from the search path or specified with an `-L` flag.][64882]
908
909 \* Refer to Rust's [platform support page][forge-platform-support] for more
910 information on Rust's tiered platform support.
911
912 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
913
914 Libraries
915 ---------
916
917 - [The `core::panic` module is now stable.][66771] It was already stable
918   through `std`.
919 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
920   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
921 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
922
923 Stabilized APIs
924 ---------------
925
926 - [`Result::map_or`]
927 - [`Result::map_or_else`]
928 - [`std::rc::Weak::weak_count`]
929 - [`std::rc::Weak::strong_count`]
930 - [`std::sync::Weak::weak_count`]
931 - [`std::sync::Weak::strong_count`]
932
933 Cargo
934 -----
935
936 - [Cargo will now document all the private items for binary crates
937   by default.][cargo/7593]
938 - [`cargo-install` will now reinstall the package if it detects that it is out
939   of date.][cargo/7560]
940 - [Cargo.lock now uses a more git friendly format that should help to reduce
941   merge conflicts.][cargo/7579]
942 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
943   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
944   optimisation level to `2` for debug builds. You can also use
945   `[profile.<profile>.build-override]` to override build scripts and
946   their dependencies.
947
948 Misc
949 ----
950
951 - [You can now specify `edition` in documentation code blocks to compile the block
952   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
953   should be compiled the 2018 edition of Rust.
954 - [You can now provide custom themes to rustdoc with `--theme`, and check the
955   current theme with `--check-theme`.][54733]
956 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
957
958 Compatibility Notes
959 -------------------
960
961 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
962   Apple targets.][apple-32bit-drop] This means that the source code is still
963   available to build, but the targets are no longer being tested and release
964   binaries for those platforms will no longer be distributed by the Rust project.
965   Please refer to the linked blog post for more information.
966
967 [54733]: https://github.com/rust-lang/rust/pull/54733/
968 [61351]: https://github.com/rust-lang/rust/pull/61351/
969 [67255]: https://github.com/rust-lang/rust/pull/67255/
970 [66661]: https://github.com/rust-lang/rust/pull/66661/
971 [66771]: https://github.com/rust-lang/rust/pull/66771/
972 [66847]: https://github.com/rust-lang/rust/pull/66847/
973 [66238]: https://github.com/rust-lang/rust/pull/66238/
974 [66277]: https://github.com/rust-lang/rust/pull/66277/
975 [66325]: https://github.com/rust-lang/rust/pull/66325/
976 [66172]: https://github.com/rust-lang/rust/pull/66172/
977 [66183]: https://github.com/rust-lang/rust/pull/66183/
978 [65879]: https://github.com/rust-lang/rust/pull/65879/
979 [65013]: https://github.com/rust-lang/rust/pull/65013/
980 [64882]: https://github.com/rust-lang/rust/pull/64882/
981 [64325]: https://github.com/rust-lang/rust/pull/64325/
982 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
983 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
984 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
985 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
986 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
987 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
988 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
989 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
990 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
991 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
992 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
993
994 Version 1.40.0 (2019-12-19)
995 ===========================
996
997 Language
998 --------
999 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1000   `const` contexts.][65188] e.g.
1001
1002   ```rust
1003   pub struct Point(i32, i32);
1004
1005   const ORIGIN: Point = {
1006       let constructor = Point;
1007
1008       constructor(0, 0)
1009   };
1010   ```
1011
1012 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1013   indicate that there may be variants or fields added in the future.][64639]
1014   For example this requires adding a wild-card branch (`_ => {}`) to any match
1015   statements on a non-exhaustive `enum`. [(RFC 2008)]
1016 - [You can now use function-like procedural macros in `extern` blocks and in
1017   type positions.][63931] e.g. `type Generated = macro!();`
1018 - [Function-like and attribute procedural macros can now emit
1019   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1020 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1021   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1022   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1023
1024 Compiler
1025 --------
1026 - [Added tier 3 support\* for the
1027   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1028 - [Added tier 3 support for the
1029   `aarch64-unknown-none-softfloat` target.][64589]
1030 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1031   `mips64el-unknown-linux-muslabi64` targets.][65843]
1032
1033 \* Refer to Rust's [platform support page][forge-platform-support] for more
1034   information on Rust's tiered platform support.
1035
1036 Libraries
1037 ---------
1038 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
1039
1040 Stabilized APIs
1041 ---------------
1042 - [`BTreeMap::get_key_value`]
1043 - [`HashMap::get_key_value`]
1044 - [`Option::as_deref_mut`]
1045 - [`Option::as_deref`]
1046 - [`Option::flatten`]
1047 - [`UdpSocket::peer_addr`]
1048 - [`f32::to_be_bytes`]
1049 - [`f32::to_le_bytes`]
1050 - [`f32::to_ne_bytes`]
1051 - [`f64::to_be_bytes`]
1052 - [`f64::to_le_bytes`]
1053 - [`f64::to_ne_bytes`]
1054 - [`f32::from_be_bytes`]
1055 - [`f32::from_le_bytes`]
1056 - [`f32::from_ne_bytes`]
1057 - [`f64::from_be_bytes`]
1058 - [`f64::from_le_bytes`]
1059 - [`f64::from_ne_bytes`]
1060 - [`mem::take`]
1061 - [`slice::repeat`]
1062 - [`todo!`]
1063
1064 Cargo
1065 -----
1066 - [Cargo will now always display warnings, rather than only on
1067   fresh builds.][cargo/7450]
1068 - [Feature flags (except `--all-features`) passed to a virtual workspace will
1069   now produce an error.][cargo/7507] Previously these flags were ignored.
1070 - [You can now publish `dev-dependencies` without including
1071   a `version`.][cargo/7333]
1072
1073 Misc
1074 ----
1075 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
1076   when running documentation tests with `rustdoc`.][63803]
1077
1078 Compatibility Notes
1079 -------------------
1080 - [As previously announced, any previous NLL warnings in the 2015 edition are
1081   now hard errors.][64221]
1082 - [The `include!` macro will now warn if it failed to include the
1083   entire file.][64284] The `include!` macro unintentionally only includes the
1084   first _expression_ in a file, and this can be unintuitive. This will become
1085   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
1086 - [Using `#[inline]` on function prototypes and consts now emits a warning under
1087   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
1088   or `extern` blocks now correctly emits a hard error.
1089
1090 [65294]: https://github.com/rust-lang/rust/pull/65294/
1091 [66103]: https://github.com/rust-lang/rust/pull/66103/
1092 [65843]: https://github.com/rust-lang/rust/pull/65843/
1093 [65188]: https://github.com/rust-lang/rust/pull/65188/
1094 [65092]: https://github.com/rust-lang/rust/pull/65092/
1095 [64589]: https://github.com/rust-lang/rust/pull/64589/
1096 [64639]: https://github.com/rust-lang/rust/pull/64639/
1097 [64221]: https://github.com/rust-lang/rust/pull/64221/
1098 [64284]: https://github.com/rust-lang/rust/pull/64284/
1099 [63931]: https://github.com/rust-lang/rust/pull/63931/
1100 [64035]: https://github.com/rust-lang/rust/pull/64035/
1101 [63674]: https://github.com/rust-lang/rust/pull/63674/
1102 [63803]: https://github.com/rust-lang/rust/pull/63803/
1103 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
1104 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
1105 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
1106 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
1107 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
1108 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
1109 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
1110 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
1111 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
1112 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
1113 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
1114 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
1115 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
1116 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
1117 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
1118 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
1119 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
1120 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
1121 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
1122 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
1123 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
1124 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
1125 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
1126 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
1127 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
1128 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
1129
1130
1131 Version 1.39.0 (2019-11-07)
1132 ===========================
1133
1134 Language
1135 --------
1136 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
1137   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
1138 - [You can now use certain attributes on function, closure, and function pointer
1139   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
1140   `deny`, `forbid` as well as inert helper attributes used by procedural macro
1141   attributes applied to items. e.g.
1142   ```rust
1143   fn len(
1144       #[cfg(windows)] slice: &[u16],
1145       #[cfg(not(windows))] slice: &[u8],
1146   ) -> usize {
1147       slice.len()
1148   }
1149   ```
1150 - [You can now take shared references to bind-by-move patterns in the `if` guards
1151   of `match` arms.][63118] e.g.
1152   ```rust
1153   fn main() {
1154       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
1155
1156       match array {
1157           nums
1158   //      ---- `nums` is bound by move.
1159               if nums.iter().sum::<u8>() == 10
1160   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
1161           => {
1162               drop(nums);
1163   //          ----------- Legal as `nums` was bound by move and so we have ownership.
1164           }
1165           _ => unreachable!(),
1166       }
1167   }
1168   ```
1169
1170
1171
1172 Compiler
1173 --------
1174 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
1175 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
1176 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
1177   **Note** Cargo currently doesn't use this feature. Refer to
1178   [cargo#7315][cargo/7315] to track this feature's progress.
1179 - [You can now pass `--show-output` argument to test binaries to print the
1180   output of successful tests.][62600]
1181
1182
1183 \* Refer to Rust's [platform support page][forge-platform-support] for more
1184 information on Rust's tiered platform support.
1185
1186 Libraries
1187 ---------
1188 - [`Vec::new` and `String::new` are now `const` functions.][64028]
1189 - [`LinkedList::new` is now a `const` function.][63684]
1190 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
1191 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
1192   now `const`.][63786]
1193
1194 Stabilized APIs
1195 ---------------
1196 - [`Pin::into_inner`]
1197 - [`Instant::checked_duration_since`]
1198 - [`Instant::saturating_duration_since`]
1199
1200 Cargo
1201 -----
1202 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
1203 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
1204   `--all` is now deprecated.
1205
1206 Misc
1207 ----
1208 - [You can now pass `-Clinker` to rustdoc to control the linker used
1209   for compiling doctests.][63834]
1210
1211 Compatibility Notes
1212 -------------------
1213 - [Code that was previously accepted by the old borrow checker, but rejected by
1214   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
1215   previously a warning, and will also become a hard error in the Rust 2015
1216   edition in the 1.40.0 release.
1217 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
1218   run tests.][63827] This should improve performance when running a large
1219   amount of doctests.
1220 - [The `try!` macro will now issue a deprecation warning.][62672] It is
1221   recommended to use the `?` operator instead.
1222 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
1223   returned `0.0`.
1224
1225 [62600]: https://github.com/rust-lang/rust/pull/62600/
1226 [62672]: https://github.com/rust-lang/rust/pull/62672/
1227 [63118]: https://github.com/rust-lang/rust/pull/63118/
1228 [63209]: https://github.com/rust-lang/rust/pull/63209/
1229 [63402]: https://github.com/rust-lang/rust/pull/63402/
1230 [63565]: https://github.com/rust-lang/rust/pull/63565/
1231 [63595]: https://github.com/rust-lang/rust/pull/63595/
1232 [63684]: https://github.com/rust-lang/rust/pull/63684/
1233 [63698]: https://github.com/rust-lang/rust/pull/63698/
1234 [63770]: https://github.com/rust-lang/rust/pull/63770/
1235 [63786]: https://github.com/rust-lang/rust/pull/63786/
1236 [63827]: https://github.com/rust-lang/rust/pull/63827/
1237 [63834]: https://github.com/rust-lang/rust/pull/63834/
1238 [63927]: https://github.com/rust-lang/rust/pull/63927/
1239 [63933]: https://github.com/rust-lang/rust/pull/63933/
1240 [63934]: https://github.com/rust-lang/rust/pull/63934/
1241 [63938]: https://github.com/rust-lang/rust/pull/63938/
1242 [63940]: https://github.com/rust-lang/rust/pull/63940/
1243 [63941]: https://github.com/rust-lang/rust/pull/63941/
1244 [63945]: https://github.com/rust-lang/rust/pull/63945/
1245 [64010]: https://github.com/rust-lang/rust/pull/64010/
1246 [64028]: https://github.com/rust-lang/rust/pull/64028/
1247 [64334]: https://github.com/rust-lang/rust/pull/64334/
1248 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
1249 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
1250 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
1251 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
1252 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
1253 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
1254
1255 Version 1.38.0 (2019-09-26)
1256 ==========================
1257
1258 Language
1259 --------
1260 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
1261 - [The `#[deprecated]` attribute can now be used on macros.][62042]
1262
1263 Compiler
1264 --------
1265 - [Added pipelined compilation support to `rustc`.][62766] This will
1266   improve compilation times in some cases. For further information please refer
1267   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
1268 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
1269   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
1270   `x86_64-uwp-windows-msvc` targets.][60260]
1271 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
1272   `armv7-unknown-linux-musleabi` targets.][63107]
1273 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1274 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1275 - [Upgraded to LLVM 9.][62592]
1276
1277 \* Refer to Rust's [platform support page][forge-platform-support] for more
1278 information on Rust's tiered platform support.
1279
1280 Libraries
1281 ---------
1282 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1283 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1284   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1285   is available at `std::clone::Clone`). This also makes all built-in macros
1286   available in `std`/`core` root. e.g. `std::include_bytes!`.
1287 - [`str::Chars` now implements `Debug`.][63000]
1288 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1289 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1290 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1291 - [Added euclidean remainder and division operations (`div_euclid`,
1292   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1293   `overflowing`, and `wrapping` versions are available for all
1294   integer primitives.
1295 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1296   `PartialEq`.][61491]
1297 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1298
1299 Stabilized APIs
1300 ---------------
1301 - [`<*const T>::cast`]
1302 - [`<*mut T>::cast`]
1303 - [`Duration::as_secs_f32`]
1304 - [`Duration::as_secs_f64`]
1305 - [`Duration::div_f32`]
1306 - [`Duration::div_f64`]
1307 - [`Duration::from_secs_f32`]
1308 - [`Duration::from_secs_f64`]
1309 - [`Duration::mul_f32`]
1310 - [`Duration::mul_f64`]
1311 - [`any::type_name`]
1312
1313 Cargo
1314 -----
1315 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1316 - [You can now pass the `--features` option multiple times to enable
1317   multiple features.][cargo/7084]
1318
1319 Misc
1320 ----
1321 - [`rustc` will now warn about some incorrect uses of
1322   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1323
1324 Compatibility Notes
1325 -------------------
1326 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1327   1.38.0.
1328 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1329   issues][62896] with certain crates such as libc.
1330
1331 [60260]: https://github.com/rust-lang/rust/pull/60260/
1332 [61457]: https://github.com/rust-lang/rust/pull/61457/
1333 [61491]: https://github.com/rust-lang/rust/pull/61491/
1334 [61884]: https://github.com/rust-lang/rust/pull/61884/
1335 [61953]: https://github.com/rust-lang/rust/pull/61953/
1336 [62042]: https://github.com/rust-lang/rust/pull/62042/
1337 [62528]: https://github.com/rust-lang/rust/pull/62528/
1338 [62583]: https://github.com/rust-lang/rust/pull/62583/
1339 [62735]: https://github.com/rust-lang/rust/pull/62735/
1340 [62766]: https://github.com/rust-lang/rust/pull/62766/
1341 [62784]: https://github.com/rust-lang/rust/pull/62784/
1342 [62592]: https://github.com/rust-lang/rust/pull/62592/
1343 [62785]: https://github.com/rust-lang/rust/issues/62785/
1344 [62814]: https://github.com/rust-lang/rust/pull/62814/
1345 [62896]: https://github.com/rust-lang/rust/issues/62896/
1346 [63000]: https://github.com/rust-lang/rust/pull/63000/
1347 [63056]: https://github.com/rust-lang/rust/pull/63056/
1348 [63107]: https://github.com/rust-lang/rust/pull/63107/
1349 [63346]: https://github.com/rust-lang/rust/pull/63346/
1350 [63421]: https://github.com/rust-lang/rust/pull/63421/
1351 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1352 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1353 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1354 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1355 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1356 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1357 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1358 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1359 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1360 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1361 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1362 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1363 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1364 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1365 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1366
1367 Version 1.37.0 (2019-08-15)
1368 ==========================
1369
1370 Language
1371 --------
1372 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1373   [`Box`][62228], or an [array][62235] and unused.
1374 - [You can now use the `cfg` and `cfg_attr` attributes on
1375   generic parameters.][61547]
1376 - [You can now use enum variants through type alias.][61682] e.g. You can
1377   write the following:
1378   ```rust
1379   type MyOption = Option<u8>;
1380
1381   fn increment_or_zero(x: MyOption) -> u8 {
1382       match x {
1383           MyOption::Some(y) => y + 1,
1384           MyOption::None => 0,
1385       }
1386   }
1387   ```
1388 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1389   `const _: u32 = 5;`.
1390 - [You can now use `#[repr(align(X)]` on enums.][61229]
1391 - [The  `?` Kleene macro operator is now available in the
1392   2015 edition.][60932]
1393
1394 Compiler
1395 --------
1396 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1397   and `-C profile-use` flags.][61268] For more information on how to use profile
1398   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1399 - [The `rust-lldb` wrapper script should now work again.][61827]
1400
1401 Libraries
1402 ---------
1403 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1404
1405 Stabilized APIs
1406 ---------------
1407 - [`BufReader::buffer`]
1408 - [`BufWriter::buffer`]
1409 - [`Cell::from_mut`]
1410 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1411 - [`DoubleEndedIterator::nth_back`]
1412 - [`Option::xor`]
1413 - [`Wrapping::reverse_bits`]
1414 - [`i128::reverse_bits`]
1415 - [`i16::reverse_bits`]
1416 - [`i32::reverse_bits`]
1417 - [`i64::reverse_bits`]
1418 - [`i8::reverse_bits`]
1419 - [`isize::reverse_bits`]
1420 - [`slice::copy_within`]
1421 - [`u128::reverse_bits`]
1422 - [`u16::reverse_bits`]
1423 - [`u32::reverse_bits`]
1424 - [`u64::reverse_bits`]
1425 - [`u8::reverse_bits`]
1426 - [`usize::reverse_bits`]
1427
1428 Cargo
1429 -----
1430 - [`Cargo.lock` files are now included by default when publishing executable crates
1431   with executables.][cargo/7026]
1432 - [You can now specify `default-run="foo"` in `[package]` to specify the
1433   default executable to use for `cargo run`.][cargo/7056]
1434
1435 Misc
1436 ----
1437
1438 Compatibility Notes
1439 -------------------
1440 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1441   Please transition your code to using the `..=` syntax for inclusive
1442   ranges instead.
1443 - [Using a trait object without the `dyn` will now warn by default.][61203]
1444   Please transition your code to use `dyn Trait` for trait objects instead.
1445
1446 [62228]: https://github.com/rust-lang/rust/pull/62228/
1447 [62235]: https://github.com/rust-lang/rust/pull/62235/
1448 [61802]: https://github.com/rust-lang/rust/pull/61802/
1449 [61827]: https://github.com/rust-lang/rust/pull/61827/
1450 [61547]: https://github.com/rust-lang/rust/pull/61547/
1451 [61682]: https://github.com/rust-lang/rust/pull/61682/
1452 [61268]: https://github.com/rust-lang/rust/pull/61268/
1453 [61342]: https://github.com/rust-lang/rust/pull/61342/
1454 [61347]: https://github.com/rust-lang/rust/pull/61347/
1455 [61100]: https://github.com/rust-lang/rust/pull/61100/
1456 [61203]: https://github.com/rust-lang/rust/pull/61203/
1457 [61229]: https://github.com/rust-lang/rust/pull/61229/
1458 [60932]: https://github.com/rust-lang/rust/pull/60932/
1459 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1460 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1461 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1462 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1463 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1464 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1465 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1466 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1467 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1468 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1469 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1470 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1471 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1472 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1473 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1474 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1475 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1476 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1477 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1478 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1479 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1480 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1481 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1482 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1483
1484
1485 Version 1.36.0 (2019-07-04)
1486 ==========================
1487
1488 Language
1489 --------
1490 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1491 - [The order of traits in trait objects no longer affects the semantics of that
1492   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1493   `dyn fmt::Debug + Send`, where this was previously not the case.
1494
1495 Libraries
1496 ---------
1497 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1498 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1499 - [`mem::needs_drop` is now available as a const fn.][60364]
1500 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1501 - [`String` now implements `BorrowMut<str>`.][60404]
1502 - [`io::Cursor` now implements `Default`.][60234]
1503 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1504 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1505   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1506   environment has access to heap memory allocation.
1507 - [`String` now implements `From<&String>`.][59825]
1508 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1509   return a tuple of each argument when there is multiple arguments.
1510 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1511   not used.][59648]
1512
1513 Stabilized APIs
1514 ---------------
1515 - [`VecDeque::rotate_left`]
1516 - [`VecDeque::rotate_right`]
1517 - [`Iterator::copied`]
1518 - [`io::IoSlice`]
1519 - [`io::IoSliceMut`]
1520 - [`Read::read_vectored`]
1521 - [`Write::write_vectored`]
1522 - [`str::as_mut_ptr`]
1523 - [`mem::MaybeUninit`]
1524 - [`pointer::align_offset`]
1525 - [`future::Future`]
1526 - [`task::Context`]
1527 - [`task::RawWaker`]
1528 - [`task::RawWakerVTable`]
1529 - [`task::Waker`]
1530 - [`task::Poll`]
1531
1532 Cargo
1533 -----
1534 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1535 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1536
1537 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1538
1539 Clippy
1540 ------
1541 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1542
1543 Misc
1544 ----
1545
1546 Compatibility Notes
1547 -------------------
1548 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1549   longer recommended, and will be deprecated in 1.39.0.
1550
1551 [60318]: https://github.com/rust-lang/rust/pull/60318/
1552 [60364]: https://github.com/rust-lang/rust/pull/60364/
1553 [60370]: https://github.com/rust-lang/rust/pull/60370/
1554 [60404]: https://github.com/rust-lang/rust/pull/60404/
1555 [60234]: https://github.com/rust-lang/rust/pull/60234/
1556 [60244]: https://github.com/rust-lang/rust/pull/60244/
1557 [58623]: https://github.com/rust-lang/rust/pull/58623/
1558 [59648]: https://github.com/rust-lang/rust/pull/59648/
1559 [59675]: https://github.com/rust-lang/rust/pull/59675/
1560 [59825]: https://github.com/rust-lang/rust/pull/59825/
1561 [59826]: https://github.com/rust-lang/rust/pull/59826/
1562 [59445]: https://github.com/rust-lang/rust/pull/59445/
1563 [59114]: https://github.com/rust-lang/rust/pull/59114/
1564 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1565 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1566 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1567 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1568 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1569 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1570 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1571 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1572 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1573 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1574 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1575 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1576 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1577 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1578 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1579 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1580 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1581 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1582 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1583 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1584
1585
1586 Version 1.35.0 (2019-05-23)
1587 ==========================
1588
1589 Language
1590 --------
1591 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1592   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1593 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1594   ```rust
1595   unsafe fn call_unsafe(func: unsafe fn()) {
1596       func()
1597   }
1598
1599   pub fn main() {
1600       unsafe { call_unsafe(|| {}); }
1601   }
1602   ```
1603
1604
1605 Compiler
1606 --------
1607 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1608   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1609 - [Added the `wasm32-unknown-wasi` target.][59464]
1610
1611
1612 Libraries
1613 ---------
1614 - [`Thread` will now show its ID in `Debug` output.][59460]
1615 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1616 - [`alloc::System` now implements `Default`.][59451]
1617 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1618   last field.][59076]
1619 - [`char::{ToLowercase, ToUppercase}` now
1620   implement `ExactSizeIterator`.][58778]
1621 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1622 - [Removed the `Read` trait bounds
1623   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1624 - [You can now call the `dbg!` macro without any parameters to print the file
1625   and line where it is called.][57847]
1626 - [In place ASCII case conversions are now up to 4× faster.][59283]
1627   e.g. `str::make_ascii_lowercase`
1628 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1629   and `Send`.][58369]
1630
1631 Stabilized APIs
1632 ---------------
1633 - [`f32::copysign`]
1634 - [`f64::copysign`]
1635 - [`RefCell::replace_with`]
1636 - [`RefCell::map_split`]
1637 - [`ptr::hash`]
1638 - [`Range::contains`]
1639 - [`RangeFrom::contains`]
1640 - [`RangeTo::contains`]
1641 - [`RangeInclusive::contains`]
1642 - [`RangeToInclusive::contains`]
1643 - [`Option::copied`]
1644
1645 Cargo
1646 -----
1647 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1648   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1649   platform specific.
1650
1651 Misc
1652 ----
1653 - [The Rust toolchain is now available natively for musl based distros.][58575]
1654
1655 [59460]: https://github.com/rust-lang/rust/pull/59460/
1656 [59464]: https://github.com/rust-lang/rust/pull/59464/
1657 [59500]: https://github.com/rust-lang/rust/pull/59500/
1658 [59512]: https://github.com/rust-lang/rust/pull/59512/
1659 [59580]: https://github.com/rust-lang/rust/pull/59580/
1660 [59283]: https://github.com/rust-lang/rust/pull/59283/
1661 [59451]: https://github.com/rust-lang/rust/pull/59451/
1662 [59076]: https://github.com/rust-lang/rust/pull/59076/
1663 [58778]: https://github.com/rust-lang/rust/pull/58778/
1664 [58717]: https://github.com/rust-lang/rust/pull/58717/
1665 [58369]: https://github.com/rust-lang/rust/pull/58369/
1666 [58423]: https://github.com/rust-lang/rust/pull/58423/
1667 [58080]: https://github.com/rust-lang/rust/pull/58080/
1668 [57847]: https://github.com/rust-lang/rust/pull/57847/
1669 [58575]: https://github.com/rust-lang/rust/pull/58575
1670 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1671 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1672 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1673 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1674 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1675 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1676 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1677 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1678 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1679 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1680 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1681 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1682
1683 Version 1.34.2 (2019-05-14)
1684 ===========================
1685
1686 * [Destabilize the `Error::type_id` function due to a security
1687    vulnerability][60785] ([CVE-2019-12083])
1688
1689 [60785]: https://github.com/rust-lang/rust/pull/60785
1690 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1691
1692 Version 1.34.1 (2019-04-25)
1693 ===========================
1694
1695 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1696 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1697 * [Fix Clippy panic when checking some macros][clippy/3805]
1698
1699 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1700 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1701 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1702
1703 Version 1.34.0 (2019-04-11)
1704 ==========================
1705
1706 Language
1707 --------
1708 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1709   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1710   but had no effect.
1711 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1712   `#[attr{}]` procedural macros.][57367]
1713 - [You can now write `extern crate self as foo;`][57407] to import your
1714   crate's root into the extern prelude.
1715
1716
1717 Compiler
1718 --------
1719 - [You can now target `riscv64imac-unknown-none-elf` and
1720   `riscv64gc-unknown-none-elf`.][58406]
1721 - [You can now enable linker plugin LTO optimisations with
1722   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1723   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1724   boundaries.
1725 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1726
1727
1728 Libraries
1729 ---------
1730 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1731   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1732   the `Hash` trait to create an iterator.
1733 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1734   methods.][58421] Most notably you no longer require the `Ord` trait to create
1735   an iterator.
1736 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1737   for all numeric types.][58044]
1738 - [Indexing a `str` is now generic over all types that
1739   implement `SliceIndex<str>`.][57604]
1740 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1741   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1742   produce a warning if their returning type is unused.
1743 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1744   `overflowing_pow` are now available for all numeric types.][57873] These are
1745   equivalent to methods such as `wrapping_add` for the `pow` operation.
1746
1747
1748 Stabilized APIs
1749 ---------------
1750
1751 #### std & core
1752 * [`Any::type_id`]
1753 * [`Error::type_id`]
1754 * [`atomic::AtomicI16`]
1755 * [`atomic::AtomicI32`]
1756 * [`atomic::AtomicI64`]
1757 * [`atomic::AtomicI8`]
1758 * [`atomic::AtomicU16`]
1759 * [`atomic::AtomicU32`]
1760 * [`atomic::AtomicU64`]
1761 * [`atomic::AtomicU8`]
1762 * [`convert::Infallible`]
1763 * [`convert::TryFrom`]
1764 * [`convert::TryInto`]
1765 * [`iter::from_fn`]
1766 * [`iter::successors`]
1767 * [`num::NonZeroI128`]
1768 * [`num::NonZeroI16`]
1769 * [`num::NonZeroI32`]
1770 * [`num::NonZeroI64`]
1771 * [`num::NonZeroI8`]
1772 * [`num::NonZeroIsize`]
1773 * [`slice::sort_by_cached_key`]
1774 * [`str::escape_debug`]
1775 * [`str::escape_default`]
1776 * [`str::escape_unicode`]
1777 * [`str::split_ascii_whitespace`]
1778
1779 #### std
1780 * [`Instant::checked_add`]
1781 * [`Instant::checked_sub`]
1782 * [`SystemTime::checked_add`]
1783 * [`SystemTime::checked_sub`]
1784
1785 Cargo
1786 -----
1787 - [You can now use alternative registries to crates.io.][cargo/6654]
1788
1789 Misc
1790 ----
1791 - [You can now use the `?` operator in your documentation tests without manually
1792   adding `fn main() -> Result<(), _> {}`.][56470]
1793
1794 Compatibility Notes
1795 -------------------
1796 - [`Command::before_exec` is being replaced by the unsafe method
1797   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1798 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1799   can now use `const` functions in `static` variables.
1800
1801 [58370]: https://github.com/rust-lang/rust/pull/58370/
1802 [58406]: https://github.com/rust-lang/rust/pull/58406/
1803 [58421]: https://github.com/rust-lang/rust/pull/58421/
1804 [58166]: https://github.com/rust-lang/rust/pull/58166/
1805 [58044]: https://github.com/rust-lang/rust/pull/58044/
1806 [58057]: https://github.com/rust-lang/rust/pull/58057/
1807 [58059]: https://github.com/rust-lang/rust/pull/58059/
1808 [57809]: https://github.com/rust-lang/rust/pull/57809/
1809 [57873]: https://github.com/rust-lang/rust/pull/57873/
1810 [57604]: https://github.com/rust-lang/rust/pull/57604/
1811 [57367]: https://github.com/rust-lang/rust/pull/57367/
1812 [57407]: https://github.com/rust-lang/rust/pull/57407/
1813 [57425]: https://github.com/rust-lang/rust/pull/57425/
1814 [57106]: https://github.com/rust-lang/rust/pull/57106/
1815 [56470]: https://github.com/rust-lang/rust/pull/56470/
1816 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1817 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1818 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1819 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1820 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1821 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1822 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1823 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1824 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1825 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1826 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1827 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1828 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1829 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1830 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1831 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1832 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1833 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1834 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1835 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1836 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1837 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1838 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1839 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1840 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1841 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1842 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1843 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1844 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1845 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1846 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1847
1848
1849 Version 1.33.0 (2019-02-28)
1850 ==========================
1851
1852 Language
1853 --------
1854 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1855   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1856 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1857   E.g. You can have match statement on a `u8` that covers `0..=255` and
1858   you would no longer be required to have a `_ => unreachable!()` case.
1859 - [You can now have multiple patterns in `if let` and `while let`
1860   expressions.][57532] You can do this with the same syntax as a `match`
1861   expression. E.g.
1862   ```rust
1863   enum Creature {
1864       Crab(String),
1865       Lobster(String),
1866       Person(String),
1867   }
1868
1869   fn main() {
1870       let state = Creature::Crab("Ferris");
1871
1872       if let Creature::Crab(name) | Creature::Person(name) = state {
1873           println!("This creature's name is: {}", name);
1874       }
1875   }
1876   ```
1877 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1878   this feature will by default produce a warning as this behaviour can be
1879   unintuitive. E.g. `if let _ = 5 {}`
1880 - [You can now use `let` bindings, assignments, expression statements,
1881   and irrefutable pattern destructuring in const functions.][57175]
1882 - [You can now call unsafe const functions.][57067] E.g.
1883   ```rust
1884   const unsafe fn foo() -> i32 { 5 }
1885   const fn bar() -> i32 {
1886       unsafe { foo() }
1887   }
1888   ```
1889 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1890   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1891 - [You can now specify a specific alignment with the `#[repr(packed)]`
1892   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1893   with an alignment of 2 bytes and a size of 6 bytes.
1894 - [You can now import an item from a module as an `_`.][56303] This allows you to
1895   import a trait's impls, and not have the name in the namespace. E.g.
1896   ```rust
1897   use std::io::Read as _;
1898
1899   // Allowed as there is only one `Read` in the module.
1900   pub trait Read {}
1901   ```
1902 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1903
1904 Compiler
1905 --------
1906 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1907   command line argument.][56351]
1908 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1909 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1910 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1911   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1912   information on Rust's platform support.
1913 - [Added support for the `thumbv7neon-linux-androideabi` and
1914   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1915 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1916
1917 Libraries
1918 ---------
1919 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1920   functions for all numeric types.][57566]
1921 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1922   are now `const` functions for all numeric types.][57105]
1923 - [The methods `is_positive` and `is_negative` are now `const` functions for
1924   all signed numeric types.][57105]
1925 - [The `get` method for all `NonZero` types is now `const`.][57167]
1926 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1927   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1928   numeric types.][57234]
1929 - [`Ipv4Addr::new` is now a `const` function][57234]
1930
1931 Stabilized APIs
1932 ---------------
1933 - [`unix::FileExt::read_exact_at`]
1934 - [`unix::FileExt::write_all_at`]
1935 - [`Option::transpose`]
1936 - [`Result::transpose`]
1937 - [`convert::identity`]
1938 - [`pin::Pin`]
1939 - [`marker::Unpin`]
1940 - [`marker::PhantomPinned`]
1941 - [`Vec::resize_with`]
1942 - [`VecDeque::resize_with`]
1943 - [`Duration::as_millis`]
1944 - [`Duration::as_micros`]
1945 - [`Duration::as_nanos`]
1946
1947
1948 Cargo
1949 -----
1950 - [You can now publish crates that require a feature flag to compile with
1951   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1952 - [Cargo should now rebuild a crate if a file was modified during the initial
1953   build.][cargo/6484]
1954
1955 Compatibility Notes
1956 -------------------
1957 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1958   are now deprecated in the standard library, and their usage will now produce a warning.
1959   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1960   methods instead.
1961 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1962   downcasting.
1963 - [Libtest no longer creates a new thread for each test when
1964   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1965
1966 [55982]: https://github.com/rust-lang/rust/pull/55982/
1967 [56243]: https://github.com/rust-lang/rust/pull/56243
1968 [56303]: https://github.com/rust-lang/rust/pull/56303/
1969 [56351]: https://github.com/rust-lang/rust/pull/56351/
1970 [56362]: https://github.com/rust-lang/rust/pull/56362
1971 [56642]: https://github.com/rust-lang/rust/pull/56642/
1972 [56769]: https://github.com/rust-lang/rust/pull/56769/
1973 [56805]: https://github.com/rust-lang/rust/pull/56805
1974 [56947]: https://github.com/rust-lang/rust/pull/56947/
1975 [57049]: https://github.com/rust-lang/rust/pull/57049/
1976 [57067]: https://github.com/rust-lang/rust/pull/57067/
1977 [57105]: https://github.com/rust-lang/rust/pull/57105
1978 [57130]: https://github.com/rust-lang/rust/pull/57130/
1979 [57167]: https://github.com/rust-lang/rust/pull/57167/
1980 [57175]: https://github.com/rust-lang/rust/pull/57175/
1981 [57234]: https://github.com/rust-lang/rust/pull/57234/
1982 [57332]: https://github.com/rust-lang/rust/pull/57332/
1983 [57465]: https://github.com/rust-lang/rust/pull/57465/
1984 [57532]: https://github.com/rust-lang/rust/pull/57532/
1985 [57535]: https://github.com/rust-lang/rust/pull/57535/
1986 [57566]: https://github.com/rust-lang/rust/pull/57566/
1987 [57615]: https://github.com/rust-lang/rust/pull/57615/
1988 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1989 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1990 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1991 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1992 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1993 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1994 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1995 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1996 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1997 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1998 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1999 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2000 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2001 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2002 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2003 [platform-support]: https://forge.rust-lang.org/platform-support.html
2004
2005 Version 1.32.0 (2019-01-17)
2006 ==========================
2007
2008 Language
2009 --------
2010 #### 2018 edition
2011 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2012   operator allows you to specify zero or one repetitions similar to the `*` and
2013   `+` operators.
2014 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2015   now always resolve to the item (`enum`, `struct`, etc.) available in the
2016   module if present, before resolving to a external crate or an item the prelude.][56759]
2017   E.g.
2018   ```rust
2019   enum Color { Red, Green, Blue }
2020
2021   use Color::*;
2022   ```
2023
2024 #### All editions
2025 - [You can now match against `PhantomData<T>` types.][55837]
2026 - [You can now match against literals in macros with the `literal`
2027   specifier.][56072] This will match against a literal of any type.
2028   E.g. `1`, `'A'`, `"Hello World"`
2029 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2030   ```rust
2031   struct Point(i32, i32);
2032
2033   impl Point {
2034       pub fn new(x: i32, y: i32) -> Self {
2035           Self(x, y)
2036       }
2037
2038       pub fn is_origin(&self) -> bool {
2039           match self {
2040               Self(0, 0) => true,
2041               _ => false,
2042           }
2043       }
2044   }
2045   ```
2046 - [Self can also now be used in type definitions.][56366] E.g.
2047   ```rust
2048   enum List<T>
2049   where
2050       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
2051   {
2052       Nil,
2053       Cons(T, Box<Self>) // likewise here
2054   }
2055   ```
2056 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
2057   a `impl Trait` or `dyn Trait` is returned and unused in the program.
2058
2059 Compiler
2060 --------
2061 - [The default allocator has changed from jemalloc to the default allocator on
2062   your system.][55238] The compiler itself on Linux & macOS will still use
2063   jemalloc, but programs compiled with it will use the system allocator.
2064 - [Added the `aarch64-pc-windows-msvc` target.][55702]
2065
2066 Libraries
2067 ---------
2068 - [`PathBuf` now implements `FromStr`.][55148]
2069 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
2070 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
2071   easily debug expressions in your rust program. E.g.
2072   ```rust
2073   let a = 2;
2074   let b = dbg!(a * 2) + 1;
2075   //      ^-- prints: [src/main.rs:4] a * 2 = 4
2076   assert_eq!(b, 5);
2077   ```
2078
2079 The following APIs are now `const` functions and can be used in a
2080 `const` context.
2081
2082 - [`Cell::as_ptr`]
2083 - [`UnsafeCell::get`]
2084 - [`char::is_ascii`]
2085 - [`iter::empty`]
2086 - [`ManuallyDrop::new`]
2087 - [`ManuallyDrop::into_inner`]
2088 - [`RangeInclusive::start`]
2089 - [`RangeInclusive::end`]
2090 - [`NonNull::as_ptr`]
2091 - [`slice::as_ptr`]
2092 - [`str::as_ptr`]
2093 - [`Duration::as_secs`]
2094 - [`Duration::subsec_millis`]
2095 - [`Duration::subsec_micros`]
2096 - [`Duration::subsec_nanos`]
2097 - [`CStr::as_ptr`]
2098 - [`Ipv4Addr::is_unspecified`]
2099 - [`Ipv6Addr::new`]
2100 - [`Ipv6Addr::octets`]
2101
2102 Stabilized APIs
2103 ---------------
2104 - [`i8::to_be_bytes`]
2105 - [`i8::to_le_bytes`]
2106 - [`i8::to_ne_bytes`]
2107 - [`i8::from_be_bytes`]
2108 - [`i8::from_le_bytes`]
2109 - [`i8::from_ne_bytes`]
2110 - [`i16::to_be_bytes`]
2111 - [`i16::to_le_bytes`]
2112 - [`i16::to_ne_bytes`]
2113 - [`i16::from_be_bytes`]
2114 - [`i16::from_le_bytes`]
2115 - [`i16::from_ne_bytes`]
2116 - [`i32::to_be_bytes`]
2117 - [`i32::to_le_bytes`]
2118 - [`i32::to_ne_bytes`]
2119 - [`i32::from_be_bytes`]
2120 - [`i32::from_le_bytes`]
2121 - [`i32::from_ne_bytes`]
2122 - [`i64::to_be_bytes`]
2123 - [`i64::to_le_bytes`]
2124 - [`i64::to_ne_bytes`]
2125 - [`i64::from_be_bytes`]
2126 - [`i64::from_le_bytes`]
2127 - [`i64::from_ne_bytes`]
2128 - [`i128::to_be_bytes`]
2129 - [`i128::to_le_bytes`]
2130 - [`i128::to_ne_bytes`]
2131 - [`i128::from_be_bytes`]
2132 - [`i128::from_le_bytes`]
2133 - [`i128::from_ne_bytes`]
2134 - [`isize::to_be_bytes`]
2135 - [`isize::to_le_bytes`]
2136 - [`isize::to_ne_bytes`]
2137 - [`isize::from_be_bytes`]
2138 - [`isize::from_le_bytes`]
2139 - [`isize::from_ne_bytes`]
2140 - [`u8::to_be_bytes`]
2141 - [`u8::to_le_bytes`]
2142 - [`u8::to_ne_bytes`]
2143 - [`u8::from_be_bytes`]
2144 - [`u8::from_le_bytes`]
2145 - [`u8::from_ne_bytes`]
2146 - [`u16::to_be_bytes`]
2147 - [`u16::to_le_bytes`]
2148 - [`u16::to_ne_bytes`]
2149 - [`u16::from_be_bytes`]
2150 - [`u16::from_le_bytes`]
2151 - [`u16::from_ne_bytes`]
2152 - [`u32::to_be_bytes`]
2153 - [`u32::to_le_bytes`]
2154 - [`u32::to_ne_bytes`]
2155 - [`u32::from_be_bytes`]
2156 - [`u32::from_le_bytes`]
2157 - [`u32::from_ne_bytes`]
2158 - [`u64::to_be_bytes`]
2159 - [`u64::to_le_bytes`]
2160 - [`u64::to_ne_bytes`]
2161 - [`u64::from_be_bytes`]
2162 - [`u64::from_le_bytes`]
2163 - [`u64::from_ne_bytes`]
2164 - [`u128::to_be_bytes`]
2165 - [`u128::to_le_bytes`]
2166 - [`u128::to_ne_bytes`]
2167 - [`u128::from_be_bytes`]
2168 - [`u128::from_le_bytes`]
2169 - [`u128::from_ne_bytes`]
2170 - [`usize::to_be_bytes`]
2171 - [`usize::to_le_bytes`]
2172 - [`usize::to_ne_bytes`]
2173 - [`usize::from_be_bytes`]
2174 - [`usize::from_le_bytes`]
2175 - [`usize::from_ne_bytes`]
2176
2177 Cargo
2178 -----
2179 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
2180 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
2181
2182 Misc
2183 ----
2184 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
2185
2186 Compatibility Notes
2187 -------------------
2188 - [The argument types for AVX's
2189   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
2190   been changed from `*const` to `*mut` as the previous implementation
2191   was unsound.
2192
2193
2194 [55148]: https://github.com/rust-lang/rust/pull/55148/
2195 [55238]: https://github.com/rust-lang/rust/pull/55238/
2196 [55280]: https://github.com/rust-lang/rust/pull/55280/
2197 [55610]: https://github.com/rust-lang/rust/pull/55610/
2198 [55663]: https://github.com/rust-lang/rust/pull/55663/
2199 [55702]: https://github.com/rust-lang/rust/pull/55702/
2200 [55837]: https://github.com/rust-lang/rust/pull/55837/
2201 [55843]: https://github.com/rust-lang/rust/pull/55843/
2202 [56072]: https://github.com/rust-lang/rust/pull/56072/
2203 [56245]: https://github.com/rust-lang/rust/pull/56245/
2204 [56365]: https://github.com/rust-lang/rust/pull/56365/
2205 [56366]: https://github.com/rust-lang/rust/pull/56366/
2206 [56395]: https://github.com/rust-lang/rust/pull/56395/
2207 [56759]: https://github.com/rust-lang/rust/pull/56759/
2208 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
2209 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
2210 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
2211 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
2212 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
2213 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2214 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2215 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
2216 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
2217 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
2218 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
2219 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
2220 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
2221 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
2222 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
2223 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
2224 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
2225 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
2226 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
2227 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
2228 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
2229 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
2230 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
2231 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
2232 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
2233 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
2234 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
2235 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
2236 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
2237 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
2238 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
2239 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
2240 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
2241 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
2242 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
2243 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
2244 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
2245 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
2246 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
2247 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
2248 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
2249 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
2250 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
2251 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
2252 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
2253 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
2254 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
2255 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
2256 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
2257 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
2258 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
2259 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
2260 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
2261 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
2262 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
2263 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
2264 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
2265 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
2266 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
2267 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
2268 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
2269 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
2270 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
2271 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
2272 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
2273 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
2274 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
2275 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2276 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2277 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2278 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2279 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2280 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2281 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2282 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2283 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2284 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2285 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2286 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2287 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2288 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2289 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2290 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2291 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2292 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2293 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2294 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2295 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2296 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2297 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2298 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2299 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2300 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2301
2302
2303 Version 1.31.1 (2018-12-20)
2304 ===========================
2305
2306 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2307 - [Fix broken go-to-definition in RLS][rls/1171]
2308 - [Fix infinite loop on hover in RLS][rls/1170]
2309
2310 [56562]: https://github.com/rust-lang/rust/pull/56562
2311 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2312 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2313
2314 Version 1.31.0 (2018-12-06)
2315 ==========================
2316
2317 Language
2318 --------
2319 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2320 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2321   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2322   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2323   in structs.
2324 - [You can now define and use `const` functions.][54835] These are currently
2325   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2326   [language reference][const-reference] for what exactly is available.
2327 - [You can now use tool lints, which allow you to scope lints from external
2328   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2329 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2330   a crate, not just in exported functions.][54451]
2331 - [You can now use parentheses in pattern matches.][54497]
2332
2333 Compiler
2334 --------
2335 - [Updated musl to 1.1.20][54430]
2336
2337 Libraries
2338 ---------
2339 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2340   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2341 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2342   into `Option<&mut T>` using the `From` trait.][53218]
2343 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2344
2345
2346 Stabilized APIs
2347 ---------------
2348 - [`slice::align_to`]
2349 - [`slice::align_to_mut`]
2350 - [`slice::chunks_exact`]
2351 - [`slice::chunks_exact_mut`]
2352 - [`slice::rchunks`]
2353 - [`slice::rchunks_mut`]
2354 - [`slice::rchunks_exact`]
2355 - [`slice::rchunks_exact_mut`]
2356 - [`Option::replace`]
2357
2358 Cargo
2359 -----
2360 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2361 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2362   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2363
2364 [52813]: https://github.com/rust-lang/rust/pull/52813/
2365 [53218]: https://github.com/rust-lang/rust/pull/53218/
2366 [53555]: https://github.com/rust-lang/rust/issues/53555/
2367 [54057]: https://github.com/rust-lang/rust/pull/54057/
2368 [54240]: https://github.com/rust-lang/rust/pull/54240/
2369 [54430]: https://github.com/rust-lang/rust/pull/54430/
2370 [54451]: https://github.com/rust-lang/rust/pull/54451/
2371 [54497]: https://github.com/rust-lang/rust/pull/54497/
2372 [54778]: https://github.com/rust-lang/rust/pull/54778/
2373 [54835]: https://github.com/rust-lang/rust/pull/54835/
2374 [54870]: https://github.com/rust-lang/rust/pull/54870/
2375 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2376 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2377 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2378 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2379 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2380 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2381 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2382 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2383 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2384 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2385 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2386 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2387 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2388 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2389
2390 Version 1.30.1 (2018-11-08)
2391 ===========================
2392
2393 - [Fixed overflow ICE in rustdoc][54199]
2394 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2395
2396 [54199]: https://github.com/rust-lang/rust/pull/54199
2397 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2398
2399 Version 1.30.0 (2018-10-25)
2400 ==========================
2401
2402 Language
2403 --------
2404 - [Procedural macros are now available.][52081] These kinds of macros allow for
2405   more powerful code generation. There is a [new chapter available][proc-macros]
2406   in the Rust Programming Language book that goes further in depth.
2407 - [You can now use keywords as identifiers using the raw identifiers
2408   syntax (`r#`),][53236] e.g. `let r#for = true;`
2409 - [Using anonymous parameters in traits is now deprecated with a warning and
2410   will be a hard error in the 2018 edition.][53272]
2411 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2412   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2413 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2414   Previously, using a external crate in a module without a use statement
2415   required `let json = ::serde_json::from_str(foo);` but can now be written
2416   as `let json = serde_json::from_str(foo);`.
2417 - [You can now apply the `#[used]` attribute to static items to prevent the
2418   compiler from optimising them away, even if they appear to be unused,][51363]
2419   e.g. `#[used] static FOO: u32 = 1;`
2420 - [You can now import and reexport macros from other crates with the `use`
2421   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2422   the root module of the crate. If your macro relies on calling other local
2423   macros, it is recommended to export with the
2424   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2425   those macros.
2426 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2427   using the `vis` specifier.][53370]
2428 - [Non-macro attributes now allow all forms of literals, not just
2429   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2430   write `#[attr(true)]`.
2431 - [You can now specify a function to handle a panic in the Rust runtime with the
2432   `#[panic_handler]` attribute.][51366]
2433
2434 Compiler
2435 --------
2436 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2437 - [Added the `aarch64-unknown-netbsd` target][53165]
2438 - [Upgraded to LLVM 8.][53611]
2439
2440 Libraries
2441 ---------
2442 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2443
2444 Stabilized APIs
2445 ---------------
2446 - [`Ipv4Addr::BROADCAST`]
2447 - [`Ipv4Addr::LOCALHOST`]
2448 - [`Ipv4Addr::UNSPECIFIED`]
2449 - [`Ipv6Addr::LOCALHOST`]
2450 - [`Ipv6Addr::UNSPECIFIED`]
2451 - [`Iterator::find_map`]
2452
2453   The following methods are replacement methods for `trim_left`, `trim_right`,
2454   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2455   in 1.33.0:
2456 - [`str::trim_end_matches`]
2457 - [`str::trim_end`]
2458 - [`str::trim_start_matches`]
2459 - [`str::trim_start`]
2460
2461 Cargo
2462 ----
2463 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2464 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2465   equivalent to calling `rustdoc --error-format=json`.
2466 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2467
2468 Misc
2469 ----
2470 - [`rustdoc` allows you to specify what edition to treat your code as with the
2471   `--edition` option.][54057]
2472 - [`rustdoc` now has the `--color` (specify whether to output color) and
2473   `--error-format` (specify error format, e.g. `json`) options.][53003]
2474 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2475   debug symbols.][53774]
2476 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2477   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2478
2479 [50911]: https://github.com/rust-lang/rust/pull/50911/
2480 [51363]: https://github.com/rust-lang/rust/pull/51363/
2481 [51366]: https://github.com/rust-lang/rust/pull/51366/
2482 [52081]: https://github.com/rust-lang/rust/pull/52081/
2483 [53003]: https://github.com/rust-lang/rust/pull/53003/
2484 [53033]: https://github.com/rust-lang/rust/pull/53033/
2485 [53044]: https://github.com/rust-lang/rust/pull/53044/
2486 [53165]: https://github.com/rust-lang/rust/pull/53165/
2487 [53611]: https://github.com/rust-lang/rust/pull/53611/
2488 [53213]: https://github.com/rust-lang/rust/pull/53213/
2489 [53236]: https://github.com/rust-lang/rust/pull/53236/
2490 [53272]: https://github.com/rust-lang/rust/pull/53272/
2491 [53370]: https://github.com/rust-lang/rust/pull/53370/
2492 [53459]: https://github.com/rust-lang/rust/pull/53459/
2493 [53774]: https://github.com/rust-lang/rust/pull/53774/
2494 [53822]: https://github.com/rust-lang/rust/pull/53822/
2495 [54057]: https://github.com/rust-lang/rust/pull/54057/
2496 [54146]: https://github.com/rust-lang/rust/pull/54146/
2497 [54404]: https://github.com/rust-lang/rust/pull/54404/
2498 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2499 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2500 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2501 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2502
2503 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2504 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2505 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2506 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2507 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2508 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2509 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2510 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2511 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2512 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2513
2514
2515 Version 1.29.2 (2018-10-11)
2516 ===========================
2517
2518 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2519 - The `rls-preview` component on the windows-gnu targets has been restored.
2520
2521 [54639]: https://github.com/rust-lang/rust/pull/54639
2522
2523
2524 Version 1.29.1 (2018-09-25)
2525 ===========================
2526
2527 Security Notes
2528 --------------
2529
2530 - The standard library's `str::repeat` function contained an out of bounds write
2531   caused by an integer overflow. This has been fixed by deterministically
2532   panicking when an overflow happens.
2533
2534   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2535   us.
2536
2537
2538 Version 1.29.0 (2018-09-13)
2539 ==========================
2540
2541 Compiler
2542 --------
2543 - [Bumped minimum LLVM version to 5.0.][51899]
2544 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2545 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2546 - [Upgraded to LLVM 7.][51966]
2547
2548 Libraries
2549 ---------
2550 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2551 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2552 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2553 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2554   for `&str`.][51178]
2555 - [`Cell<T>` now allows `T` to be unsized.][50494]
2556 - [`SocketAddr` is now stable on Redox.][52656]
2557
2558 Stabilized APIs
2559 ---------------
2560 - [`Arc::downcast`]
2561 - [`Iterator::flatten`]
2562 - [`Rc::downcast`]
2563
2564 Cargo
2565 -----
2566 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2567   `--locked` to disable this behavior.
2568 - [`cargo-install` will now allow you to cross compile an install
2569   using `--target`.][cargo/5614]
2570 - [Added the `cargo-fix` subcommand to automatically move project code from
2571   2015 edition to 2018.][cargo/5723]
2572 - [`cargo doc` can now optionally document private types using the
2573   `--document-private-items` flag.][cargo/5543]
2574
2575 Misc
2576 ----
2577 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2578   the specified level to that level.][52354] For example `--cap-lints warn`
2579   will demote `deny` and `forbid` lints to `warn`.
2580 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2581   fails and `101` if there is a panic.][52197]
2582 - [A preview of clippy has been made available through rustup.][51122]
2583   You can install the preview with `rustup component add clippy-preview`.
2584
2585 Compatibility Notes
2586 -------------------
2587 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2588   Use `str::get_unchecked(begin..end)` instead.
2589 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2590   Consider using the `home_dir` function from
2591   https://crates.io/crates/dirs instead.
2592 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2593 - [`cfg` attributes and `--cfg` command line flags are now more
2594   strictly validated.][53893]
2595
2596 [53893]: https://github.com/rust-lang/rust/pull/53893/
2597 [52861]: https://github.com/rust-lang/rust/pull/52861/
2598 [51966]: https://github.com/rust-lang/rust/pull/51966/
2599 [52656]: https://github.com/rust-lang/rust/pull/52656/
2600 [52239]: https://github.com/rust-lang/rust/pull/52239/
2601 [52330]: https://github.com/rust-lang/rust/pull/52330/
2602 [52354]: https://github.com/rust-lang/rust/pull/52354/
2603 [52402]: https://github.com/rust-lang/rust/pull/52402/
2604 [52103]: https://github.com/rust-lang/rust/pull/52103/
2605 [52197]: https://github.com/rust-lang/rust/pull/52197/
2606 [51807]: https://github.com/rust-lang/rust/pull/51807/
2607 [51899]: https://github.com/rust-lang/rust/pull/51899/
2608 [51912]: https://github.com/rust-lang/rust/pull/51912/
2609 [51511]: https://github.com/rust-lang/rust/pull/51511/
2610 [51619]: https://github.com/rust-lang/rust/pull/51619/
2611 [51656]: https://github.com/rust-lang/rust/pull/51656/
2612 [51178]: https://github.com/rust-lang/rust/pull/51178/
2613 [51122]: https://github.com/rust-lang/rust/pull/51122
2614 [50494]: https://github.com/rust-lang/rust/pull/50494/
2615 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2616 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2617 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2618 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2619 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2620 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2621 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2622
2623
2624 Version 1.28.0 (2018-08-02)
2625 ===========================
2626
2627 Language
2628 --------
2629 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2630   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2631   the inner type across Foreign Function Interface (FFI) boundaries.
2632 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2633   and can now be used as identifiers.][51196]
2634 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2635   stable.][51241] This will allow users to specify a global allocator for
2636   their program.
2637 - [Unit test functions marked with the `#[test]` attribute can now return
2638   `Result<(), E: Debug>` in addition to `()`.][51298]
2639 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2640   allows macros to easily target lifetimes.
2641
2642 Compiler
2643 --------
2644 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2645   prioritise making smaller binary sizes. `z` is the same as `s` with the
2646   exception that it does not vectorise loops, which typically results in an even
2647   smaller binary.
2648 - [The short error format is now stable.][49546] Specified with
2649   `--error-format=short` this option will provide a more compressed output of
2650   rust error messages.
2651 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2652 - [Reduced the number of allocations in the macro parser.][50855] This can
2653   improve compile times of macro heavy crates on average by 5%.
2654
2655 Libraries
2656 ---------
2657 - [Implemented `Default` for `&mut str`.][51306]
2658 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2659 - [Implemented `Extend` for `()`.][50234]
2660 - [The `Debug` implementation of `time::Duration` should now be more easily
2661   human readable.][50364] Previously a `Duration` of one second would printed as
2662   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2663 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2664   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2665   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2666   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2667   for `PathBuf`.][50170]
2668 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2669   and `Wrapping<i128>`.][50465]
2670 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2671   possible.][51050] This can provide up to a 40% speed increase.
2672 - [Improved error messages when using `format!`.][50610]
2673
2674 Stabilized APIs
2675 ---------------
2676 - [`Iterator::step_by`]
2677 - [`Path::ancestors`]
2678 - [`SystemTime::UNIX_EPOCH`]
2679 - [`alloc::GlobalAlloc`]
2680 - [`alloc::Layout`]
2681 - [`alloc::LayoutErr`]
2682 - [`alloc::System`]
2683 - [`alloc::alloc`]
2684 - [`alloc::alloc_zeroed`]
2685 - [`alloc::dealloc`]
2686 - [`alloc::realloc`]
2687 - [`alloc::handle_alloc_error`]
2688 - [`btree_map::Entry::or_default`]
2689 - [`fmt::Alignment`]
2690 - [`hash_map::Entry::or_default`]
2691 - [`iter::repeat_with`]
2692 - [`num::NonZeroUsize`]
2693 - [`num::NonZeroU128`]
2694 - [`num::NonZeroU16`]
2695 - [`num::NonZeroU32`]
2696 - [`num::NonZeroU64`]
2697 - [`num::NonZeroU8`]
2698 - [`ops::RangeBounds`]
2699 - [`slice::SliceIndex`]
2700 - [`slice::from_mut`]
2701 - [`slice::from_ref`]
2702 - [`{Any + Send + Sync}::downcast_mut`]
2703 - [`{Any + Send + Sync}::downcast_ref`]
2704 - [`{Any + Send + Sync}::is`]
2705
2706 Cargo
2707 -----
2708 - [Cargo will now no longer allow you to publish crates with build scripts that
2709   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2710   considered to be immutable.
2711
2712 Misc
2713 ----
2714 - [The `suggestion_applicability` field in `rustc`'s json output is now
2715   stable.][50486] This will allow dev tools to check whether a code suggestion
2716   would apply to them.
2717
2718 Compatibility Notes
2719 -------------------
2720 - [Rust will consider trait objects with duplicated constraints to be the same
2721   type as without the duplicated constraint.][51276] For example the below code will
2722   now fail to compile.
2723   ```rust
2724   trait Trait {}
2725
2726   impl Trait + Send {
2727       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2728   }
2729
2730   impl Trait + Send + Send {
2731       fn test(&self) { println!("two"); }
2732   }
2733   ```
2734
2735 [49546]: https://github.com/rust-lang/rust/pull/49546/
2736 [50143]: https://github.com/rust-lang/rust/pull/50143/
2737 [50170]: https://github.com/rust-lang/rust/pull/50170/
2738 [50234]: https://github.com/rust-lang/rust/pull/50234/
2739 [50265]: https://github.com/rust-lang/rust/pull/50265/
2740 [50364]: https://github.com/rust-lang/rust/pull/50364/
2741 [50385]: https://github.com/rust-lang/rust/pull/50385/
2742 [50465]: https://github.com/rust-lang/rust/pull/50465/
2743 [50486]: https://github.com/rust-lang/rust/pull/50486/
2744 [50554]: https://github.com/rust-lang/rust/pull/50554/
2745 [50610]: https://github.com/rust-lang/rust/pull/50610/
2746 [50855]: https://github.com/rust-lang/rust/pull/50855/
2747 [51050]: https://github.com/rust-lang/rust/pull/51050/
2748 [51196]: https://github.com/rust-lang/rust/pull/51196/
2749 [51200]: https://github.com/rust-lang/rust/pull/51200/
2750 [51241]: https://github.com/rust-lang/rust/pull/51241/
2751 [51276]: https://github.com/rust-lang/rust/pull/51276/
2752 [51298]: https://github.com/rust-lang/rust/pull/51298/
2753 [51306]: https://github.com/rust-lang/rust/pull/51306/
2754 [51562]: https://github.com/rust-lang/rust/pull/51562/
2755 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2756 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2757 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2758 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2759 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2760 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2761 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2762 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2763 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2764 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2765 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2766 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2767 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2768 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2769 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2770 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2771 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2772 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2773 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2774 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2775 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2776 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2777 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2778 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2779 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2780 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2781 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2782 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2783 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2784 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2785
2786 Version 1.27.2 (2018-07-20)
2787 ===========================
2788
2789 Compatibility Notes
2790 -------------------
2791
2792 - The borrow checker was fixed to avoid potential unsoundness when using
2793   match ergonomics: [#52213][52213].
2794
2795 [52213]: https://github.com/rust-lang/rust/issues/52213
2796
2797 Version 1.27.1 (2018-07-10)
2798 ===========================
2799
2800 Security Notes
2801 --------------
2802
2803 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2804   when running, which enabled executing code as some other user on a
2805   given machine. This release fixes that vulnerability; you can read
2806   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2807
2808   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2809
2810 Compatibility Notes
2811 -------------------
2812
2813 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2814   match ergonomics: [#51415][51415], [#49534][49534].
2815
2816 [51415]: https://github.com/rust-lang/rust/issues/51415
2817 [49534]: https://github.com/rust-lang/rust/issues/49534
2818 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2819 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2820
2821 Version 1.27.0 (2018-06-21)
2822 ==========================
2823
2824 Language
2825 --------
2826 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2827   be used as an identifier.
2828 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2829   bare `Trait` syntax, and should make it clearer when being used in tandem with
2830   `impl Trait` because it is equivalent to the following syntax:
2831   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2832   `Box<Trait> == Box<dyn Trait>`.
2833 - [Attributes on generic parameters such as types and lifetimes are
2834   now stable.][48851] e.g.
2835   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2836 - [The `#[must_use]` attribute can now also be used on functions as well as
2837   types.][48925] It provides a lint that by default warns users when the
2838   value returned by a function has not been used.
2839
2840 Compiler
2841 --------
2842 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2843
2844 Libraries
2845 ---------
2846 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2847   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2848   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2849   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2850   the `cfg` attribute.
2851 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2852   std are now available in core.][49896]
2853 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2854   to `Self`.][49630]
2855 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2856   that the operation isn't done in place.
2857 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2858   the `#[must_use]` attribute][49533] to warn about unused potentially
2859   expensive allocations.
2860
2861 Stabilized APIs
2862 ---------------
2863 - [`DoubleEndedIterator::rfind`]
2864 - [`DoubleEndedIterator::rfold`]
2865 - [`DoubleEndedIterator::try_rfold`]
2866 - [`Duration::from_micros`]
2867 - [`Duration::from_nanos`]
2868 - [`Duration::subsec_micros`]
2869 - [`Duration::subsec_millis`]
2870 - [`HashMap::remove_entry`]
2871 - [`Iterator::try_fold`]
2872 - [`Iterator::try_for_each`]
2873 - [`NonNull::cast`]
2874 - [`Option::filter`]
2875 - [`String::replace_range`]
2876 - [`Take::set_limit`]
2877 - [`hint::unreachable_unchecked`]
2878 - [`os::unix::process::parent_id`]
2879 - [`ptr::swap_nonoverlapping`]
2880 - [`slice::rsplit_mut`]
2881 - [`slice::rsplit`]
2882 - [`slice::swap_with_slice`]
2883
2884 Cargo
2885 -----
2886 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2887   `readme`, and `repository` fields.][cargo/5386]
2888 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2889 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2890   a different directory than `target` for placing compilation artifacts.
2891 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2892   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2893   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2894   where cargo would infer a binary, Cargo will produce a warning. You can
2895   disable this feature ahead of time by setting any of the following to false:
2896   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2897 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2898   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2899
2900 Misc
2901 ----
2902 - [Added “The Rustc book” into the official documentation.][49707]
2903   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2904 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2905
2906 Compatibility Notes
2907 -------------------
2908 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2909   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2910   compile, `"".is_empty()` will still compile.
2911 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2912   will only print the inner type.][48553] E.g.
2913   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2914   not `AtomicBool(true)`.
2915 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2916   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2917   alignment should cover all use cases.
2918 - The `.description()` method on the `std::error::Error` trait
2919   [has been soft-deprecated][50163]. It is no longer required to implement it.
2920
2921 [48553]: https://github.com/rust-lang/rust/pull/48553/
2922 [48851]: https://github.com/rust-lang/rust/pull/48851/
2923 [48925]: https://github.com/rust-lang/rust/pull/48925/
2924 [49533]: https://github.com/rust-lang/rust/pull/49533/
2925 [49623]: https://github.com/rust-lang/rust/pull/49623/
2926 [49630]: https://github.com/rust-lang/rust/pull/49630/
2927 [49664]: https://github.com/rust-lang/rust/pull/49664/
2928 [49699]: https://github.com/rust-lang/rust/pull/49699/
2929 [49707]: https://github.com/rust-lang/rust/pull/49707/
2930 [49719]: https://github.com/rust-lang/rust/pull/49719/
2931 [49896]: https://github.com/rust-lang/rust/pull/49896/
2932 [49968]: https://github.com/rust-lang/rust/pull/49968/
2933 [50163]: https://github.com/rust-lang/rust/pull/50163
2934 [50177]: https://github.com/rust-lang/rust/pull/50177/
2935 [50378]: https://github.com/rust-lang/rust/pull/50378/
2936 [50398]: https://github.com/rust-lang/rust/pull/50398/
2937 [50423]: https://github.com/rust-lang/rust/pull/50423/
2938 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2939 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2940 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2941 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2942 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2943 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2944 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2945 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2946 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2947 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2948 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2949 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2950 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2951 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2952 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2953 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2954 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2955 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2956 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2957 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2958 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2959 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2960 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2961 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2962 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2963 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2964 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2965 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2966 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2967 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2968
2969
2970 Version 1.26.2 (2018-06-05)
2971 ==========================
2972
2973 Compatibility Notes
2974 -------------------
2975
2976 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2977
2978 [51117]: https://github.com/rust-lang/rust/issues/51117
2979
2980
2981 Version 1.26.1 (2018-05-29)
2982 ==========================
2983
2984 Tools
2985 -----
2986
2987 - [RLS now works on Windows.][50646]
2988 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2989
2990
2991 Compatibility Notes
2992 --------
2993
2994 - [`fn main() -> impl Trait` no longer works for non-Termination
2995   trait.][50656]
2996   This reverts an accidental stabilization.
2997 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2998 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2999
3000 [50646]: https://github.com/rust-lang/rust/issues/50646
3001 [50656]: https://github.com/rust-lang/rust/pull/50656
3002 [50812]: https://github.com/rust-lang/rust/pull/50812
3003 [50950]: https://github.com/rust-lang/rust/issues/50950
3004 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3005
3006 Version 1.26.0 (2018-05-10)
3007 ==========================
3008
3009 Language
3010 --------
3011 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3012   implement either or both traits.][49299]
3013 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3014 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3015   lifetime can be elided.][49458]
3016 - [`impl Trait` is now stable allowing you to have abstract types in returns
3017    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3018   `fn open(path: impl AsRef<Path>)`.
3019 - [Pattern matching will now automatically apply dereferences.][49394]
3020 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3021 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3022 - [A lot of operations are now available in a const context.][46882] E.g. You
3023   can now index into constant arrays, reference and dereference into constants,
3024   and use tuple struct constructors.
3025 - [Fixed entry slice patterns are now stable.][48516] E.g.
3026   ```rust
3027   let points = [1, 2, 3, 4];
3028   match points {
3029       [1, 2, 3, 4] => println!("All points were sequential."),
3030       _ => println!("Not all points were sequential."),
3031   }
3032   ```
3033
3034
3035 Compiler
3036 --------
3037 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
3038 - [Fixed exponential projection complexity on nested types.][48296]
3039   This can provide up to a ~12% reduction in compile times for certain crates.
3040 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
3041   to remap path prefixes outputted by the compiler.
3042 - [Added `powerpc-unknown-netbsd` target.][48281]
3043
3044 Libraries
3045 ---------
3046 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
3047 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
3048   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
3049 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
3050 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
3051 - [`ascii::escape_default` is now available in libcore.][48735]
3052 - [Trailing commas are now supported in std and core macros.][48056]
3053 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
3054 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
3055
3056 Stabilized APIs
3057 ---------------
3058 - [`*const T::add`]
3059 - [`*const T::copy_to_nonoverlapping`]
3060 - [`*const T::copy_to`]
3061 - [`*const T::read_unaligned`]
3062 - [`*const T::read_volatile`]
3063 - [`*const T::read`]
3064 - [`*const T::sub`]
3065 - [`*const T::wrapping_add`]
3066 - [`*const T::wrapping_sub`]
3067 - [`*mut T::add`]
3068 - [`*mut T::copy_to_nonoverlapping`]
3069 - [`*mut T::copy_to`]
3070 - [`*mut T::read_unaligned`]
3071 - [`*mut T::read_volatile`]
3072 - [`*mut T::read`]
3073 - [`*mut T::replace`]
3074 - [`*mut T::sub`]
3075 - [`*mut T::swap`]
3076 - [`*mut T::wrapping_add`]
3077 - [`*mut T::wrapping_sub`]
3078 - [`*mut T::write_bytes`]
3079 - [`*mut T::write_unaligned`]
3080 - [`*mut T::write_volatile`]
3081 - [`*mut T::write`]
3082 - [`Box::leak`]
3083 - [`FromUtf8Error::as_bytes`]
3084 - [`LocalKey::try_with`]
3085 - [`Option::cloned`]
3086 - [`btree_map::Entry::and_modify`]
3087 - [`fs::read_to_string`]
3088 - [`fs::read`]
3089 - [`fs::write`]
3090 - [`hash_map::Entry::and_modify`]
3091 - [`iter::FusedIterator`]
3092 - [`ops::RangeInclusive`]
3093 - [`ops::RangeToInclusive`]
3094 - [`process::id`]
3095 - [`slice::rotate_left`]
3096 - [`slice::rotate_right`]
3097 - [`String::retain`]
3098
3099
3100 Cargo
3101 -----
3102 - [Cargo will now output path to custom commands when `-v` is
3103   passed with `--list`][cargo/5041]
3104 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
3105
3106 Misc
3107 ----
3108 - [The second edition of "The Rust Programming Language" book is now recommended
3109   over the first.][48404]
3110
3111 Compatibility Notes
3112 -------------------
3113
3114 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
3115   syntax is now invalid.
3116   ```
3117   use std::ops::Fn as dyn;
3118   fn g(_: Box<dyn(std::fmt::Debug)>) {}
3119   ```
3120 - [The result of dereferences are no longer promoted to `'static`.][47408]
3121   e.g.
3122   ```rust
3123   fn main() {
3124       const PAIR: &(i32, i32) = &(0, 1);
3125       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
3126   }
3127   ```
3128 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
3129 - [`".e0"` will now no longer parse as `0.0` and will instead cause
3130   an error.][48235]
3131 - [Removed hoedown from rustdoc.][48274]
3132 - [Bounds on higher-kinded lifetimes a hard error.][48326]
3133
3134 [46882]: https://github.com/rust-lang/rust/pull/46882
3135 [47379]: https://github.com/rust-lang/rust/pull/47379
3136 [47408]: https://github.com/rust-lang/rust/pull/47408
3137 [47813]: https://github.com/rust-lang/rust/pull/47813
3138 [48056]: https://github.com/rust-lang/rust/pull/48056
3139 [48125]: https://github.com/rust-lang/rust/pull/48125
3140 [48166]: https://github.com/rust-lang/rust/pull/48166
3141 [48235]: https://github.com/rust-lang/rust/pull/48235
3142 [48274]: https://github.com/rust-lang/rust/pull/48274
3143 [48281]: https://github.com/rust-lang/rust/pull/48281
3144 [48296]: https://github.com/rust-lang/rust/pull/48296
3145 [48326]: https://github.com/rust-lang/rust/pull/48326
3146 [48359]: https://github.com/rust-lang/rust/pull/48359
3147 [48404]: https://github.com/rust-lang/rust/pull/48404
3148 [48481]: https://github.com/rust-lang/rust/pull/48481
3149 [48516]: https://github.com/rust-lang/rust/pull/48516
3150 [48628]: https://github.com/rust-lang/rust/pull/48628
3151 [48629]: https://github.com/rust-lang/rust/pull/48629
3152 [48657]: https://github.com/rust-lang/rust/pull/48657
3153 [48735]: https://github.com/rust-lang/rust/pull/48735
3154 [48978]: https://github.com/rust-lang/rust/pull/48978
3155 [49101]: https://github.com/rust-lang/rust/pull/49101
3156 [49109]: https://github.com/rust-lang/rust/pull/49109
3157 [49121]: https://github.com/rust-lang/rust/pull/49121
3158 [49162]: https://github.com/rust-lang/rust/pull/49162
3159 [49184]: https://github.com/rust-lang/rust/pull/49184
3160 [49234]: https://github.com/rust-lang/rust/pull/49234
3161 [49255]: https://github.com/rust-lang/rust/pull/49255
3162 [49299]: https://github.com/rust-lang/rust/pull/49299
3163 [49305]: https://github.com/rust-lang/rust/pull/49305
3164 [49394]: https://github.com/rust-lang/rust/pull/49394
3165 [49458]: https://github.com/rust-lang/rust/pull/49458
3166 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
3167 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
3168 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
3169 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
3170 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
3171 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
3172 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
3173 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
3174 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
3175 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
3176 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
3177 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
3178 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
3179 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
3180 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
3181 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
3182 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
3183 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
3184 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
3185 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
3186 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
3187 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
3188 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
3189 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
3190 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
3191 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
3192 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
3193 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
3194 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
3195 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
3196 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
3197 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
3198 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
3199 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
3200 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
3201 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
3202 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3203 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
3204 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
3205 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
3206 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
3207 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
3208
3209
3210 Version 1.25.0 (2018-03-29)
3211 ==========================
3212
3213 Language
3214 --------
3215 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
3216 - [You can now use nested groups of imports.][47948]
3217   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
3218 - [You can now have `|` at the start of a match arm.][47947] e.g.
3219 ```rust
3220 enum Foo { A, B, C }
3221
3222 fn main() {
3223     let x = Foo::A;
3224     match x {
3225         | Foo::A
3226         | Foo::B => println!("AB"),
3227         | Foo::C => println!("C"),
3228     }
3229 }
3230 ```
3231
3232 Compiler
3233 --------
3234 - [Upgraded to LLVM 6.][47828]
3235 - [Added `-C lto=val` option.][47521]
3236 - [Added `i586-unknown-linux-musl` target][47282]
3237
3238 Libraries
3239 ---------
3240 - [Impl Send for `process::Command` on Unix.][47760]
3241 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
3242 - [`UnsafeCell::into_inner` is now safe.][47204]
3243 - [Implement libstd for CloudABI.][47268]
3244 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
3245 - [Implement `AsRef<Path>` for Component][46985]
3246 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
3247 - [Moved `Duration` to libcore.][46666]
3248
3249 Stabilized APIs
3250 ---------------
3251 - [`Location::column`]
3252 - [`ptr::NonNull`]
3253
3254 The following functions can now be used in a constant expression.
3255 eg. `static MINUTE: Duration = Duration::from_secs(60);`
3256 - [`Duration::new`][47300]
3257 - [`Duration::from_secs`][47300]
3258 - [`Duration::from_millis`][47300]
3259
3260 Cargo
3261 -----
3262 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
3263 - [`cargo new` now defaults to creating a binary crate, instead of a
3264   library crate.][cargo/5029]
3265
3266 Misc
3267 ----
3268 - [Rust by example is now shipped with new releases][46196]
3269
3270 Compatibility Notes
3271 -------------------
3272 - [Deprecated `net::lookup_host`.][47510]
3273 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
3274 - The borrow checker was sometimes incorrectly permitting overlapping borrows
3275   around indexing operations (see [#47349][47349]). This has been fixed (which also
3276   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
3277 - [Removed deprecated unstable attribute `#[simd]`.][47251]
3278
3279 [33903]: https://github.com/rust-lang/rust/pull/33903
3280 [47947]: https://github.com/rust-lang/rust/pull/47947
3281 [47948]: https://github.com/rust-lang/rust/pull/47948
3282 [47760]: https://github.com/rust-lang/rust/pull/47760
3283 [47790]: https://github.com/rust-lang/rust/pull/47790
3284 [47828]: https://github.com/rust-lang/rust/pull/47828
3285 [47398]: https://github.com/rust-lang/rust/pull/47398
3286 [47510]: https://github.com/rust-lang/rust/pull/47510
3287 [47521]: https://github.com/rust-lang/rust/pull/47521
3288 [47204]: https://github.com/rust-lang/rust/pull/47204
3289 [47251]: https://github.com/rust-lang/rust/pull/47251
3290 [47268]: https://github.com/rust-lang/rust/pull/47268
3291 [47282]: https://github.com/rust-lang/rust/pull/47282
3292 [47300]: https://github.com/rust-lang/rust/pull/47300
3293 [47349]: https://github.com/rust-lang/rust/pull/47349
3294 [46931]: https://github.com/rust-lang/rust/pull/46931
3295 [46985]: https://github.com/rust-lang/rust/pull/46985
3296 [47006]: https://github.com/rust-lang/rust/pull/47006
3297 [46830]: https://github.com/rust-lang/rust/pull/46830
3298 [46095]: https://github.com/rust-lang/rust/pull/46095
3299 [46666]: https://github.com/rust-lang/rust/pull/46666
3300 [46196]: https://github.com/rust-lang/rust/pull/46196
3301 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3302 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3303 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3304 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3305 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3306
3307
3308 Version 1.24.1 (2018-03-01)
3309 ==========================
3310
3311  - [Do not abort when unwinding through FFI][48251]
3312  - [Emit UTF-16 files for linker arguments on Windows][48318]
3313  - [Make the error index generator work again][48308]
3314  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3315
3316 [48251]: https://github.com/rust-lang/rust/issues/48251
3317 [48308]: https://github.com/rust-lang/rust/issues/48308
3318 [48318]: https://github.com/rust-lang/rust/issues/48318
3319 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3320
3321
3322 Version 1.24.0 (2018-02-15)
3323 ==========================
3324
3325 Language
3326 --------
3327 - [External `sysv64` ffi is now available.][46528]
3328   eg. `extern "sysv64" fn foo () {}`
3329
3330 Compiler
3331 --------
3332 - [rustc now uses 16 codegen units by default for release builds.][46910]
3333   For the fastest builds, utilize `codegen-units=1`.
3334 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3335 - [Add `aarch64-unknown-openbsd` support][46760]
3336
3337 Libraries
3338 ---------
3339 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3340   improvement in performance in the majority of cases.
3341 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3342   with Windows.][46798]
3343 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3344 - [impl `From<bool>` for `AtomicBool`][46293]
3345 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3346 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3347 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3348 - [float::from_bits now just uses transmute.][46012] This provides
3349   some optimisations from LLVM.
3350 - [Copied `AsciiExt` methods onto `char`][46077]
3351 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3352 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3353 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3354 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3355
3356 Stabilized APIs
3357 ---------------
3358 - [`RefCell::replace`]
3359 - [`RefCell::swap`]
3360 - [`atomic::spin_loop_hint`]
3361
3362 The following functions can now be used in a constant expression.
3363 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3364
3365 - [`AtomicBool::new`][46287]
3366 - [`AtomicUsize::new`][46287]
3367 - [`AtomicIsize::new`][46287]
3368 - [`AtomicPtr::new`][46287]
3369 - [`Cell::new`][46287]
3370 - [`{integer}::min_value`][46287]
3371 - [`{integer}::max_value`][46287]
3372 - [`mem::size_of`][46287]
3373 - [`mem::align_of`][46287]
3374 - [`ptr::null`][46287]
3375 - [`ptr::null_mut`][46287]
3376 - [`RefCell::new`][46287]
3377 - [`UnsafeCell::new`][46287]
3378
3379 Cargo
3380 -----
3381 - [Added a `workspace.default-members` config that
3382   overrides implied `--all` in virtual workspaces.][cargo/4743]
3383 - [Enable incremental by default on development builds.][cargo/4817] Also added
3384   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3385   per-project or global basis respectively.
3386
3387 Misc
3388 ----
3389
3390 Compatibility Notes
3391 -------------------
3392 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3393 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3394   in accordance with IETF RFC 4291 §2.2.
3395 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3396 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3397   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3398 - [Leading zeros in tuple struct members is now an error][47084]
3399 - [`column!()` macro is one-based instead of zero-based][46977]
3400 - [`fmt::Arguments` can no longer be shared across threads][45198]
3401 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3402 - [Cargo sets a different working directory for the compiler][cargo/4788]
3403
3404 [44884]: https://github.com/rust-lang/rust/pull/44884
3405 [45198]: https://github.com/rust-lang/rust/pull/45198
3406 [45506]: https://github.com/rust-lang/rust/pull/45506
3407 [45904]: https://github.com/rust-lang/rust/pull/45904
3408 [45990]: https://github.com/rust-lang/rust/pull/45990
3409 [46012]: https://github.com/rust-lang/rust/pull/46012
3410 [46077]: https://github.com/rust-lang/rust/pull/46077
3411 [46094]: https://github.com/rust-lang/rust/pull/46094
3412 [46284]: https://github.com/rust-lang/rust/pull/46284
3413 [46287]: https://github.com/rust-lang/rust/pull/46287
3414 [46293]: https://github.com/rust-lang/rust/pull/46293
3415 [46528]: https://github.com/rust-lang/rust/pull/46528
3416 [46671]: https://github.com/rust-lang/rust/pull/46671
3417 [46713]: https://github.com/rust-lang/rust/pull/46713
3418 [46735]: https://github.com/rust-lang/rust/pull/46735
3419 [46749]: https://github.com/rust-lang/rust/pull/46749
3420 [46760]: https://github.com/rust-lang/rust/pull/46760
3421 [46798]: https://github.com/rust-lang/rust/pull/46798
3422 [46828]: https://github.com/rust-lang/rust/pull/46828
3423 [46831]: https://github.com/rust-lang/rust/pull/46831
3424 [46833]: https://github.com/rust-lang/rust/pull/46833
3425 [46910]: https://github.com/rust-lang/rust/pull/46910
3426 [46977]: https://github.com/rust-lang/rust/pull/46977
3427 [47018]: https://github.com/rust-lang/rust/pull/47018
3428 [47080]: https://github.com/rust-lang/rust/pull/47080
3429 [47084]: https://github.com/rust-lang/rust/pull/47084
3430 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3431 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3432 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3433 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3434 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3435 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3436
3437
3438 Version 1.23.0 (2018-01-04)
3439 ==========================
3440
3441 Language
3442 --------
3443 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3444 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3445   Which should fix some confusing errors in some operations.
3446
3447 Compiler
3448 --------
3449 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3450   undefined behavior.][45920]
3451 - [rustc now suggests renaming import if names clash.][45660]
3452 - [Display errors/warnings correctly when there are zero-width or
3453   wide characters.][45711]
3454 - [rustc now avoids unnecessary copies of arguments that are
3455   simple bindings][45380] This should improve memory usage on average by 5-10%.
3456 - [Updated musl used to build musl rustc to 1.1.17][45393]
3457
3458 Libraries
3459 ---------
3460 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3461 - [Implement Hash for raw pointers to unsized types][45483]
3462 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3463 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3464 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3465 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3466   and `<*mut T>::as_mut`][44932]
3467 - [Optimized `Thread::{park, unpark}` implementation][45524]
3468 - [Improved `SliceExt::binary_search` performance.][45333]
3469 - [impl `FromIterator<()>` for `()`][45379]
3470 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3471   is now deprecated.
3472
3473 Stabilized APIs
3474 ---------------
3475
3476 Cargo
3477 -----
3478 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3479   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3480 - [Added unit test checking to `cargo check`][cargo/4592]
3481 - [Cargo now lets you install a specific version
3482   using `cargo install --version`][cargo/4637]
3483
3484 Misc
3485 ----
3486 - [Releases now ship with the Cargo book documentation.][45692]
3487 - [rustdoc now prints rendering warnings on every run.][45324]
3488
3489 Compatibility Notes
3490 -------------------
3491 - [Changes have been made to type equality to make it more correct,
3492   in rare cases this could break some code.][45853] [Tracking issue for
3493   further information][45852]
3494 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3495 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3496   Android 9, the minimum supported version is Android 14.
3497 - [Bumped the minimum LLVM to 3.9][45326]
3498
3499 [44042]: https://github.com/rust-lang/rust/pull/44042
3500 [44932]: https://github.com/rust-lang/rust/pull/44932
3501 [45267]: https://github.com/rust-lang/rust/pull/45267
3502 [45324]: https://github.com/rust-lang/rust/pull/45324
3503 [45326]: https://github.com/rust-lang/rust/pull/45326
3504 [45333]: https://github.com/rust-lang/rust/pull/45333
3505 [45379]: https://github.com/rust-lang/rust/pull/45379
3506 [45380]: https://github.com/rust-lang/rust/pull/45380
3507 [45393]: https://github.com/rust-lang/rust/pull/45393
3508 [45435]: https://github.com/rust-lang/rust/pull/45435
3509 [45483]: https://github.com/rust-lang/rust/pull/45483
3510 [45524]: https://github.com/rust-lang/rust/pull/45524
3511 [45571]: https://github.com/rust-lang/rust/pull/45571
3512 [45580]: https://github.com/rust-lang/rust/pull/45580
3513 [45610]: https://github.com/rust-lang/rust/pull/45610
3514 [45660]: https://github.com/rust-lang/rust/pull/45660
3515 [45692]: https://github.com/rust-lang/rust/pull/45692
3516 [45711]: https://github.com/rust-lang/rust/pull/45711
3517 [45772]: https://github.com/rust-lang/rust/pull/45772
3518 [45852]: https://github.com/rust-lang/rust/issues/45852
3519 [45853]: https://github.com/rust-lang/rust/pull/45853
3520 [45887]: https://github.com/rust-lang/rust/pull/45887
3521 [45920]: https://github.com/rust-lang/rust/pull/45920
3522 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3523 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3524 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3525
3526
3527 Version 1.22.1 (2017-11-22)
3528 ==========================
3529
3530 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3531
3532 [46183]: https://github.com/rust-lang/rust/pull/46183
3533
3534 Version 1.22.0 (2017-11-22)
3535 ==========================
3536
3537 Language
3538 --------
3539 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3540 - [Now accepts underscores in unicode escapes][43716]
3541 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3542 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3543
3544 Compiler
3545 --------
3546 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3547 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3548   This should decrease compile times for debug builds.
3549 - [strict memory alignment now enabled on ARMv6][45094]
3550 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3551
3552 Libraries
3553 ---------
3554 - [Allow atomic operations up to 32 bits
3555   on `armv5te_unknown_linux_gnueabi`][44978]
3556 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3557 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3558 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3559 - [Properly detect overflow in `Instant += Duration`.][44220]
3560 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3561 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3562 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3563
3564 Stabilized APIs
3565 ---------------
3566
3567 Cargo
3568 -----
3569 - [Cargo will now build multi file examples in subdirectories of the `examples`
3570   folder that have a `main.rs` file.][cargo/4496]
3571 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3572   the old format will continue to work and can be updated with `cargo update`.
3573 - [Now supports vendoring git repositories][cargo/3992]
3574
3575 Misc
3576 ----
3577 - [`libbacktrace` is now available on Apple platforms.][44251]
3578 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3579   This now lets you specify that a given code example will fail to compile.
3580
3581 Compatibility Notes
3582 -------------------
3583 - [The minimum Android version that rustc can build for has been bumped
3584   to `4.0` from `2.3`][45656]
3585 - [Allowing `T op= &T` for numeric types has broken some type
3586   inference cases][45480]
3587
3588
3589 [42526]: https://github.com/rust-lang/rust/pull/42526
3590 [43017]: https://github.com/rust-lang/rust/pull/43017
3591 [43716]: https://github.com/rust-lang/rust/pull/43716
3592 [43949]: https://github.com/rust-lang/rust/pull/43949
3593 [44015]: https://github.com/rust-lang/rust/pull/44015
3594 [44220]: https://github.com/rust-lang/rust/pull/44220
3595 [44251]: https://github.com/rust-lang/rust/pull/44251
3596 [44287]: https://github.com/rust-lang/rust/pull/44287
3597 [44303]: https://github.com/rust-lang/rust/pull/44303
3598 [44456]: https://github.com/rust-lang/rust/pull/44456
3599 [44466]: https://github.com/rust-lang/rust/pull/44466
3600 [44895]: https://github.com/rust-lang/rust/pull/44895
3601 [44966]: https://github.com/rust-lang/rust/pull/44966
3602 [44978]: https://github.com/rust-lang/rust/pull/44978
3603 [45041]: https://github.com/rust-lang/rust/pull/45041
3604 [45064]: https://github.com/rust-lang/rust/pull/45064
3605 [45075]: https://github.com/rust-lang/rust/pull/45075
3606 [45094]: https://github.com/rust-lang/rust/pull/45094
3607 [45095]: https://github.com/rust-lang/rust/pull/45095
3608 [45480]: https://github.com/rust-lang/rust/issues/45480
3609 [45656]: https://github.com/rust-lang/rust/pull/45656
3610 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3611 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3612 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3613
3614
3615
3616
3617
3618
3619 Version 1.21.0 (2017-10-12)
3620 ==========================
3621
3622 Language
3623 --------
3624 - [You can now use static references for literals.][43838]
3625   Example:
3626   ```rust
3627   fn main() {
3628       let x: &'static u32 = &0;
3629   }
3630   ```
3631 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3632   Example:
3633   ```rust
3634   my_macro!(Vec<i32>::new); // Always worked
3635   my_macro!(Vec::<i32>::new); // Now works
3636   ```
3637
3638 Compiler
3639 --------
3640 - [Upgraded jemalloc to 4.5.0][43911]
3641 - [Enabled unwinding panics on Redox][43917]
3642 - [Now runs LLVM in parallel during translation phase.][43506]
3643   This should reduce peak memory usage.
3644
3645 Libraries
3646 ---------
3647 - [Generate builtin impls for `Clone` for all arrays and tuples that
3648   are `T: Clone`][43690]
3649 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3650 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3651   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3652
3653 Stabilized APIs
3654 ---------------
3655
3656 [`std::mem::discriminant`]
3657
3658 Cargo
3659 -----
3660 - [You can now call `cargo install` with multiple package names][cargo/4216]
3661 - [Cargo commands inside a virtual workspace will now implicitly
3662   pass `--all`][cargo/4335]
3663 - [Added a `[patch]` section to `Cargo.toml` to handle
3664   prepublication dependencies][cargo/4123] [RFC 1969]
3665 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3666   like patterns][cargo/4270]
3667 - [Added the `--all-targets` option][cargo/4400]
3668 - [Using required dependencies as a feature is now deprecated and emits
3669   a warning][cargo/4364]
3670
3671
3672 Misc
3673 ----
3674 - [Cargo docs are moving][43916]
3675   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3676 - [The rustdoc book is now available][43863]
3677   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3678 - [Added a preview of RLS has been made available through rustup][44204]
3679   Install with `rustup component add rls-preview`
3680 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3681   Previously only showed `std::os::unix`.
3682
3683 Compatibility Notes
3684 -------------------
3685 - [Changes in method matching against higher-ranked types][43880] This may cause
3686   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3687 - [rustc's JSON error output's byte position start at top of file.][42973]
3688   Was previously relative to the rustc's internal `CodeMap` struct which
3689   required the unstable library `libsyntax` to correctly use.
3690 - [`unused_results` lint no longer ignores booleans][43728]
3691
3692 [42565]: https://github.com/rust-lang/rust/pull/42565
3693 [42973]: https://github.com/rust-lang/rust/pull/42973
3694 [43348]: https://github.com/rust-lang/rust/pull/43348
3695 [43459]: https://github.com/rust-lang/rust/pull/43459
3696 [43506]: https://github.com/rust-lang/rust/pull/43506
3697 [43540]: https://github.com/rust-lang/rust/pull/43540
3698 [43690]: https://github.com/rust-lang/rust/pull/43690
3699 [43728]: https://github.com/rust-lang/rust/pull/43728
3700 [43838]: https://github.com/rust-lang/rust/pull/43838
3701 [43863]: https://github.com/rust-lang/rust/pull/43863
3702 [43880]: https://github.com/rust-lang/rust/pull/43880
3703 [43911]: https://github.com/rust-lang/rust/pull/43911
3704 [43916]: https://github.com/rust-lang/rust/pull/43916
3705 [43917]: https://github.com/rust-lang/rust/pull/43917
3706 [44204]: https://github.com/rust-lang/rust/pull/44204
3707 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3708 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3709 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3710 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3711 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3712 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3713 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3714 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3715 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3716
3717 Version 1.20.0 (2017-08-31)
3718 ===========================
3719
3720 Language
3721 --------
3722 - [Associated constants are now stabilised.][42809]
3723 - [A lot of macro bugs are now fixed.][42913]
3724
3725 Compiler
3726 --------
3727
3728 - [Struct fields are now properly coerced to the expected field type.][42807]
3729 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3730   `wasm32-experimental-emscripten` target.
3731 - [Changed some of the error messages to be more helpful.][42033]
3732 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3733   it.][43170]
3734 - [rustc now reports the total number of errors on compilation failure][43015]
3735   previously this was only the number of errors in the pass that failed.
3736 - [Expansion in rustc has been sped up 29x.][42533]
3737 - [added `msp430-none-elf` target.][43099]
3738 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3739   applicable][43178]
3740 - [Fixes backtraces on Redox][43228]
3741 - [rustc now identifies different versions of same crate when absolute paths of
3742   different types match in an error message.][42826]
3743
3744 Libraries
3745 ---------
3746
3747
3748 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3749 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3750   tuples.][43011]
3751 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3752   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3753 - [Impl `Clone` for `DefaultHasher`.][42799]
3754 - [Impl `Sync` for `SyncSender`.][42397]
3755 - [Impl `FromStr` for `char`][42271]
3756 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3757   NaN.][42431]
3758 - [allow messages in the `unimplemented!()` macro.][42155]
3759   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3760 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3761 - [Upgrade to Unicode 10.0.0][42999]
3762 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3763 - [Skip the main thread's manual stack guard on Linux][43072]
3764 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3765 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3766   previously 2^15.
3767 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3768
3769 Stabilized APIs
3770 ---------------
3771
3772 - [`CStr::into_c_string`]
3773 - [`CString::as_c_str`]
3774 - [`CString::into_boxed_c_str`]
3775 - [`Chain::get_mut`]
3776 - [`Chain::get_ref`]
3777 - [`Chain::into_inner`]
3778 - [`Option::get_or_insert_with`]
3779 - [`Option::get_or_insert`]
3780 - [`OsStr::into_os_string`]
3781 - [`OsString::into_boxed_os_str`]
3782 - [`Take::get_mut`]
3783 - [`Take::get_ref`]
3784 - [`Utf8Error::error_len`]
3785 - [`char::EscapeDebug`]
3786 - [`char::escape_debug`]
3787 - [`compile_error!`]
3788 - [`f32::from_bits`]
3789 - [`f32::to_bits`]
3790 - [`f64::from_bits`]
3791 - [`f64::to_bits`]
3792 - [`mem::ManuallyDrop`]
3793 - [`slice::sort_unstable_by_key`]
3794 - [`slice::sort_unstable_by`]
3795 - [`slice::sort_unstable`]
3796 - [`str::from_boxed_utf8_unchecked`]
3797 - [`str::as_bytes_mut`]
3798 - [`str::as_bytes_mut`]
3799 - [`str::from_utf8_mut`]
3800 - [`str::from_utf8_unchecked_mut`]
3801 - [`str::get_mut`]
3802 - [`str::get_unchecked_mut`]
3803 - [`str::get_unchecked`]
3804 - [`str::get`]
3805 - [`str::into_boxed_bytes`]
3806
3807
3808 Cargo
3809 -----
3810 - [Cargo API token location moved from `~/.cargo/config` to
3811   `~/.cargo/credentials`.][cargo/3978]
3812 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3813   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3814   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3815 - [You can now specify version of a binary when installed through
3816   `cargo install` using `--vers`.][cargo/4229]
3817 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3818   failure.][cargo/4248]
3819 - [Changed the convention around which file is the crate root.][cargo/4259]
3820 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3821   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3822
3823 Compatibility Notes
3824 -------------------
3825
3826 - [Functions with `'static` in their return types will now not be as usable as
3827   if they were using lifetime parameters instead.][42417]
3828 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3829   takes the sign of NaN into account where previously didn't.][42430]
3830
3831 [42033]: https://github.com/rust-lang/rust/pull/42033
3832 [42155]: https://github.com/rust-lang/rust/pull/42155
3833 [42271]: https://github.com/rust-lang/rust/pull/42271
3834 [42397]: https://github.com/rust-lang/rust/pull/42397
3835 [42417]: https://github.com/rust-lang/rust/pull/42417
3836 [42430]: https://github.com/rust-lang/rust/pull/42430
3837 [42431]: https://github.com/rust-lang/rust/pull/42431
3838 [42533]: https://github.com/rust-lang/rust/pull/42533
3839 [42571]: https://github.com/rust-lang/rust/pull/42571
3840 [42613]: https://github.com/rust-lang/rust/pull/42613
3841 [42799]: https://github.com/rust-lang/rust/pull/42799
3842 [42807]: https://github.com/rust-lang/rust/pull/42807
3843 [42809]: https://github.com/rust-lang/rust/pull/42809
3844 [42822]: https://github.com/rust-lang/rust/pull/42822
3845 [42826]: https://github.com/rust-lang/rust/pull/42826
3846 [42854]: https://github.com/rust-lang/rust/pull/42854
3847 [42913]: https://github.com/rust-lang/rust/pull/42913
3848 [42999]: https://github.com/rust-lang/rust/pull/42999
3849 [43011]: https://github.com/rust-lang/rust/pull/43011
3850 [43015]: https://github.com/rust-lang/rust/pull/43015
3851 [43072]: https://github.com/rust-lang/rust/pull/43072
3852 [43077]: https://github.com/rust-lang/rust/pull/43077
3853 [43097]: https://github.com/rust-lang/rust/pull/43097
3854 [43099]: https://github.com/rust-lang/rust/pull/43099
3855 [43170]: https://github.com/rust-lang/rust/pull/43170
3856 [43178]: https://github.com/rust-lang/rust/pull/43178
3857 [43185]: https://github.com/rust-lang/rust/pull/43185
3858 [43228]: https://github.com/rust-lang/rust/pull/43228
3859 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3860 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3861 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3862 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3863 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3864 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3865 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3866 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3867 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3868 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3869 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3870 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3871 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3872 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3873 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3874 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3875 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3876 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3877 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3878 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3879 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3880 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3881 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3882 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3883 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3884 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3885 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3886 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3887 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3888 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3889 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3890 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3891 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3892 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3893 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3894 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3895 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3896 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3897 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3898
3899
3900 Version 1.19.0 (2017-07-20)
3901 ===========================
3902
3903 Language
3904 --------
3905
3906 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3907   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3908 - [Macro recursion limit increased to 1024 from 64.][41676]
3909 - [Added lint for detecting unused macros.][41907]
3910 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3911   For example: `let x = loop { break 7; };`
3912 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3913   contain `Copy` types and cannot have a `Drop` implementation.
3914   Example: `union Foo { bar: u8, baz: usize }`
3915 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3916   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3917
3918 Compiler
3919 --------
3920
3921 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3922 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3923   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3924   you should use `--target armv7-linux-androideabi`.
3925 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3926 - [Minor optimisation of string operations.][42037]
3927 - [Compiler error message is now `aborting due to previous error(s)` instead of
3928   `aborting due to N previous errors`][42150] This was previously inaccurate and
3929   would only count certain kinds of errors.
3930 - [The compiler now supports Visual Studio 2017][42225]
3931 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3932 - [Added a lot][42264] of [new error codes][42302]
3933 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3934   libraries with C Run-time Libraries(CRT) to be statically linked.
3935 - [Fixed various ARM codegen bugs][42740]
3936
3937 Libraries
3938 ---------
3939
3940 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3941   `Extend<Cow<'a, str>>`][41449]
3942 - [`Vec` now implements `From<&mut [T]>`][41530]
3943 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3944 - [`SplitWhitespace` now implements `Clone`][41659]
3945 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3946   1.5x faster][41764]
3947 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3948   macros, but for printing to stderr.
3949
3950 Stabilized APIs
3951 ---------------
3952
3953 - [`OsString::shrink_to_fit`]
3954 - [`cmp::Reverse`]
3955 - [`Command::envs`]
3956 - [`thread::ThreadId`]
3957
3958 Cargo
3959 -----
3960
3961 - [Build scripts can now add environment variables to the environment
3962   the crate is being compiled in.
3963   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3964 - [Subcommands now replace the current process rather than spawning a new
3965   child process][cargo/3970]
3966 - [Workspace members can now accept glob file patterns][cargo/3979]
3967 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3968   the members in a given workspace.][cargo/3988]
3969 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3970 - [Target directory path is now in the cargo metadata][cargo/4022]
3971 - [Cargo no longer checks out a local working directory for the
3972   crates.io index][cargo/4026] This should provide smaller file size for the
3973   registry, and improve cloning times, especially on Windows machines.
3974 - [Added an `--exclude` option for excluding certain packages when using the
3975   `--all` option][cargo/4031]
3976 - [Cargo will now automatically retry when receiving a 5xx error
3977   from crates.io][cargo/4032]
3978 - [The `--features` option now accepts multiple comma or space
3979   delimited values.][cargo/4084]
3980 - [Added support for custom target specific runners][cargo/3954]
3981
3982 Misc
3983 ----
3984
3985 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3986   Windows Debugger.
3987 - [Rust will now release XZ compressed packages][rust-installer/57]
3988 - [rustup will now prefer to download rust packages with
3989   XZ compression][rustup/1100] over GZip packages.
3990 - [Added the ability to escape `#` in rust documentation][41785] By adding
3991   additional `#`'s ie. `##` is now `#`
3992
3993 Compatibility Notes
3994 -------------------
3995
3996 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3997 - [`-Z` flags are now no longer allowed to be used on the stable
3998   compiler.][41751] This has been a warning for a year previous to this.
3999 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4000   longer works][42844]. Users should migrate to the built-in `check`
4001   command, which has been available since 1.16.
4002 - [Ending a float literal with `._` is now a hard error.
4003   Example: `42._` .][41946]
4004 - [Any use of a private `extern crate` outside of its module is now a
4005   hard error.][36886] This was previously a warning.
4006 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4007   relative while the `::` prefix makes a path absolute, but was ignored and the
4008   path was relative regardless.
4009 - [Floating point constants in match patterns is now a hard error][36890]
4010   This was previously a warning.
4011 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4012   match patterns is now a hard error][36891] This was previously a warning.
4013 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4014   a warning.
4015 - [From the pound escape, lines consisting of multiple `#`s are
4016   now visible][41785]
4017 - [It is an error to re-export private enum variants][42460]. This is
4018   known to break a number of crates that depend on an older version of
4019   mustache.
4020 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4021   to use it to find the linker, and the build will fail where it did
4022   not previously][42607]
4023
4024 [36886]: https://github.com/rust-lang/rust/issues/36886
4025 [36888]: https://github.com/rust-lang/rust/issues/36888
4026 [36890]: https://github.com/rust-lang/rust/issues/36890
4027 [36891]: https://github.com/rust-lang/rust/issues/36891
4028 [36892]: https://github.com/rust-lang/rust/issues/36892
4029 [37406]: https://github.com/rust-lang/rust/issues/37406
4030 [39983]: https://github.com/rust-lang/rust/pull/39983
4031 [41145]: https://github.com/rust-lang/rust/pull/41145
4032 [41192]: https://github.com/rust-lang/rust/pull/41192
4033 [41258]: https://github.com/rust-lang/rust/pull/41258
4034 [41370]: https://github.com/rust-lang/rust/pull/41370
4035 [41449]: https://github.com/rust-lang/rust/pull/41449
4036 [41530]: https://github.com/rust-lang/rust/pull/41530
4037 [41624]: https://github.com/rust-lang/rust/pull/41624
4038 [41656]: https://github.com/rust-lang/rust/pull/41656
4039 [41659]: https://github.com/rust-lang/rust/pull/41659
4040 [41676]: https://github.com/rust-lang/rust/pull/41676
4041 [41751]: https://github.com/rust-lang/rust/pull/41751
4042 [41764]: https://github.com/rust-lang/rust/pull/41764
4043 [41785]: https://github.com/rust-lang/rust/pull/41785
4044 [41873]: https://github.com/rust-lang/rust/pull/41873
4045 [41907]: https://github.com/rust-lang/rust/pull/41907
4046 [41946]: https://github.com/rust-lang/rust/pull/41946
4047 [42016]: https://github.com/rust-lang/rust/pull/42016
4048 [42037]: https://github.com/rust-lang/rust/pull/42037
4049 [42068]: https://github.com/rust-lang/rust/pull/42068
4050 [42150]: https://github.com/rust-lang/rust/pull/42150
4051 [42162]: https://github.com/rust-lang/rust/pull/42162
4052 [42225]: https://github.com/rust-lang/rust/pull/42225
4053 [42264]: https://github.com/rust-lang/rust/pull/42264
4054 [42302]: https://github.com/rust-lang/rust/pull/42302
4055 [42460]: https://github.com/rust-lang/rust/issues/42460
4056 [42607]: https://github.com/rust-lang/rust/issues/42607
4057 [42740]: https://github.com/rust-lang/rust/pull/42740
4058 [42844]: https://github.com/rust-lang/rust/issues/42844
4059 [42948]: https://github.com/rust-lang/rust/pull/42948
4060 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
4061 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
4062 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
4063 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
4064 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
4065 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
4066 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
4067 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
4068 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
4069 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
4070 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
4071 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
4072 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
4073 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
4074 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
4075 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
4076 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
4077 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
4078 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
4079 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
4080 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
4081 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
4082
4083
4084 Version 1.18.0 (2017-06-08)
4085 ===========================
4086
4087 Language
4088 --------
4089
4090 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
4091   make the item visible to just that module tree. Also accepts the keyword
4092   `crate` to make something public to the whole crate but not users of the
4093   library. Example: `pub(crate) mod utils;`. [RFC 1422].
4094 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
4095   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
4096 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
4097   types like `Write + Send`, trailing `+` are now supported in trait objects,
4098   and better error reporting for trait objects starting with `?Sized`.
4099 - [0e+10 is now a valid floating point literal][40589]
4100 - [Now warns if you bind a lifetime parameter to 'static][40734]
4101 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
4102   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
4103   representation in some cases.][40377]
4104
4105 Compiler
4106 --------
4107
4108 - [rustc can now emit mir with `--emit mir`][39891]
4109 - [Improved LLVM IR for trivial functions][40367]
4110 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
4111 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
4112   opportunities found through profiling
4113 - [Improved backtrace formatting when panicking][38165]
4114
4115 Libraries
4116 ---------
4117
4118 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
4119   iterator hasn't been advanced the original `Vec` is reassembled with no actual
4120   iteration or reallocation.
4121 - [Simplified HashMap Bucket interface][40561] provides performance
4122   improvements for iterating and cloning.
4123 - [Specialize Vec::from_elem to use calloc][40409]
4124 - [Fixed Race condition in fs::create_dir_all][39799]
4125 - [No longer caching stdio on Windows][40516]
4126 - [Optimized insertion sort in slice][40807] insertion sort in some cases
4127   2.50%~ faster and in one case now 12.50% faster.
4128 - [Optimized `AtomicBool::fetch_nand`][41143]
4129
4130 Stabilized APIs
4131 ---------------
4132
4133 - [`Child::try_wait`]
4134 - [`HashMap::retain`]
4135 - [`HashSet::retain`]
4136 - [`PeekMut::pop`]
4137 - [`TcpStream::peek`]
4138 - [`UdpSocket::peek`]
4139 - [`UdpSocket::peek_from`]
4140
4141 Cargo
4142 -----
4143
4144 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
4145   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
4146 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
4147 - [Added Android build support][cargo/3885]
4148 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
4149   of a certain type, for example `cargo build --bins` will build all
4150   binaries.
4151 - [Added support for haiku][cargo/3952]
4152
4153 Misc
4154 ----
4155
4156 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
4157 - [Added rust-windbg script for better debugging on Windows][39983]
4158 - [Rust now uses the official cross compiler for NetBSD][40612]
4159 - [rustdoc now accepts `#` at the start of files][40828]
4160 - [Fixed jemalloc support for musl][41168]
4161
4162 Compatibility Notes
4163 -------------------
4164
4165 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
4166   always placed after the sign if it exists and before the digits. With the `#`
4167   flag the zeroes are placed after the prefix and before the digits.
4168 - [Due to the struct field optimisation][40377], using `transmute` on structs
4169   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
4170   always been undefined behavior, but is now more likely to break in practice.
4171 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
4172   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
4173   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
4174 - [Overlapping inherent `impl`s are now a hard error][40728]
4175 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
4176 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
4177   `out.asm` and `out.ll` instead of only one of the filetypes.
4178 - [ calling a function that returns `Self` will no longer work][41805] when
4179   the size of `Self` cannot be statically determined.
4180 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
4181   this has caused a few regressions namely:
4182
4183   - Changed the link order of local static/dynamic libraries (respecting the
4184     order on given rather than having the compiler reorder).
4185   - Changed how MinGW is linked, native code linked to dynamic libraries
4186     may require manually linking to the gcc support library (for the native
4187     code itself)
4188
4189 [38165]: https://github.com/rust-lang/rust/pull/38165
4190 [39799]: https://github.com/rust-lang/rust/pull/39799
4191 [39891]: https://github.com/rust-lang/rust/pull/39891
4192 [39983]: https://github.com/rust-lang/rust/pull/39983
4193 [40043]: https://github.com/rust-lang/rust/pull/40043
4194 [40241]: https://github.com/rust-lang/rust/pull/40241
4195 [40338]: https://github.com/rust-lang/rust/pull/40338
4196 [40367]: https://github.com/rust-lang/rust/pull/40367
4197 [40377]: https://github.com/rust-lang/rust/pull/40377
4198 [40409]: https://github.com/rust-lang/rust/pull/40409
4199 [40516]: https://github.com/rust-lang/rust/pull/40516
4200 [40556]: https://github.com/rust-lang/rust/pull/40556
4201 [40561]: https://github.com/rust-lang/rust/pull/40561
4202 [40589]: https://github.com/rust-lang/rust/pull/40589
4203 [40612]: https://github.com/rust-lang/rust/pull/40612
4204 [40723]: https://github.com/rust-lang/rust/pull/40723
4205 [40728]: https://github.com/rust-lang/rust/pull/40728
4206 [40731]: https://github.com/rust-lang/rust/pull/40731
4207 [40734]: https://github.com/rust-lang/rust/pull/40734
4208 [40805]: https://github.com/rust-lang/rust/pull/40805
4209 [40807]: https://github.com/rust-lang/rust/pull/40807
4210 [40828]: https://github.com/rust-lang/rust/pull/40828
4211 [40870]: https://github.com/rust-lang/rust/pull/40870
4212 [41085]: https://github.com/rust-lang/rust/pull/41085
4213 [41143]: https://github.com/rust-lang/rust/pull/41143
4214 [41168]: https://github.com/rust-lang/rust/pull/41168
4215 [41270]: https://github.com/rust-lang/rust/issues/41270
4216 [41469]: https://github.com/rust-lang/rust/pull/41469
4217 [41805]: https://github.com/rust-lang/rust/issues/41805
4218 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
4219 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
4220 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
4221 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
4222 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
4223 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
4224 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
4225 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
4226 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
4227 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
4228 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
4229 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
4230 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
4231 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
4232
4233
4234 Version 1.17.0 (2017-04-27)
4235 ===========================
4236
4237 Language
4238 --------
4239
4240 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
4241 * [Fields of structs may be initialized without duplicating the field/variable
4242   names][39761]. [RFC 1682]
4243 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
4244 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4245   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
4246   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
4247   `'b`. Soundness fix.
4248 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
4249 * [Static variables may contain references to other statics][40027]
4250
4251 Compiler
4252 --------
4253
4254 * [Exit quickly on only `--emit dep-info`][40336]
4255 * [Make `-C relocation-model` more correctly determine whether the linker
4256   creates a position-independent executable][40245]
4257 * [Add `-C overflow-checks` to directly control whether integer overflow
4258   panics][40037]
4259 * [The rustc type checker now checks items on demand instead of in a single
4260   in-order pass][40008]. This is mostly an internal refactoring in support of
4261   future work, including incremental type checking, but also resolves [RFC
4262   1647], allowing `Self` to appear in `impl` `where` clauses.
4263 * [Optimize vtable loads][39995]
4264 * [Turn off vectorization for Emscripten targets][39990]
4265 * [Provide suggestions for unknown macros imported with `use`][39953]
4266 * [Fix ICEs in path resolution][39939]
4267 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
4268 * [Add clearer error message using `&str + &str`][39116]
4269
4270 Stabilized APIs
4271 ---------------
4272
4273 * [`Arc::into_raw`]
4274 * [`Arc::from_raw`]
4275 * [`Arc::ptr_eq`]
4276 * [`Rc::into_raw`]
4277 * [`Rc::from_raw`]
4278 * [`Rc::ptr_eq`]
4279 * [`Ordering::then`]
4280 * [`Ordering::then_with`]
4281 * [`BTreeMap::range`]
4282 * [`BTreeMap::range_mut`]
4283 * [`collections::Bound`]
4284 * [`process::abort`]
4285 * [`ptr::read_unaligned`]
4286 * [`ptr::write_unaligned`]
4287 * [`Result::expect_err`]
4288 * [`Cell::swap`]
4289 * [`Cell::replace`]
4290 * [`Cell::into_inner`]
4291 * [`Cell::take`]
4292
4293 Libraries
4294 ---------
4295
4296 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4297 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4298 * [`String` implements `FromIterator<&char>`][40028]
4299 * `Box` [implements][40009] a number of new conversions:
4300   `From<Box<str>> for String`,
4301   `From<Box<[T]>> for Vec<T>`,
4302   `From<Box<CStr>> for CString`,
4303   `From<Box<OsStr>> for OsString`,
4304   `From<Box<Path>> for PathBuf`,
4305   `Into<Box<str>> for String`,
4306   `Into<Box<[T]>> for Vec<T>`,
4307   `Into<Box<CStr>> for CString`,
4308   `Into<Box<OsStr>> for OsString`,
4309   `Into<Box<Path>> for PathBuf`,
4310   `Default for Box<str>`,
4311   `Default for Box<CStr>`,
4312   `Default for Box<OsStr>`,
4313   `From<&CStr> for Box<CStr>`,
4314   `From<&OsStr> for Box<OsStr>`,
4315   `From<&Path> for Box<Path>`
4316 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4317 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4318 * [Slightly optimize `slice::sort`][39538]
4319 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4320 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4321   `Box<str>` implements `From<&str>`][39438]
4322 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4323   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4324 * [`format!` estimates the needed capacity before writing a string][39356]
4325 * [Support unprivileged symlink creation in Windows][38921]
4326 * [`PathBuf` implements `Default`][38764]
4327 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4328 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4329   and poor hash functions.
4330
4331 Cargo
4332 -----
4333
4334 * [Add `cargo check --all`][cargo/3731]
4335 * [Add an option to ignore SSL revocation checking][cargo/3699]
4336 * [Add `cargo run --package`][cargo/3691]
4337 * [Add `required_features`][cargo/3667]
4338 * [Assume `build.rs` is a build script][cargo/3664]
4339 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4340
4341 Misc
4342 ----
4343
4344 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4345   `rustbook`][39633]
4346 * [The "Unstable Book" documents nightly-only features][ubook]
4347 * [Improve the style of the sidebar in rustdoc output][40265]
4348 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4349 * [Fix MSP430 breakage due to `i128`][40257]
4350 * [Preliminary Solaris/SPARCv9 support][39903]
4351 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4352   run without installing the MSVC runtime.
4353 * [`rustdoc --test` includes file names in test names][39788]
4354 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4355   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4356 * [Initial support for `aarch64-unknown-freebsd`][39491]
4357 * [Initial support for `i686-unknown-netbsd`][39426]
4358 * [This release no longer includes the old makefile build system][39431]. Rust
4359   is built with a custom build system, written in Rust, and with Cargo.
4360 * [Add Debug implementations for libcollection structs][39002]
4361 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4362 * [`--test-threads=0` produces an error][38945]
4363 * [`rustup` installs documentation by default][40526]
4364 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4365   WinDbg and Visual Studio to improve the debugging experience.
4366
4367 Compatibility Notes
4368 -------------------
4369
4370 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4371   workaround, either use MSVC 2015 or run vcvars.bat.
4372 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4373   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4374   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4375   fix.
4376 * [`format!` and `Display::to_string` panic if an underlying formatting
4377   implementation returns an error][40117]. Previously the error was silently
4378   ignored. It is incorrect for `write_fmt` to return an error when writing
4379   to a string.
4380 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4381   crates were marked stable and could be accessed from the stable toolchain.
4382 * [Rust git source no longer includes vendored crates][39728]. Those that need
4383   to build with vendored crates should build from release tarballs.
4384 * [Fix inert attributes from `proc_macro_derives`][39572]
4385 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4386   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4387   build system.
4388 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4389   existing code generally ignores the type of dead-code unless a type-hint is
4390   provided; this can cause surprising inference interactions particularly around
4391   defaulting. The new code uniformly ignores the result type of dead-code.
4392 * [Tuple-struct constructors with private fields are no longer visible][38932]
4393 * [Lifetime parameters that do not appear in the arguments are now considered
4394   early-bound][38897], resolving a soundness bug (#[32330]). The
4395   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4396   April of 2016.
4397 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4398 * [Make transmuting from fn item types to pointer-sized types a hard
4399   error][34198]
4400
4401 [27787]: https://github.com/rust-lang/rust/issues/27787
4402 [32330]: https://github.com/rust-lang/rust/issues/32330
4403 [34198]: https://github.com/rust-lang/rust/pull/34198
4404 [38161]: https://github.com/rust-lang/rust/pull/38161
4405 [38368]: https://github.com/rust-lang/rust/pull/38368
4406 [38584]: https://github.com/rust-lang/rust/issues/38584
4407 [38661]: https://github.com/rust-lang/rust/pull/38661
4408 [38764]: https://github.com/rust-lang/rust/pull/38764
4409 [38864]: https://github.com/rust-lang/rust/issues/38864
4410 [38897]: https://github.com/rust-lang/rust/pull/38897
4411 [38921]: https://github.com/rust-lang/rust/pull/38921
4412 [38932]: https://github.com/rust-lang/rust/pull/38932
4413 [38945]: https://github.com/rust-lang/rust/pull/38945
4414 [38981]: https://github.com/rust-lang/rust/pull/38981
4415 [39002]: https://github.com/rust-lang/rust/pull/39002
4416 [39116]: https://github.com/rust-lang/rust/pull/39116
4417 [39193]: https://github.com/rust-lang/rust/pull/39193
4418 [39265]: https://github.com/rust-lang/rust/pull/39265
4419 [39356]: https://github.com/rust-lang/rust/pull/39356
4420 [39372]: https://github.com/rust-lang/rust/pull/39372
4421 [39426]: https://github.com/rust-lang/rust/pull/39426
4422 [39431]: https://github.com/rust-lang/rust/pull/39431
4423 [39438]: https://github.com/rust-lang/rust/pull/39438
4424 [39440]: https://github.com/rust-lang/rust/pull/39440
4425 [39485]: https://github.com/rust-lang/rust/pull/39485
4426 [39491]: https://github.com/rust-lang/rust/pull/39491
4427 [39518]: https://github.com/rust-lang/rust/pull/39518
4428 [39538]: https://github.com/rust-lang/rust/pull/39538
4429 [39572]: https://github.com/rust-lang/rust/pull/39572
4430 [39633]: https://github.com/rust-lang/rust/pull/39633
4431 [39642]: https://github.com/rust-lang/rust/pull/39642
4432 [39728]: https://github.com/rust-lang/rust/pull/39728
4433 [39761]: https://github.com/rust-lang/rust/pull/39761
4434 [39788]: https://github.com/rust-lang/rust/pull/39788
4435 [39793]: https://github.com/rust-lang/rust/pull/39793
4436 [39837]: https://github.com/rust-lang/rust/pull/39837
4437 [39843]: https://github.com/rust-lang/rust/pull/39843
4438 [39851]: https://github.com/rust-lang/rust/pull/39851
4439 [39903]: https://github.com/rust-lang/rust/pull/39903
4440 [39939]: https://github.com/rust-lang/rust/pull/39939
4441 [39953]: https://github.com/rust-lang/rust/pull/39953
4442 [39960]: https://github.com/rust-lang/rust/pull/39960
4443 [39990]: https://github.com/rust-lang/rust/pull/39990
4444 [39995]: https://github.com/rust-lang/rust/pull/39995
4445 [40008]: https://github.com/rust-lang/rust/pull/40008
4446 [40009]: https://github.com/rust-lang/rust/pull/40009
4447 [40027]: https://github.com/rust-lang/rust/pull/40027
4448 [40028]: https://github.com/rust-lang/rust/pull/40028
4449 [40037]: https://github.com/rust-lang/rust/pull/40037
4450 [40117]: https://github.com/rust-lang/rust/pull/40117
4451 [40166]: https://github.com/rust-lang/rust/pull/40166
4452 [40245]: https://github.com/rust-lang/rust/pull/40245
4453 [40257]: https://github.com/rust-lang/rust/pull/40257
4454 [40261]: https://github.com/rust-lang/rust/pull/40261
4455 [40265]: https://github.com/rust-lang/rust/pull/40265
4456 [40319]: https://github.com/rust-lang/rust/pull/40319
4457 [40336]: https://github.com/rust-lang/rust/pull/40336
4458 [40526]: https://github.com/rust-lang/rust/pull/40526
4459 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4460 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4461 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4462 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4463 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4464 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4465 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4466 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4467 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4468 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4469 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4470 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4471 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4472 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4473 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4474 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4475 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4476 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4477 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4478 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4479 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4480 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4481 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4482 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4483 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4484 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4485 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4486 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4487 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4488 [mdbook]: https://crates.io/crates/mdbook
4489 [ubook]: https://doc.rust-lang.org/unstable-book/
4490
4491
4492 Version 1.16.0 (2017-03-16)
4493 ===========================
4494
4495 Language
4496 --------
4497
4498 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4499 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4500   match patterns][38069]
4501 * [Clean up semantics of `self` in an import list][38313]
4502 * [`Self` may appear in `impl` headers][38920]
4503 * [`Self` may appear in struct expressions][39282]
4504
4505 Compiler
4506 --------
4507
4508 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4509   a `.rmeta` file containing only crate metadata][38571]. This can be
4510   used by tools like the Rust Language Service to perform
4511   metadata-only builds.
4512 * [Levenshtein based typo suggestions now work in most places, while
4513   previously they worked only for fields and sometimes for local
4514   variables][38927]. Together with the overhaul of "no
4515   resolution"/"unexpected resolution" errors (#[38154]) they result in
4516   large and systematic improvement in resolution diagnostics.
4517 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4518   `U`][38670]
4519 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4520 * [`rustc` no longer attempts to provide "consider using an explicit
4521   lifetime" suggestions][37057]. They were inaccurate.
4522
4523 Stabilized APIs
4524 ---------------
4525
4526 * [`VecDeque::truncate`]
4527 * [`VecDeque::resize`]
4528 * [`String::insert_str`]
4529 * [`Duration::checked_add`]
4530 * [`Duration::checked_sub`]
4531 * [`Duration::checked_div`]
4532 * [`Duration::checked_mul`]
4533 * [`str::replacen`]
4534 * [`str::repeat`]
4535 * [`SocketAddr::is_ipv4`]
4536 * [`SocketAddr::is_ipv6`]
4537 * [`IpAddr::is_ipv4`]
4538 * [`IpAddr::is_ipv6`]
4539 * [`Vec::dedup_by`]
4540 * [`Vec::dedup_by_key`]
4541 * [`Result::unwrap_or_default`]
4542 * [`<*const T>::wrapping_offset`]
4543 * [`<*mut T>::wrapping_offset`]
4544 * `CommandExt::creation_flags`
4545 * [`File::set_permissions`]
4546 * [`String::split_off`]
4547
4548 Libraries
4549 ---------
4550
4551 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4552   their argument by `Borrow` parameter][37761]
4553 * [All public types in std implement `Debug`][38006]
4554 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4555 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4556 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4557   Windows][38274]
4558 * [std: Fix partial writes in `LineWriter`][38062]
4559 * [std: Clamp max read/write sizes on Unix][38062]
4560 * [Use more specific panic message for `&str` slicing errors][38066]
4561 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4562   functionality cannot be achieved in std currently.
4563 * [`writeln!`, like `println!`, now accepts a form with no string
4564   or formatting arguments, to just print a newline][38469]
4565 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4566 * [Reduce the size of static data in `std_unicode::tables`][38781]
4567 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4568   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4569   `Display`][38909]
4570 * [`Duration` implements `Sum`][38712]
4571 * [`String` implements `ToSocketAddrs`][39048]
4572
4573 Cargo
4574 -----
4575
4576 * [The `cargo check` command does a type check of a project without
4577   building it][cargo/3296]
4578 * [crates.io will display CI badges from Travis and AppVeyor, if
4579   specified in Cargo.toml][cargo/3546]
4580 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4581 * [Compilation profiles accept integer values for `debug`, in addition
4582   to `true` and `false`. These are passed to `rustc` as the value to
4583   `-C debuginfo`][cargo/3534]
4584 * [Implement `cargo --version --verbose`][cargo/3604]
4585 * [All builds now output 'dep-info' build dependencies compatible with
4586   make and ninja][cargo/3557]
4587 * [Build all workspace members with `build --all`][cargo/3511]
4588 * [Document all workspace members with `doc --all`][cargo/3515]
4589 * [Path deps outside workspace are not members][cargo/3443]
4590
4591 Misc
4592 ----
4593
4594 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4595   the path to the Rust implementation][38589]
4596 * [The `armv7-linux-androideabi` target no longer enables NEON
4597   extensions, per Google's ABI guide][38413]
4598 * [The stock standard library can be compiled for Redox OS][38401]
4599 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4600   available.
4601 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4602   builds available.
4603 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4604
4605 Compatibility Notes
4606 -------------------
4607
4608 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4609   match patterns][38069]
4610 * In this release, references to uninhabited types can not be
4611   pattern-matched. This was accidentally allowed in 1.15.
4612 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4613 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4614   Windows][38274]
4615 * [Clean up semantics of `self` in an import list][38313]
4616 * Reimplemented lifetime elision. This change was almost entirely compatible
4617   with existing code, but it did close a number of small bugs and loopholes,
4618   as well as being more accepting in some other [cases][41105].
4619
4620 [37057]: https://github.com/rust-lang/rust/pull/37057
4621 [37761]: https://github.com/rust-lang/rust/pull/37761
4622 [38006]: https://github.com/rust-lang/rust/pull/38006
4623 [38051]: https://github.com/rust-lang/rust/pull/38051
4624 [38062]: https://github.com/rust-lang/rust/pull/38062
4625 [38062]: https://github.com/rust-lang/rust/pull/38622
4626 [38066]: https://github.com/rust-lang/rust/pull/38066
4627 [38069]: https://github.com/rust-lang/rust/pull/38069
4628 [38131]: https://github.com/rust-lang/rust/pull/38131
4629 [38154]: https://github.com/rust-lang/rust/pull/38154
4630 [38274]: https://github.com/rust-lang/rust/pull/38274
4631 [38304]: https://github.com/rust-lang/rust/pull/38304
4632 [38313]: https://github.com/rust-lang/rust/pull/38313
4633 [38314]: https://github.com/rust-lang/rust/pull/38314
4634 [38327]: https://github.com/rust-lang/rust/pull/38327
4635 [38401]: https://github.com/rust-lang/rust/pull/38401
4636 [38413]: https://github.com/rust-lang/rust/pull/38413
4637 [38469]: https://github.com/rust-lang/rust/pull/38469
4638 [38559]: https://github.com/rust-lang/rust/pull/38559
4639 [38571]: https://github.com/rust-lang/rust/pull/38571
4640 [38580]: https://github.com/rust-lang/rust/pull/38580
4641 [38589]: https://github.com/rust-lang/rust/pull/38589
4642 [38670]: https://github.com/rust-lang/rust/pull/38670
4643 [38712]: https://github.com/rust-lang/rust/pull/38712
4644 [38726]: https://github.com/rust-lang/rust/pull/38726
4645 [38781]: https://github.com/rust-lang/rust/pull/38781
4646 [38798]: https://github.com/rust-lang/rust/pull/38798
4647 [38909]: https://github.com/rust-lang/rust/pull/38909
4648 [38920]: https://github.com/rust-lang/rust/pull/38920
4649 [38927]: https://github.com/rust-lang/rust/pull/38927
4650 [39048]: https://github.com/rust-lang/rust/pull/39048
4651 [39282]: https://github.com/rust-lang/rust/pull/39282
4652 [39379]: https://github.com/rust-lang/rust/pull/39379
4653 [41105]: https://github.com/rust-lang/rust/issues/41105
4654 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4655 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4656 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4657 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4658 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4659 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4660 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4661 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4662 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4663 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4664 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4665 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4666 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4667 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4668 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4669 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4670 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4671 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4672 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4673 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4674 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4675 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4676 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4677 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4678 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4679 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4680 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4681 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4682 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4683 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4684
4685
4686 Version 1.15.1 (2017-02-09)
4687 ===========================
4688
4689 * [Fix IntoIter::as_mut_slice's signature][39466]
4690 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4691
4692 [39466]: https://github.com/rust-lang/rust/pull/39466
4693 [39523]: https://github.com/rust-lang/rust/pull/39523
4694
4695
4696 Version 1.15.0 (2017-02-02)
4697 ===========================
4698
4699 Language
4700 --------
4701
4702 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4703   stable. This allows popular code-generating crates like Serde and Diesel to
4704   work ergonomically. [RFC 1681].
4705 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4706   with curly braces][36868]. Part of [RFC 1506].
4707 * [A number of minor changes to name resolution have been activated][37127].
4708   They add up to more consistent semantics, allowing for future evolution of
4709   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4710   details of what is different. The breaking changes here have been transitioned
4711   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4712 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4713   bounds][38279]
4714 * [`?Sized` can be used in `where` clauses][37791]
4715 * [There is now a limit on the size of monomorphized types and it can be
4716   modified with the `#![type_size_limit]` crate attribute, similarly to
4717   the `#![recursion_limit]` attribute][37789]
4718
4719 Compiler
4720 --------
4721
4722 * [On Windows, the compiler will apply dllimport attributes when linking to
4723   extern functions][37973]. Additional attributes and flags can control which
4724   library kind is linked and its name. [RFC 1717].
4725 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4726 * [The `--test` flag works with procedural macro crates][38107]
4727 * [Fix `extern "aapcs" fn` ABI][37814]
4728 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4729 * [The `format!` expander recognizes incorrect `printf` and shell-style
4730   formatting directives and suggests the correct format][37613].
4731 * [Only report one error for all unused imports in an import list][37456]
4732
4733 Compiler Performance
4734 --------------------
4735
4736 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4737 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4738 * [Don't clone in `UnificationTable::probe`][37848]
4739 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4740 * [Use small vectors in type walker][37760]
4741 * [Macro expansion performance was improved][37701]
4742 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4743 * [Replace FNV with a faster hash function][37229]
4744
4745 Stabilized APIs
4746 ---------------
4747
4748 * [`std::iter::Iterator::min_by`]
4749 * [`std::iter::Iterator::max_by`]
4750 * [`std::os::*::fs::FileExt`]
4751 * [`std::sync::atomic::Atomic*::get_mut`]
4752 * [`std::sync::atomic::Atomic*::into_inner`]
4753 * [`std::vec::IntoIter::as_slice`]
4754 * [`std::vec::IntoIter::as_mut_slice`]
4755 * [`std::sync::mpsc::Receiver::try_iter`]
4756 * [`std::os::unix::process::CommandExt::before_exec`]
4757 * [`std::rc::Rc::strong_count`]
4758 * [`std::rc::Rc::weak_count`]
4759 * [`std::sync::Arc::strong_count`]
4760 * [`std::sync::Arc::weak_count`]
4761 * [`std::char::encode_utf8`]
4762 * [`std::char::encode_utf16`]
4763 * [`std::cell::Ref::clone`]
4764 * [`std::io::Take::into_inner`]
4765
4766 Libraries
4767 ---------
4768
4769 * [The standard sorting algorithm has been rewritten for dramatic performance
4770   improvements][38192]. It is a hybrid merge sort, drawing influences from
4771   Timsort. Previously it was a naive merge sort.
4772 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4773 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4774   performance.
4775 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4776   and `char_indices().last()`][37882]
4777 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4778 * [Chinese characters display correctly in `fmt::Debug`][37855]
4779 * [Derive `Default` for `Duration`][37699]
4780 * [Support creation of anonymous pipes on WinXP/2k][37677]
4781 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4782 * [Don't pass overlapped handles to processes][38835]
4783
4784 Cargo
4785 -----
4786
4787 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4788   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4789   should instead check the variable at runtime with `std::env`. That the value
4790   was set at build time was a bug, and incorrect when cross-compiling. This
4791   change is known to cause breakage.
4792 * [Add `--all` flag to `cargo test`][cargo/3221]
4793 * [Compile statically against the MSVC CRT][cargo/3363]
4794 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4795 * [Link OpenSSL statically on OSX][cargo/3311]
4796 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4797 * [Test for bad path overrides with summaries][cargo/3336]
4798 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4799 * [Fix retrying crate downloads for network errors][cargo/3348]
4800 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4801 * [Emit more info on --message-format=json][cargo/3319]
4802 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4803 * [Don't ignore errors in workspace manifest][cargo/3409]
4804 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4805
4806 Tooling
4807 -------
4808
4809 * [Test runners (binaries built with `--test`) now support a `--list` argument
4810   that lists the tests it contains][38185]
4811 * [Test runners now support a `--exact` argument that makes the test filter
4812   match exactly, instead of matching only a substring of the test name][38181]
4813 * [rustdoc supports a `--playground-url` flag][37763]
4814 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4815
4816 Misc
4817 ----
4818
4819 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4820   continue to be used in this release by passing `--disable-rustbuild` to the
4821   configure script, but they will be deleted soon. Note that the new build
4822   system uses a different on-disk layout that will likely affect any scripts
4823   building Rust.
4824 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4825   releases.
4826 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4827 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4828   releases.
4829
4830 Compatibility Notes
4831 -------------------
4832
4833 * [A number of minor changes to name resolution have been activated][37127].
4834   They add up to more consistent semantics, allowing for future evolution of
4835   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4836   details of what is different. The breaking changes here have been transitioned
4837   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4838 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4839   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4840   should instead check the variable at runtime with `std::env`. That the value
4841   was set at build time was a bug, and incorrect when cross-compiling. This
4842   change is known to cause breakage.
4843 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4844   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4845   1.10 and is now an error by default. It will become a hard error in the near
4846   future.
4847 * [The semantics relating modules to file system directories are changing in
4848   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4849   lint, which is a warning in this release, and will become a hard error in the
4850   future.
4851 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4852 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4853   the underlying iterator][37834]
4854
4855 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4856 [33685]: https://github.com/rust-lang/rust/issues/33685
4857 [36868]: https://github.com/rust-lang/rust/pull/36868
4858 [37127]: https://github.com/rust-lang/rust/pull/37127
4859 [37229]: https://github.com/rust-lang/rust/pull/37229
4860 [37456]: https://github.com/rust-lang/rust/pull/37456
4861 [37527]: https://github.com/rust-lang/rust/pull/37527
4862 [37602]: https://github.com/rust-lang/rust/pull/37602
4863 [37613]: https://github.com/rust-lang/rust/pull/37613
4864 [37615]: https://github.com/rust-lang/rust/pull/37615
4865 [37636]: https://github.com/rust-lang/rust/pull/37636
4866 [37627]: https://github.com/rust-lang/rust/pull/37627
4867 [37642]: https://github.com/rust-lang/rust/pull/37642
4868 [37677]: https://github.com/rust-lang/rust/pull/37677
4869 [37699]: https://github.com/rust-lang/rust/pull/37699
4870 [37701]: https://github.com/rust-lang/rust/pull/37701
4871 [37705]: https://github.com/rust-lang/rust/pull/37705
4872 [37749]: https://github.com/rust-lang/rust/pull/37749
4873 [37760]: https://github.com/rust-lang/rust/pull/37760
4874 [37763]: https://github.com/rust-lang/rust/pull/37763
4875 [37764]: https://github.com/rust-lang/rust/pull/37764
4876 [37789]: https://github.com/rust-lang/rust/pull/37789
4877 [37791]: https://github.com/rust-lang/rust/pull/37791
4878 [37814]: https://github.com/rust-lang/rust/pull/37814
4879 [37817]: https://github.com/rust-lang/rust/pull/37817
4880 [37834]: https://github.com/rust-lang/rust/pull/37834
4881 [37848]: https://github.com/rust-lang/rust/pull/37848
4882 [37855]: https://github.com/rust-lang/rust/pull/37855
4883 [37882]: https://github.com/rust-lang/rust/pull/37882
4884 [37888]: https://github.com/rust-lang/rust/pull/37888
4885 [37973]: https://github.com/rust-lang/rust/pull/37973
4886 [37979]: https://github.com/rust-lang/rust/pull/37979
4887 [38086]: https://github.com/rust-lang/rust/pull/38086
4888 [38107]: https://github.com/rust-lang/rust/pull/38107
4889 [38117]: https://github.com/rust-lang/rust/pull/38117
4890 [38134]: https://github.com/rust-lang/rust/pull/38134
4891 [38146]: https://github.com/rust-lang/rust/pull/38146
4892 [38181]: https://github.com/rust-lang/rust/pull/38181
4893 [38182]: https://github.com/rust-lang/rust/pull/38182
4894 [38185]: https://github.com/rust-lang/rust/pull/38185
4895 [38192]: https://github.com/rust-lang/rust/pull/38192
4896 [38279]: https://github.com/rust-lang/rust/pull/38279
4897 [38835]: https://github.com/rust-lang/rust/pull/38835
4898 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4899 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4900 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4901 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4902 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4903 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4904 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4905 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4906 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4907 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4908 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4909 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4910 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4911 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4912 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4913 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4914 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4915 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4916 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4917 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4918 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4919 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4920 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4921 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4922 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4923 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4924 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4925 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4926 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4927 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4928 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4929 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4930 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4931 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4932 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4933 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4934 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4935 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4936
4937
4938 Version 1.14.0 (2016-12-22)
4939 ===========================
4940
4941 Language
4942 --------
4943
4944 * [`..` matches multiple tuple fields in enum variants, structs
4945   and tuples][36843]. [RFC 1492].
4946 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4947 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4948 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4949   dereferencing][36822]
4950
4951 Compiler
4952 --------
4953
4954 * [Mark enums with non-zero discriminant as non-zero][37224]
4955 * [Lower-case `static mut` names are linted like other
4956   statics and consts][37162]
4957 * [Fix ICE on some macros in const integer positions
4958    (e.g. `[u8; m!()]`)][36819]
4959 * [Improve error message and snippet for "did you mean `x`"][36798]
4960 * [Add a panic-strategy field to the target specification][36794]
4961 * [Include LLVM version in `--version --verbose`][37200]
4962
4963 Compile-time Optimizations
4964 --------------------------
4965
4966 * [Improve macro expansion performance][37569]
4967 * [Shrink `Expr_::ExprInlineAsm`][37445]
4968 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4969 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4970 * [Avoid more allocations when compiling html5ever][37373]
4971 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4972 * [Avoid some allocations in the macro parser][37318]
4973 * [Use a faster deflate setting][37298]
4974 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4975   during interning of slices][37270]
4976 * [Optimize `write_metadata`][37267]
4977 * [Don't process obligation forest cycles when stalled][37231]
4978 * [Avoid many `CrateConfig` clones][37161]
4979 * [Optimize `Substs::super_fold_with`][37108]
4980 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4981 * [Speed up `plug_leaks`][36917]
4982
4983 Libraries
4984 ---------
4985
4986 * [`println!()`, with no arguments, prints newline][36825].
4987   Previously, an empty string was required to achieve the same.
4988 * [`Wrapping` impls standard binary and unary operators, as well as
4989    the `Sum` and `Product` iterators][37356]
4990 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4991   Vec<T>`][37326]
4992 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4993   `VecDeque` iterators][37315]
4994 * [Improve `SipHasher` performance on small values][37312]
4995 * [Add Iterator trait TrustedLen to enable better FromIterator /
4996   Extend][37306]
4997 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4998 * [`ReadDir` implements `Debug`][37221]
4999 * [Implement `RefUnwindSafe` for atomic types][37178]
5000 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5001 * [Avoid allocations in `Decoder::read_str`][37064]
5002 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5003 * [Impl `Debug` for raw pointers to unsized data][36880]
5004 * [Don't reuse `HashMap` random seeds][37470]
5005 * [The internal memory layout of `HashMap` is more cache-friendly, for
5006   significant improvements in some operations][36692]
5007 * [`HashMap` uses less memory on 32-bit architectures][36595]
5008 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5009
5010 Cargo
5011 -----
5012
5013 * [Expose rustc cfg values to build scripts][cargo/3243]
5014 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5015 * [Fix passing --features when testing multiple packages][cargo/3280]
5016 * [Use a single profile set per workspace][cargo/3249]
5017 * [Load `replace` sections from lock files][cargo/3220]
5018 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5019
5020 Tooling
5021 -------
5022
5023 * [rustup is the recommended Rust installation method][1.14rustup]
5024 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5025   S390x. These are [tier 2] platforms and may have major defects. Follow the
5026   instructions on the website to install, or add the targets to an existing
5027   installation with `rustup target add`. The new target triples are:
5028   - `mips-unknown-linux-gnu`
5029   - `mipsel-unknown-linux-gnu`
5030   - `mips64-unknown-linux-gnuabi64`
5031   - `mips64el-unknown-linux-gnuabi64 `
5032   - `powerpc-unknown-linux-gnu`
5033   - `powerpc64-unknown-linux-gnu`
5034   - `powerpc64le-unknown-linux-gnu`
5035   - `s390x-unknown-linux-gnu `
5036 * This release includes target (std) builds for ARM Linux running MUSL
5037   libc. These are [tier 2] platforms and may have major defects. Add the
5038   following triples to an existing rustup installation with `rustup target add`:
5039   - `arm-unknown-linux-musleabi`
5040   - `arm-unknown-linux-musleabihf`
5041   - `armv7-unknown-linux-musleabihf`
5042 * This release includes [experimental support for WebAssembly][1.14wasm], via
5043   the `wasm32-unknown-emscripten` target. This target is known to have major
5044   defects. Please test, report, and fix.
5045 * rustup no longer installs documentation by default. Run `rustup
5046   component add rust-docs` to install.
5047 * [Fix line stepping in debugger][37310]
5048 * [Enable line number debuginfo in releases][37280]
5049
5050 Misc
5051 ----
5052
5053 * [Disable jemalloc on aarch64/powerpc/mips][37392]
5054 * [Add support for Fuchsia OS][37313]
5055 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
5056
5057 Compatibility Notes
5058 -------------------
5059
5060 * [A number of forward-compatibility lints used by the compiler
5061   to gradually introduce language changes have been converted
5062   to deny by default][36894]:
5063   - ["use of inaccessible extern crate erroneously allowed"][36886]
5064   - ["type parameter default erroneously allowed in invalid location"][36887]
5065   - ["detects super or self keywords at the beginning of global path"][36888]
5066   - ["two overlapping inherent impls define an item with the same name
5067     were erroneously allowed"][36889]
5068   - ["floating-point constants cannot be used in patterns"][36890]
5069   - ["constants of struct or enum type can only be used in a pattern if
5070      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
5071   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
5072 * [Prohibit patterns in trait methods without bodies][37378]
5073 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
5074 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
5075 * [The `$crate` macro variable is accepted in fewer locations][37213]
5076 * [Impls specifying extra region requirements beyond the trait
5077   they implement are rejected][37167]
5078 * [Enums may not be unsized][37111]. Unsized enums are intended to
5079   work but never have. For now they are forbidden.
5080 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
5081
5082 [tier 2]: https://forge.rust-lang.org/platform-support.html
5083 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
5084 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
5085 [36430]: https://github.com/rust-lang/rust/pull/36430
5086 [36595]: https://github.com/rust-lang/rust/pull/36595
5087 [36595]: https://github.com/rust-lang/rust/pull/36595
5088 [36692]: https://github.com/rust-lang/rust/pull/36692
5089 [36767]: https://github.com/rust-lang/rust/pull/36767
5090 [36794]: https://github.com/rust-lang/rust/pull/36794
5091 [36798]: https://github.com/rust-lang/rust/pull/36798
5092 [36819]: https://github.com/rust-lang/rust/pull/36819
5093 [36822]: https://github.com/rust-lang/rust/pull/36822
5094 [36825]: https://github.com/rust-lang/rust/pull/36825
5095 [36843]: https://github.com/rust-lang/rust/pull/36843
5096 [36880]: https://github.com/rust-lang/rust/pull/36880
5097 [36886]: https://github.com/rust-lang/rust/issues/36886
5098 [36887]: https://github.com/rust-lang/rust/issues/36887
5099 [36888]: https://github.com/rust-lang/rust/issues/36888
5100 [36889]: https://github.com/rust-lang/rust/issues/36889
5101 [36890]: https://github.com/rust-lang/rust/issues/36890
5102 [36891]: https://github.com/rust-lang/rust/issues/36891
5103 [36892]: https://github.com/rust-lang/rust/issues/36892
5104 [36894]: https://github.com/rust-lang/rust/pull/36894
5105 [36917]: https://github.com/rust-lang/rust/pull/36917
5106 [36993]: https://github.com/rust-lang/rust/pull/36993
5107 [37037]: https://github.com/rust-lang/rust/pull/37037
5108 [37064]: https://github.com/rust-lang/rust/pull/37064
5109 [37094]: https://github.com/rust-lang/rust/pull/37094
5110 [37108]: https://github.com/rust-lang/rust/pull/37108
5111 [37111]: https://github.com/rust-lang/rust/pull/37111
5112 [37161]: https://github.com/rust-lang/rust/pull/37161
5113 [37162]: https://github.com/rust-lang/rust/pull/37162
5114 [37167]: https://github.com/rust-lang/rust/pull/37167
5115 [37178]: https://github.com/rust-lang/rust/pull/37178
5116 [37200]: https://github.com/rust-lang/rust/pull/37200
5117 [37213]: https://github.com/rust-lang/rust/pull/37213
5118 [37221]: https://github.com/rust-lang/rust/pull/37221
5119 [37224]: https://github.com/rust-lang/rust/pull/37224
5120 [37230]: https://github.com/rust-lang/rust/pull/37230
5121 [37231]: https://github.com/rust-lang/rust/pull/37231
5122 [37247]: https://github.com/rust-lang/rust/pull/37247
5123 [37267]: https://github.com/rust-lang/rust/pull/37267
5124 [37270]: https://github.com/rust-lang/rust/pull/37270
5125 [37273]: https://github.com/rust-lang/rust/pull/37273
5126 [37280]: https://github.com/rust-lang/rust/pull/37280
5127 [37298]: https://github.com/rust-lang/rust/pull/37298
5128 [37306]: https://github.com/rust-lang/rust/pull/37306
5129 [37310]: https://github.com/rust-lang/rust/pull/37310
5130 [37312]: https://github.com/rust-lang/rust/pull/37312
5131 [37313]: https://github.com/rust-lang/rust/pull/37313
5132 [37315]: https://github.com/rust-lang/rust/pull/37315
5133 [37318]: https://github.com/rust-lang/rust/pull/37318
5134 [37322]: https://github.com/rust-lang/rust/pull/37322
5135 [37326]: https://github.com/rust-lang/rust/pull/37326
5136 [37351]: https://github.com/rust-lang/rust/pull/37351
5137 [37356]: https://github.com/rust-lang/rust/pull/37356
5138 [37367]: https://github.com/rust-lang/rust/pull/37367
5139 [37373]: https://github.com/rust-lang/rust/pull/37373
5140 [37378]: https://github.com/rust-lang/rust/pull/37378
5141 [37389]: https://github.com/rust-lang/rust/pull/37389
5142 [37392]: https://github.com/rust-lang/rust/pull/37392
5143 [37427]: https://github.com/rust-lang/rust/pull/37427
5144 [37439]: https://github.com/rust-lang/rust/pull/37439
5145 [37445]: https://github.com/rust-lang/rust/pull/37445
5146 [37470]: https://github.com/rust-lang/rust/pull/37470
5147 [37569]: https://github.com/rust-lang/rust/pull/37569
5148 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5149 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
5150 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
5151 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
5152 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
5153 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
5154 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
5155
5156
5157 Version 1.13.0 (2016-11-10)
5158 ===========================
5159
5160 Language
5161 --------
5162
5163 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
5164   errors, like the `try!` macro, described in [RFC 0243].
5165 * [Stabilize macros in type position][36014]. Described in [RFC 873].
5166 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
5167 * [Fix `#[derive]` for empty tuple structs/variants][35728]
5168 * [Fix lifetime rules for 'if' conditions][36029]
5169 * [Avoid loading and parsing unconfigured non-inline modules][36482]
5170
5171 Compiler
5172 --------
5173
5174 * [Add the `-C link-arg` argument][36574]
5175 * [Remove the old AST-based backend from rustc_trans][35764]
5176 * [Don't enable NEON by default on armv7 Linux][35814]
5177 * [Fix debug line number info for macro expansions][35238]
5178 * [Do not emit "class method" debuginfo for types that are not
5179   DICompositeType][36008]
5180 * [Warn about multiple conflicting #[repr] hints][34623]
5181 * [When sizing DST, don't double-count nested struct prefixes][36351]
5182 * [Default RUST_MIN_STACK to 16MiB for now][36505]
5183 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
5184 * [Reject macros with empty repetitions to avoid infinite loop][36721]
5185 * [Expand macros without recursing to avoid stack overflows][36214]
5186
5187 Diagnostics
5188 -----------
5189
5190 * [Replace macro backtraces with labeled local uses][35702]
5191 * [Improve error message for misplaced doc comments][33922]
5192 * [Buffer unix and lock windows to prevent message interleaving][35975]
5193 * [Update lifetime errors to specifically note temporaries][36171]
5194 * [Special case a few colors for Windows][36178]
5195 * [Suggest `use self` when such an import resolves][36289]
5196 * [Be more specific when type parameter shadows primitive type][36338]
5197 * Many minor improvements
5198
5199 Compile-time Optimizations
5200 --------------------------
5201
5202 * [Compute and cache HIR hashes at beginning][35854]
5203 * [Don't hash types in loan paths][36004]
5204 * [Cache projections in trans][35761]
5205 * [Optimize the parser's last token handling][36527]
5206 * [Only instantiate #[inline] functions in codegen units referencing
5207   them][36524]. This leads to big improvements in cases where crates export
5208   define many inline functions without using them directly.
5209 * [Lazily allocate TypedArena's first chunk][36592]
5210 * [Don't allocate during default HashSet creation][36734]
5211
5212 Stabilized APIs
5213 ---------------
5214
5215 * [`checked_abs`]
5216 * [`wrapping_abs`]
5217 * [`overflowing_abs`]
5218 * [`RefCell::try_borrow`]
5219 * [`RefCell::try_borrow_mut`]
5220
5221 Libraries
5222 ---------
5223
5224 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
5225 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
5226   covariant][35354]
5227 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
5228 * [Implement `Debug` for `std::vec::IntoIter`][35707]
5229 * [`CString`: avoid excessive growth just to 0-terminate][35871]
5230 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
5231 * [Use arc4rand on FreeBSD][35884]
5232 * [memrchr: Correct aligned offset computation][35969]
5233 * [Improve Demangling of Rust Symbols][36059]
5234 * [Use monotonic time in condition variables][35048]
5235 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
5236 * [Implement conversion traits for `char`][35755]
5237 * [Fix illegal instruction caused by overflow in channel cloning][36104]
5238 * [Zero first byte of CString on drop][36264]
5239 * [Inherit overflow checks for sum and product][36372]
5240 * [Add missing Eq implementations][36423]
5241 * [Implement `Debug` for `DirEntry`][36631]
5242 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
5243   `errno`][36754]
5244 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5245 * [Implement more traits for `std::io::ErrorKind`][35911]
5246 * [Optimize BinaryHeap bounds checking][36072]
5247 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
5248   `extend_with_element`][36355]
5249 * [Fix overflow checking in unsigned pow()][34942]
5250
5251 Cargo
5252 -----
5253
5254 * This release includes security fixes to both curl and OpenSSL.
5255 * [Fix transitive doctests when panic=abort][cargo/3021]
5256 * [Add --all-features flag to cargo][cargo/3038]
5257 * [Reject path-based dependencies in `cargo package`][cargo/3060]
5258 * [Don't parse the home directory more than once][cargo/3078]
5259 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
5260 * [Update OpenSSL to 1.0.2j][cargo/3121]
5261 * [Add license and license_file to cargo metadata output][cargo/3110]
5262 * [Make crates-io registry URL optional in config; ignore all changes to
5263   source.crates-io][cargo/3089]
5264 * [Don't download dependencies from other platforms][cargo/3123]
5265 * [Build transitive dev-dependencies when needed][cargo/3125]
5266 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
5267 * [Avoid updating registry when adding existing deps][cargo/3144]
5268 * [Warn about path overrides that won't work][cargo/3136]
5269 * [Use workspaces during `cargo install`][cargo/3146]
5270 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
5271 * [Add --message-format flag][cargo/3000]
5272 * [Pass target environment for rustdoc][cargo/3205]
5273 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
5274 * [Update curl and curl-sys][cargo/3241]
5275 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
5276
5277 Tooling
5278 -------
5279
5280 * [rustdoc: Add the `--sysroot` argument][36586]
5281 * [rustdoc: Fix a couple of issues with the search results][35655]
5282 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5283 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5284 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5285
5286 Misc
5287 ----
5288
5289 * [Remove unmaintained style guide][35124]
5290 * [Add s390x support][36369]
5291 * [Initial work at Haiku OS support][36727]
5292 * [Add mips-uclibc targets][35734]
5293 * [Crate-ify compiler-rt into compiler-builtins][35021]
5294 * [Add rustc version info (git hash + date) to dist tarball][36213]
5295 * Many documentation improvements
5296
5297 Compatibility Notes
5298 -------------------
5299
5300 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5301 * [Deny (by default) transmuting from fn item types to pointer-sized
5302   types][34923]. Continuing the long transition to zero-sized fn items,
5303   per [RFC 401].
5304 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5305   Part of [RFC 1506].
5306 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5307 * [Fix lifetime rules for 'if' conditions][36029].
5308 * [Inherit overflow checks for sum and product][36372].
5309 * [Forbid user-defined macros named "macro_rules"][36730].
5310
5311 [33922]: https://github.com/rust-lang/rust/pull/33922
5312 [34623]: https://github.com/rust-lang/rust/pull/34623
5313 [34923]: https://github.com/rust-lang/rust/pull/34923
5314 [34942]: https://github.com/rust-lang/rust/pull/34942
5315 [34982]: https://github.com/rust-lang/rust/pull/34982
5316 [35021]: https://github.com/rust-lang/rust/pull/35021
5317 [35048]: https://github.com/rust-lang/rust/pull/35048
5318 [35074]: https://github.com/rust-lang/rust/pull/35074
5319 [35124]: https://github.com/rust-lang/rust/pull/35124
5320 [35234]: https://github.com/rust-lang/rust/pull/35234
5321 [35238]: https://github.com/rust-lang/rust/pull/35238
5322 [35354]: https://github.com/rust-lang/rust/pull/35354
5323 [35559]: https://github.com/rust-lang/rust/pull/35559
5324 [35585]: https://github.com/rust-lang/rust/pull/35585
5325 [35627]: https://github.com/rust-lang/rust/pull/35627
5326 [35655]: https://github.com/rust-lang/rust/pull/35655
5327 [35702]: https://github.com/rust-lang/rust/pull/35702
5328 [35707]: https://github.com/rust-lang/rust/pull/35707
5329 [35728]: https://github.com/rust-lang/rust/pull/35728
5330 [35734]: https://github.com/rust-lang/rust/pull/35734
5331 [35755]: https://github.com/rust-lang/rust/pull/35755
5332 [35761]: https://github.com/rust-lang/rust/pull/35761
5333 [35764]: https://github.com/rust-lang/rust/pull/35764
5334 [35814]: https://github.com/rust-lang/rust/pull/35814
5335 [35854]: https://github.com/rust-lang/rust/pull/35854
5336 [35871]: https://github.com/rust-lang/rust/pull/35871
5337 [35884]: https://github.com/rust-lang/rust/pull/35884
5338 [35911]: https://github.com/rust-lang/rust/pull/35911
5339 [35969]: https://github.com/rust-lang/rust/pull/35969
5340 [35975]: https://github.com/rust-lang/rust/pull/35975
5341 [36004]: https://github.com/rust-lang/rust/pull/36004
5342 [36008]: https://github.com/rust-lang/rust/pull/36008
5343 [36014]: https://github.com/rust-lang/rust/pull/36014
5344 [36029]: https://github.com/rust-lang/rust/pull/36029
5345 [36059]: https://github.com/rust-lang/rust/pull/36059
5346 [36072]: https://github.com/rust-lang/rust/pull/36072
5347 [36101]: https://github.com/rust-lang/rust/pull/36101
5348 [36104]: https://github.com/rust-lang/rust/pull/36104
5349 [36171]: https://github.com/rust-lang/rust/pull/36171
5350 [36173]: https://github.com/rust-lang/rust/pull/36173
5351 [36178]: https://github.com/rust-lang/rust/pull/36178
5352 [36213]: https://github.com/rust-lang/rust/pull/36213
5353 [36214]: https://github.com/rust-lang/rust/pull/36214
5354 [36264]: https://github.com/rust-lang/rust/pull/36264
5355 [36266]: https://github.com/rust-lang/rust/pull/36266
5356 [36289]: https://github.com/rust-lang/rust/pull/36289
5357 [36338]: https://github.com/rust-lang/rust/pull/36338
5358 [36351]: https://github.com/rust-lang/rust/pull/36351
5359 [36355]: https://github.com/rust-lang/rust/pull/36355
5360 [36369]: https://github.com/rust-lang/rust/pull/36369
5361 [36372]: https://github.com/rust-lang/rust/pull/36372
5362 [36423]: https://github.com/rust-lang/rust/pull/36423
5363 [36482]: https://github.com/rust-lang/rust/pull/36482
5364 [36505]: https://github.com/rust-lang/rust/pull/36505
5365 [36524]: https://github.com/rust-lang/rust/pull/36524
5366 [36527]: https://github.com/rust-lang/rust/pull/36527
5367 [36551]: https://github.com/rust-lang/rust/pull/36551
5368 [36574]: https://github.com/rust-lang/rust/pull/36574
5369 [36586]: https://github.com/rust-lang/rust/pull/36586
5370 [36592]: https://github.com/rust-lang/rust/pull/36592
5371 [36631]: https://github.com/rust-lang/rust/pull/36631
5372 [36639]: https://github.com/rust-lang/rust/pull/36639
5373 [36721]: https://github.com/rust-lang/rust/pull/36721
5374 [36727]: https://github.com/rust-lang/rust/pull/36727
5375 [36730]: https://github.com/rust-lang/rust/pull/36730
5376 [36734]: https://github.com/rust-lang/rust/pull/36734
5377 [36754]: https://github.com/rust-lang/rust/pull/36754
5378 [36995]: https://github.com/rust-lang/rust/pull/36995
5379 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5380 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5381 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5382 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5383 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5384 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5385 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5386 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5387 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5388 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5389 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5390 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5391 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5392 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5393 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5394 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5395 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5396 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5397 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5398 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5399 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5400 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5401 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5402 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5403 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5404 [rustup]: https://www.rustup.rs
5405 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5406 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5407 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5408 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5409 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5410 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5411 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5412
5413
5414 Version 1.12.1 (2016-10-20)
5415 ===========================
5416
5417 Regression Fixes
5418 ----------------
5419
5420 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5421 * [Confusion with double negation and booleans][36856]
5422 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5423 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5424 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5425 * [Corrupted memory after updated to 1.12][36936]
5426 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5427 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5428 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5429
5430 [36381]: https://github.com/rust-lang/rust/issues/36381
5431 [36856]: https://github.com/rust-lang/rust/issues/36856
5432 [36875]: https://github.com/rust-lang/rust/issues/36875
5433 [36924]: https://github.com/rust-lang/rust/issues/36924
5434 [36926]: https://github.com/rust-lang/rust/issues/36926
5435 [36936]: https://github.com/rust-lang/rust/issues/36936
5436 [37026]: https://github.com/rust-lang/rust/issues/37026
5437 [37112]: https://github.com/rust-lang/rust/issues/37112
5438 [37153]: https://github.com/rust-lang/rust/issues/37153
5439
5440
5441 Version 1.12.0 (2016-09-29)
5442 ===========================
5443
5444 Highlights
5445 ----------
5446
5447 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5448   This translation pass is far simpler than the previous AST->LLVM pass, and
5449   creates opportunities to perform new optimizations directly on the MIR. It
5450   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5451 * [`rustc` presents a new, more readable error format, along with
5452   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5453   Most common editors supporting Rust have been updated to work with it. It was
5454   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5455
5456 Compiler
5457 --------
5458
5459 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5460   This translation pass is far simpler than the previous AST->LLVM pass, and
5461   creates opportunities to perform new optimizations directly on the MIR. It
5462   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5463 * [Print the Rust target name, not the LLVM target name, with
5464   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5465 * [The computation of `TypeId` is correct in some cases where it was previously
5466   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5467 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5468 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5469   `--print relocation-models`, and `--print code-models` print the available
5470   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5471   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5472 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5473   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5474   These targets produce statically-linked binaries. There are no binary release
5475   builds yet though.
5476
5477 Diagnostics
5478 -----------
5479
5480 * [`rustc` presents a new, more readable error format, along with
5481   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5482   Most common editors supporting Rust have been updated to work with it. It was
5483   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5484 * [In error descriptions, references are now described in plain English,
5485   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5486 * [In error type descriptions, unknown numeric types are named `{integer}` or
5487   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5488 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5489
5490 Language
5491 --------
5492
5493 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5494 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5495 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5496   useful](https://github.com/rust-lang/rust/pull/34908)
5497 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5498   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5499 * [Semicolons are properly required as statement delimiters inside
5500   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5501 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5502
5503 Stabilized APIs
5504 ---------------
5505
5506 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5507 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5508 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5509 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5510 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5511 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5512 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5513 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5514 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5515 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5516   Both on Unix and Windows.
5517 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5518 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5519 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5520 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5521 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5522 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5523 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5524 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5525
5526 Libraries
5527 ---------
5528
5529 * [The `format!` macro and friends now allow a single argument to be formatted
5530   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5531 * [The lifetime bounds on `[T]::binary_search_by` and
5532   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5533 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5534 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5535 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5536 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5537 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5538 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5539 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5540 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5541   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5542 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5543   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5544 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5545 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5546   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5547 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5548 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5549 * [`mpsc::sync_channel` `Receiver`s return any available message before
5550   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5551 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5552 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5553
5554 Cargo
5555 -----
5556
5557 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5558 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5559 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5560 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5561 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5562 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5563 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5564 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5565 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5566 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5567 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5568 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5569 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5570 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5571 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5572 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5573
5574 Performance
5575 -----------
5576
5577 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5578 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5579
5580 Tooling
5581 -------
5582
5583 * [Test binaries now support a `--test-threads` argument to specify the number
5584   of threads used to run tests, and which acts the same as the
5585   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5586 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5587 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5588 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5589 * [Rust releases now come with source packages that can be installed by rustup
5590   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5591   The resulting source code can be used by tools and IDES, located in the
5592   sysroot under `lib/rustlib/src`.
5593
5594 Misc
5595 ----
5596
5597 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5598 * Many minor improvements to the documentation.
5599 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5600
5601 Compatibility Notes
5602 -------------------
5603
5604 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5605   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5606 * [When formatting strings, if "precision" is specified, the "fill",
5607   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5608 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5609
5610
5611 Version 1.11.0 (2016-08-18)
5612 ===========================
5613
5614 Language
5615 --------
5616
5617 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5618 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5619 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5620 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5621
5622 Stabilized APIs
5623 ---------------
5624
5625 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5626 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5627 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5628 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5629 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5630 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5631   (in libcore - previously stabilized in libstd)
5632 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5633   (in libcore - previously stabilized in libstd)
5634 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5635   (in libcore - previously stabilized in libstd)
5636 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5637   (in libcore - previously stabilized in libstd)
5638 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5639 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5640 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5641 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5642
5643 Libraries
5644 ---------
5645
5646 * [The `thread_local!` macro supports multiple definitions in a single
5647    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5648 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5649 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5650   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5651 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5652 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5653 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5654 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5655
5656 Cargo
5657 -----
5658
5659 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5660 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5661 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5662 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5663 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5664   and `-vv` prints warnings for all crates.
5665 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5666 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5667   This provides room for expansion by arbitrary tools.
5668 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5669 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5670 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5671 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5672 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5673 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5674 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5675
5676 Performance
5677 -----------
5678
5679 * [Caching projections speeds up type check dramatically for some
5680   workloads](https://github.com/rust-lang/rust/pull/33816)
5681 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5682   This hasher is faster, but is believed to provide sufficient
5683   protection from collision attacks.
5684 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5685
5686 Rustdoc
5687 -------
5688
5689 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5690 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5691 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5692 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5693 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5694
5695 Tooling
5696 -------
5697
5698 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5699 * [When emitting debug info, rustc emits frame pointers for closures,
5700   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5701 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5702 * Many more errors have been given error codes and extended
5703   explanations
5704 * API documentation continues to be improved, with many new examples
5705
5706 Misc
5707 ----
5708
5709 * [rustc no longer hangs when dependencies recursively re-export
5710   submodules](https://github.com/rust-lang/rust/pull/34542)
5711 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5712 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5713   rewritten](https://github.com/rust-lang/rust/pull/33895)
5714 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5715   No targets use this yet, but it works toward AVR support.
5716
5717 Compatibility Notes
5718 -------------------
5719
5720 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5721 * [The new follow-set rules that place restrictions on `macro_rules!`
5722   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5723   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5724   and has been a warning since 1.10.
5725 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5726   This causes breakage in some corner cases.
5727
5728
5729 Version 1.10.0 (2016-07-07)
5730 ===========================
5731
5732 Language
5733 --------
5734
5735 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5736   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5737 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5738 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5739 * [`panic!` can be converted to a runtime abort with the
5740   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5741   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5742 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5743   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5744   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5745   Note that Cargo does not yet directly support cdylibs.
5746
5747 Stabilized APIs
5748 ---------------
5749
5750 * `os::windows::fs::OpenOptionsExt::access_mode`
5751 * `os::windows::fs::OpenOptionsExt::share_mode`
5752 * `os::windows::fs::OpenOptionsExt::custom_flags`
5753 * `os::windows::fs::OpenOptionsExt::attributes`
5754 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5755 * `os::unix::fs::OpenOptionsExt::custom_flags`
5756 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5757 * `Default for sync::Weak`
5758 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5759 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5760 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5761 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5762 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5763 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5764 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5765 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5766 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5767 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5768 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5769 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5770 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5771 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5772 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5773 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5774 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5775 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5776 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5777 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5778 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5779 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5780 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5781 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5782 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5783 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5784 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5785 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5786 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5787 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5788 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5789 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5790 * Read/Write/RawFd impls for `UnixStream`
5791 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5792 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5793 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5794 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5795 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5796 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5797 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5798 * RawFd impls for `UnixListener`
5799 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5800 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5801 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5802 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5803 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5804 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5805 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5806 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5807 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5808 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5809 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5810 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5811 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5812 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5813 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5814 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5815 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5816 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5817 * RawFd impls for `UnixDatagram`
5818 * `{BTree,Hash}Map::values_mut`
5819 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5820
5821 Libraries
5822 ---------
5823
5824 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5825   The semantics of this minor method are subtle and probably not what
5826   most people want.
5827 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5828 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5829   will fall back to `/dev/urandom` temporarily to avoid blocking
5830   during early boot](https://github.com/rust-lang/rust/pull/33086).
5831 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5832 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5833 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5834 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5835 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5836 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5837   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5838
5839 Cargo
5840 -----
5841 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5842   This controls the runtime behavior of the `panic!` macro
5843   and can be either "unwind" (the default), or "abort".
5844   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5845 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5846 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5847 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5848   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5849 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5850 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5851 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5852   By default they are retried twice, which can be customized with the
5853   `net.retry` value in `.cargo/config`.
5854 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5855 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5856 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5857 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5858   Makes it possible to install multiple crates in parallel.
5859 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5860 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5861 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5862 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5863 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5864 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5865
5866 Performance
5867 -----------
5868
5869 * [rustc memory usage was reduced by refactoring the context used for
5870   type checking](https://github.com/rust-lang/rust/pull/33425).
5871 * [Speed up creation of `HashMap`s by caching the random keys used
5872   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5873 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5874 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5875 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5876   10x faster than the previous lookup tables.
5877 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5878
5879 Usability
5880 ---------
5881
5882 * Many incremental improvements to documentation and rustdoc.
5883 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5884 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5885 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5886 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5887 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5888 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5889 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5890
5891 Misc
5892 ----
5893
5894 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5895 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5896 * [`std` no longer prints backtraces on platforms where the running
5897   module must be loaded with `env::current_exe`, which can't be relied
5898   on](https://github.com/rust-lang/rust/pull/33554).
5899 * This release includes std binaries for the i586-unknown-linux-gnu,
5900   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5901   i586 target is for old x86 hardware without SSE2, and the armv7
5902   target is for Android running on modern ARM architectures.
5903 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5904   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5905 * [On Unix the runtime aborts by calling `libc::abort` instead of
5906   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5907 * [Rust is now bootstrapped from the previous release of Rust,
5908   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5909
5910 Compatibility Notes
5911 -------------------
5912
5913 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5914 * [`target_env` for Linux ARM targets is just `gnu`, not
5915   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5916 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5917 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5918 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5919   Affects how macros are parsed.
5920 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5921 * [Feature-gated attributes on macro-generated macro invocations are
5922   now rejected](https://github.com/rust-lang/rust/pull/32791).
5923 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5924   This caused some minor changes to type inference.
5925
5926
5927 Version 1.9.0 (2016-05-26)
5928 ==========================
5929
5930 Language
5931 --------
5932
5933 * The `#[deprecated]` attribute when applied to an API will generate
5934   warnings when used. The warnings may be suppressed with
5935   `#[allow(deprecated)]`. [RFC 1270].
5936 * [`fn` item types are zero sized, and each `fn` names a unique
5937   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5938   `transmute` on a `fn` type will generate a warning for a few cycles,
5939   then will be converted to an error.
5940 * [Field and method resolution understand visibility, so private
5941   fields and methods cannot prevent the proper use of public fields
5942   and methods][1.9fv].
5943 * [The parser considers unicode codepoints in the
5944   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5945
5946 Stabilized APIs
5947 ---------------
5948
5949 * [`std::panic`]
5950 * [`std::panic::catch_unwind`] (renamed from `recover`)
5951 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5952 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5953 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5954 * [`str::is_char_boundary`]
5955 * [`<*const T>::as_ref`]
5956 * [`<*mut T>::as_ref`]
5957 * [`<*mut T>::as_mut`]
5958 * [`AsciiExt::make_ascii_uppercase`]
5959 * [`AsciiExt::make_ascii_lowercase`]
5960 * [`char::decode_utf16`]
5961 * [`char::DecodeUtf16`]
5962 * [`char::DecodeUtf16Error`]
5963 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5964 * [`BTreeSet::take`]
5965 * [`BTreeSet::replace`]
5966 * [`BTreeSet::get`]
5967 * [`HashSet::take`]
5968 * [`HashSet::replace`]
5969 * [`HashSet::get`]
5970 * [`OsString::with_capacity`]
5971 * [`OsString::clear`]
5972 * [`OsString::capacity`]
5973 * [`OsString::reserve`]
5974 * [`OsString::reserve_exact`]
5975 * [`OsStr::is_empty`]
5976 * [`OsStr::len`]
5977 * [`std::os::unix::thread`]
5978 * [`RawPthread`]
5979 * [`JoinHandleExt`]
5980 * [`JoinHandleExt::as_pthread_t`]
5981 * [`JoinHandleExt::into_pthread_t`]
5982 * [`HashSet::hasher`]
5983 * [`HashMap::hasher`]
5984 * [`CommandExt::exec`]
5985 * [`File::try_clone`]
5986 * [`SocketAddr::set_ip`]
5987 * [`SocketAddr::set_port`]
5988 * [`SocketAddrV4::set_ip`]
5989 * [`SocketAddrV4::set_port`]
5990 * [`SocketAddrV6::set_ip`]
5991 * [`SocketAddrV6::set_port`]
5992 * [`SocketAddrV6::set_flowinfo`]
5993 * [`SocketAddrV6::set_scope_id`]
5994 * [`slice::copy_from_slice`]
5995 * [`ptr::read_volatile`]
5996 * [`ptr::write_volatile`]
5997 * [`OpenOptions::create_new`]
5998 * [`TcpStream::set_nodelay`]
5999 * [`TcpStream::nodelay`]
6000 * [`TcpStream::set_ttl`]
6001 * [`TcpStream::ttl`]
6002 * [`TcpStream::set_only_v6`]
6003 * [`TcpStream::only_v6`]
6004 * [`TcpStream::take_error`]
6005 * [`TcpStream::set_nonblocking`]
6006 * [`TcpListener::set_ttl`]
6007 * [`TcpListener::ttl`]
6008 * [`TcpListener::set_only_v6`]
6009 * [`TcpListener::only_v6`]
6010 * [`TcpListener::take_error`]
6011 * [`TcpListener::set_nonblocking`]
6012 * [`UdpSocket::set_broadcast`]
6013 * [`UdpSocket::broadcast`]
6014 * [`UdpSocket::set_multicast_loop_v4`]
6015 * [`UdpSocket::multicast_loop_v4`]
6016 * [`UdpSocket::set_multicast_ttl_v4`]
6017 * [`UdpSocket::multicast_ttl_v4`]
6018 * [`UdpSocket::set_multicast_loop_v6`]
6019 * [`UdpSocket::multicast_loop_v6`]
6020 * [`UdpSocket::set_multicast_ttl_v6`]
6021 * [`UdpSocket::multicast_ttl_v6`]
6022 * [`UdpSocket::set_ttl`]
6023 * [`UdpSocket::ttl`]
6024 * [`UdpSocket::set_only_v6`]
6025 * [`UdpSocket::only_v6`]
6026 * [`UdpSocket::join_multicast_v4`]
6027 * [`UdpSocket::join_multicast_v6`]
6028 * [`UdpSocket::leave_multicast_v4`]
6029 * [`UdpSocket::leave_multicast_v6`]
6030 * [`UdpSocket::take_error`]
6031 * [`UdpSocket::connect`]
6032 * [`UdpSocket::send`]
6033 * [`UdpSocket::recv`]
6034 * [`UdpSocket::set_nonblocking`]
6035
6036 Libraries
6037 ---------
6038
6039 * [`std::sync::Once` is poisoned if its initialization function
6040   fails][1.9o].
6041 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
6042 * [Most types implement `fmt::Debug`][1.9db].
6043 * [The default buffer size used by `BufReader` and `BufWriter` was
6044   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
6045   used by other languages.
6046 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
6047   `Duration` additionally implements `*=` and `/=`][1.9ta].
6048 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
6049 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
6050 * [`Chain` implements `BufRead`][1.9ch].
6051 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
6052
6053 Cargo
6054 -----
6055
6056 * [Cargo can now run concurrently][1.9cc].
6057 * [Top-level overrides allow specific revisions of crates to be
6058   overridden through the entire crate graph][1.9ct].  This is intended
6059   to make upgrades easier for large projects, by allowing crates to be
6060   forked temporarily until they've been upgraded and republished.
6061 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
6062 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
6063   on the commandline][1.9cf]. `rustc` arguments can also be specified
6064   in the `build.rustflags` configuration key.
6065
6066 Performance
6067 -----------
6068
6069 * [The time complexity of comparing variables for equivalence during type
6070   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
6071   to major compilation time improvement in some scenarios.
6072 * [`ToString` is specialized for `str`, giving it the same performance
6073   as `to_owned`][1.9ts].
6074 * [Spawning processes with `Command::output` no longer creates extra
6075   threads][1.9sp].
6076 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
6077   for C-like enums][1.9cl].
6078
6079 Misc
6080 ----
6081
6082 * [Passing the `--quiet` flag to a test runner will produce
6083   much-abbreviated output][1.9q].
6084 * The Rust Project now publishes std binaries for the
6085   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
6086   `i586-pc-windows-msvc` targets.
6087
6088 Compatibility Notes
6089 -------------------
6090
6091 * [`std::sync::Once` is poisoned if its initialization function
6092   fails][1.9o].
6093 * [It is illegal to define methods with the same name in overlapping
6094   inherent `impl` blocks][1.9sn].
6095 * [`fn` item types are zero sized, and each `fn` names a unique
6096   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6097   `transmute` on a `fn` type will generate a warning for a few cycles,
6098   then will be converted to an error.
6099 * [Improvements to const evaluation may trigger new errors when integer
6100   literals are out of range][1.9ce].
6101
6102
6103 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
6104 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
6105 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
6106 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
6107 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
6108 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
6109 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
6110 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
6111 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
6112 [1.9db]: https://github.com/rust-lang/rust/pull/32054
6113 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
6114 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
6115 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
6116 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
6117 [1.9o]: https://github.com/rust-lang/rust/pull/32325
6118 [1.9q]: https://github.com/rust-lang/rust/pull/31887
6119 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
6120 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
6121 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
6122 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
6123 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
6124 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
6125 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
6126 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
6127 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6128 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
6129 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
6130 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
6131 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
6132 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
6133 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
6134 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
6135 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
6136 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
6137 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
6138 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
6139 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
6140 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
6141 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
6142 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
6143 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
6144 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
6145 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
6146 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
6147 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
6148 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
6149 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
6150 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
6151 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
6152 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
6153 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
6154 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
6155 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
6156 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
6157 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
6158 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
6159 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
6160 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
6161 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
6162 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
6163 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6164 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6165 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6166 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6167 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6168 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6169 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
6170 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
6171 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
6172 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
6173 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
6174 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
6175 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
6176 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
6177 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
6178 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
6179 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
6180 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
6181 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
6182 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
6183 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
6184 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
6185 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
6186 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
6187 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
6188 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
6189 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
6190 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
6191 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
6192 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
6193 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
6194 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
6195 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
6196 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
6197 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
6198 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
6199 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
6200 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
6201 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
6202 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
6203 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
6204 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
6205 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
6206 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
6207 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
6208 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
6209 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
6210 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
6211 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
6212 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
6213
6214
6215 Version 1.8.0 (2016-04-14)
6216 ==========================
6217
6218 Language
6219 --------
6220
6221 * Rust supports overloading of compound assignment statements like
6222   `+=` by implementing the [`AddAssign`], [`SubAssign`],
6223   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
6224   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
6225   traits. [RFC 953].
6226 * Empty structs can be defined with braces, as in `struct Foo { }`, in
6227   addition to the non-braced form, `struct Foo;`. [RFC 218].
6228
6229 Libraries
6230 ---------
6231
6232 * Stabilized APIs:
6233   * [`str::encode_utf16`] (renamed from `utf16_units`)
6234   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
6235   * [`Ref::map`]
6236   * [`RefMut::map`]
6237   * [`ptr::drop_in_place`]
6238   * [`time::Instant`]
6239   * [`time::SystemTime`]
6240   * [`Instant::now`]
6241   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
6242   * [`Instant::elapsed`]
6243   * [`SystemTime::now`]
6244   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
6245   * [`SystemTime::elapsed`]
6246   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
6247   * [`SystemTimeError`]
6248   * [`SystemTimeError::duration`]
6249   * Various impls for `SystemTimeError`
6250   * [`UNIX_EPOCH`]
6251   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
6252     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
6253     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
6254 * [The `write!` and `writeln!` macros correctly emit errors if any of
6255   their arguments can't be formatted][1.8w].
6256 * [Various I/O functions support large files on 32-bit Linux][1.8l].
6257 * [The Unix-specific `raw` modules, which contain a number of
6258   redefined C types are deprecated][1.8r], including `os::raw::unix`,
6259   `os::raw::macos`, and `os::raw::linux`. These modules defined types
6260   such as `ino_t` and `dev_t`. The inconsistency of these definitions
6261   across platforms was making it difficult to implement `std`
6262   correctly. Those that need these definitions should use the `libc`
6263   crate. [RFC 1415].
6264 * The Unix-specific `MetadataExt` traits, including
6265   `os::unix::fs::MetadataExt`, which expose values such as inode
6266   numbers [no longer return platform-specific types][1.8r], but
6267   instead return widened integers. [RFC 1415].
6268 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
6269 * [Atomic loads and stores are not volatile][1.8a].
6270 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
6271
6272 Performance
6273 -----------
6274
6275 * [Inlining hash functions lead to a 3% compile-time improvement in
6276   some workloads][1.8h].
6277 * When using jemalloc, its symbols are [unprefixed so that it
6278   overrides the libc malloc implementation][1.8h]. This means that for
6279   rustc, LLVM is now using jemalloc, which results in a 6%
6280   compile-time improvement on a specific workload.
6281 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6282
6283 Misc
6284 ----
6285
6286 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6287   i686-pc-windows-msvc is now considered a tier-1 platform.
6288 * [The `--print targets` flag prints a list of supported targets][1.8t].
6289 * [The `--print cfg` flag prints the `cfg`s defined for the current
6290   target][1.8cf].
6291 * [`rustc` can be built with an new Cargo-based build system, written
6292   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6293   build system. To enable it configure with `configure --rustbuild`.
6294 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6295   variants while also indicating the total number of missing variants
6296   if more than 3][1.8m].
6297 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6298 * The Rust Project now publishes binary releases of the standard
6299   library for a number of tier-2 targets:
6300   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6301   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6302   `x86_64-rumprun-netbsd`. These can be installed with
6303   tools such as [multirust][1.8mr].
6304
6305 Cargo
6306 -----
6307
6308 * [`cargo init` creates a new Cargo project in the current
6309   directory][1.8ci].  It is otherwise like `cargo new`.
6310 * [Cargo has configuration keys for `-v` and
6311   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6312   `[term]` section of `.cargo/config`.
6313 * [Configuration keys that evaluate to strings or integers can be set
6314   via environment variables][1.8ce]. For example the `build.jobs` key
6315   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6316   precedence over config files.
6317 * [Target-specific dependencies support Rust `cfg` syntax for
6318   describing targets][1.8cfg] so that dependencies for multiple
6319   targets can be specified together. [RFC 1361].
6320 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6321   `RUSTDOC` take precedence over the `build.target-dir`,
6322   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6323 * [The child process tree is killed on Windows when Cargo is
6324   killed][1.8ck].
6325 * [The `build.target` configuration value sets the target platform,
6326   like `--target`][1.8ct].
6327
6328 Compatibility Notes
6329 -------------------
6330
6331 * [Unstable compiler flags have been further restricted][1.8u]. Since
6332   1.0 `-Z` flags have been considered unstable, and other flags that
6333   were considered unstable additionally required passing `-Z
6334   unstable-options` to access. Unlike unstable language and library
6335   features though, these options have been accessible on the stable
6336   release channel. Going forward, *new unstable flags will not be
6337   available on the stable release channel*, and old unstable flags
6338   will warn about their usage. In the future, all unstable flags will
6339   be unavailable on the stable release channel.
6340 * [It is no longer possible to `match` on empty enum variants using
6341   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6342 * The Unix-specific `MetadataExt` traits, including
6343   `os::unix::fs::MetadataExt`, which expose values such as inode
6344   numbers [no longer return platform-specific types][1.8r], but
6345   instead return widened integers. [RFC 1415].
6346 * [Modules sourced from the filesystem cannot appear within arbitrary
6347   blocks, but only within other modules][1.8mf].
6348 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6349 * On Unix, [stack overflow triggers a runtime abort instead of a
6350   SIGSEGV][1.8so].
6351 * [`Command::spawn` and its equivalents return an error if any of
6352   its command-line arguments contain interior `NUL`s][1.8n].
6353 * [Tuple and unit enum variants from other crates are in the type
6354   namespace][1.8tn].
6355 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6356   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6357   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6358   instead of `foo.lib`.
6359
6360
6361 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6362 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6363 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6364 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6365 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6366 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6367 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6368 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6369 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6370 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6371 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6372 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6373 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6374 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6375 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6376 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6377 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6378 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6379 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6380 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6381 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6382 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6383 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6384 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6385 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6386 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6387 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6388 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6389 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6390 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6391 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6392 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6393 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6394 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6395 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6396 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6397 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6398 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6399 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6400 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6401 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6402 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6403 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6404 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6405 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6406 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6407 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6408 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6409 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6410 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6411 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6412 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6413 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6414 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6415 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6416 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6417 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6418 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6419 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6420 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6421
6422
6423 Version 1.7.0 (2016-03-03)
6424 ==========================
6425
6426 Libraries
6427 ---------
6428
6429 * Stabilized APIs
6430   * `Path`
6431     * [`Path::strip_prefix`] (renamed from relative_from)
6432     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6433   * `Ipv4Addr`
6434     * [`Ipv4Addr::is_loopback`]
6435     * [`Ipv4Addr::is_private`]
6436     * [`Ipv4Addr::is_link_local`]
6437     * [`Ipv4Addr::is_multicast`]
6438     * [`Ipv4Addr::is_broadcast`]
6439     * [`Ipv4Addr::is_documentation`]
6440   * `Ipv6Addr`
6441     * [`Ipv6Addr::is_unspecified`]
6442     * [`Ipv6Addr::is_loopback`]
6443     * [`Ipv6Addr::is_multicast`]
6444   * `Vec`
6445     * [`Vec::as_slice`]
6446     * [`Vec::as_mut_slice`]
6447   * `String`
6448     * [`String::as_str`]
6449     * [`String::as_mut_str`]
6450   * Slices
6451     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6452     be the same length
6453     * `<[T]>::`[`sort_by_key`]
6454   * checked, saturated, and overflowing operations
6455     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6456     * [`i32::saturating_mul`]
6457     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6458     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6459     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6460     * [`u32::saturating_mul`]
6461     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6462     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6463     * and checked, saturated, and overflowing operations for other primitive types
6464   * FFI
6465     * [`ffi::IntoStringError`]
6466     * [`CString::into_string`]
6467     * [`CString::into_bytes`]
6468     * [`CString::into_bytes_with_nul`]
6469     * `From<CString> for Vec<u8>`
6470   * `IntoStringError`
6471     * [`IntoStringError::into_cstring`]
6472     * [`IntoStringError::utf8_error`]
6473     * `Error for IntoStringError`
6474   * Hashing
6475     * [`std::hash::BuildHasher`]
6476     * [`BuildHasher::Hasher`]
6477     * [`BuildHasher::build_hasher`]
6478     * [`std::hash::BuildHasherDefault`]
6479     * [`HashMap::with_hasher`]
6480     * [`HashMap::with_capacity_and_hasher`]
6481     * [`HashSet::with_hasher`]
6482     * [`HashSet::with_capacity_and_hasher`]
6483     * [`std::collections::hash_map::RandomState`]
6484     * [`RandomState::new`]
6485 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6486   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6487   from bytes is faster.
6488 * [The performance of `LineWriter` (and thus `io::stdout`) was
6489   improved by using `memchr` to search for newlines][1.7m].
6490 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6491   `f64` variants were stabilized previously.
6492 * [`BTreeMap` was rewritten to use less memory and improve the performance
6493   of insertion and iteration, the latter by as much as 5x][1.7bm].
6494 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6495   covariant over their contained type][1.7bt].
6496 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6497   over their contained type][1.7ll].
6498 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6499   searching methods.
6500 * [`Any` is implemented for unsized types][1.7a].
6501 * [`Hash` is implemented for `Duration`][1.7h].
6502
6503 Misc
6504 ----
6505
6506 * [When running tests with `--test`, rustdoc will pass `--cfg`
6507   arguments to the compiler][1.7dt].
6508 * [The compiler is built with RPATH information by default][1.7rpa].
6509   This means that it will be possible to run `rustc` when installed in
6510   unusual configurations without configuring the dynamic linker search
6511   path explicitly.
6512 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6513   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6514   over `LD_LIBRARY_PATH`.
6515
6516 Cargo
6517 -----
6518
6519 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6520   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6521 * [The `rerun-if-changed` build script directive no longer causes the
6522   build script to incorrectly run twice in certain scenarios][1.7rr].
6523
6524 Compatibility Notes
6525 -------------------
6526
6527 * Soundness fixes to the interactions between associated types and
6528   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6529   code that violates the new rules. This is a significant change that
6530   is known to break existing code, so it has emitted warnings for the
6531   new error cases since 1.4 to give crate authors time to adapt. The
6532   details of what is changing are subtle; read the RFC for more.
6533 * [Several bugs in the compiler's visibility calculations were
6534   fixed][1.7v]. Since this was found to break significant amounts of
6535   code, the new errors will be emitted as warnings for several release
6536   cycles, under the `private_in_public` lint.
6537 * Defaulted type parameters were accidentally accepted in positions
6538   that were not intended. In this release, [defaulted type parameters
6539   appearing outside of type definitions will generate a
6540   warning][1.7d], which will become an error in future releases.
6541 * [Parsing "." as a float results in an error instead of 0][1.7p].
6542   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6543 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6544
6545 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6546 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6547 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6548 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6549 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6550 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6551 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6552 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6553 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6554 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6555 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6556 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6557 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6558 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6559 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6560 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6561 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6562 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6563 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6564 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6565 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6566 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6567 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6568 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6569 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6570 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6571 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6572 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6573 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6574 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6575 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6576 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6577 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6578 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6579 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6580 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6581 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6582 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6583 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6584 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6585 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6586 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6587 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6588 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6589 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6590 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6591 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6592 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6593 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6594 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6595 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6596 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6597 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6598 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6599 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6600 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6601 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6602 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6603 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6604 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6605 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6606 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6607 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6608 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6609 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6610 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6611 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6612 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6613 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6614 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6615 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6616 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6617 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6618 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6619 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6620 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6621 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6622 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6623 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6624
6625
6626 Version 1.6.0 (2016-01-21)
6627 ==========================
6628
6629 Language
6630 --------
6631
6632 * The `#![no_std]` attribute causes a crate to not be linked to the
6633   standard library, but only the [core library][1.6co], as described
6634   in [RFC 1184]. The core library defines common types and traits but
6635   has no platform dependencies whatsoever, and is the basis for Rust
6636   software in environments that cannot support a full port of the
6637   standard library, such as operating systems. Most of the core
6638   library is now stable.
6639
6640 Libraries
6641 ---------
6642
6643 * Stabilized APIs:
6644   [`Read::read_exact`],
6645   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6646   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6647   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6648   [`os::unix::fs::DirBuilderExt`],
6649   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6650   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6651   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6652   [`collections::hash_map::Drain`],
6653   [`collections::hash_map::HashMap::drain`],
6654   [`collections::hash_set::Drain`],
6655   [`collections::hash_set::HashSet::drain`],
6656   [`collections::binary_heap::Drain`],
6657   [`collections::binary_heap::BinaryHeap::drain`],
6658   [`Vec::extend_from_slice`] (renamed from `push_all`),
6659   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6660   [`RwLock::into_inner`],
6661   [`Iterator::min_by_key`] (renamed from `min_by`),
6662   [`Iterator::max_by_key`] (renamed from `max_by`).
6663 * The [core library][1.6co] is stable, as are most of its APIs.
6664 * [The `assert_eq!` macro supports arguments that don't implement
6665   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6666   `assert!`.
6667 * Several timer functions that take duration in milliseconds [are
6668   deprecated in favor of those that take `Duration`][1.6ms]. These
6669   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6670   `thread::park_timeout_ms`.
6671 * The algorithm by which `Vec` reserves additional elements was
6672   [tweaked to not allocate excessive space][1.6a] while still growing
6673   exponentially.
6674 * `From` conversions are [implemented from integers to floats][1.6f]
6675   in cases where the conversion is lossless. Thus they are not
6676   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6677   or `f64`. They are also not implemented for `isize` and `usize`
6678   because the implementations would be platform-specific. `From` is
6679   also implemented from `f32` to `f64`.
6680 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6681 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6682 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6683 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6684   improvements.
6685 * Sorting slices that are already sorted [is 50% faster in some
6686   cases][1.6s].
6687
6688 Cargo
6689 -----
6690
6691 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6692 * Cargo build scripts can specify their dependencies by emitting the
6693   [`rerun-if-changed`][1.6rr] key.
6694 * crates.io will reject publication of crates with dependencies that
6695   have a wildcard version constraint. Crates with wildcard
6696   dependencies were seen to cause a variety of problems, as described
6697   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6698   warning.
6699 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6700   release folder.  A variety of artifacts that Cargo failed to clean
6701   are now correctly deleted.
6702
6703 Misc
6704 ----
6705
6706 * The `unreachable_code` lint [warns when a function call's argument
6707   diverges][1.6dv].
6708 * The parser indicates [failures that may be caused by
6709   confusingly-similar Unicode characters][1.6uc]
6710 * Certain macro errors [are reported at definition time][1.6m], not
6711   expansion.
6712
6713 Compatibility Notes
6714 -------------------
6715
6716 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6717   environment variable when locating crates. This was a pre-cargo
6718   feature for integrating with the package manager that was
6719   accidentally never removed.
6720 * [A number of bugs were fixed in the privacy checker][1.6p] that
6721   could cause previously-accepted code to break.
6722 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6723 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6724   struct pattern syntax (`Foo(..)`) can no longer be used to match
6725   unit structs. This is a warning now, but will become an error in
6726   future releases. Patterns that share the same name as a const are
6727   now an error.
6728 * A bug was fixed that causes [rustc not to apply default type
6729   parameters][1.6xc] when resolving certain method implementations of
6730   traits defined in other crates.
6731
6732 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6733 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6734 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6735 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6736 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6737 [1.6co]: http://doc.rust-lang.org/core/index.html
6738 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6739 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6740 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6741 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6742 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6743 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6744 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6745 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6746 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6747 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6748 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6749 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6750 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6751 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6752 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6753 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6754 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6755 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6756 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6757 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6758 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6759 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6760 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6761 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6762 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6763 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6764 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6765 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6766 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6767 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6768 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6769 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6770 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6771 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6772 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6773 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6774 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6775 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6776 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6777 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6778 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6779
6780
6781 Version 1.5.0 (2015-12-10)
6782 ==========================
6783
6784 * ~700 changes, numerous bugfixes
6785
6786 Highlights
6787 ----------
6788
6789 * Stabilized APIs:
6790   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6791   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6792   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6793   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6794   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6795   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6796   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6797   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6798   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6799   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6800   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6801   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6802   [`Path::read_link`], [`Path::symlink_metadata`],
6803   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6804   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6805   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6806   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6807   [`slice::split_first_mut`], [`slice::split_first`],
6808   [`slice::split_last_mut`], [`slice::split_last`],
6809   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6810   [`str::MatchIndices`], [`str::RMatchIndices`],
6811   [`str::match_indices`], [`str::rmatch_indices`],
6812   [`str::slice_mut_unchecked`], [`string::ParseError`].
6813 * Rust applications hosted on crates.io can be installed locally to
6814   `~/.cargo/bin` with the [`cargo install`] command. Among other
6815   things this makes it easier to augment Cargo with new subcommands:
6816   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6817   invoked as `cargo foo`.
6818 * Crates with wildcard (`*`) dependencies will [emit warnings when
6819   published][1.5w]. In 1.6 it will no longer be possible to publish
6820   crates with wildcard dependencies.
6821
6822 Breaking Changes
6823 ----------------
6824
6825 * The rules determining when a particular lifetime must outlive
6826   a particular value (known as '[dropck]') have been [modified
6827   to not rely on parametricity][1.5p].
6828 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6829   and `Arc`][1.5a]. Because these smart pointer types implement
6830   `Deref`, this causes breakage in cases where the interior type
6831   contains methods of the same name.
6832 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6833   that they could drop their content. Soundness fix.
6834 * All method invocations are [properly checked][1.5wf1] for
6835   [well-formedness][1.5wf2]. Soundness fix.
6836 * Traits whose supertraits contain `Self` are [not object
6837   safe][1.5o]. Soundness fix.
6838 * Target specifications support a [`no_default_libraries`][1.5nd]
6839   setting that controls whether `-nodefaultlibs` is passed to the
6840   linker, and in turn the `is_like_windows` setting no longer affects
6841   the `-nodefaultlibs` flag.
6842 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6843 * The `#[inline]` and `#[repr]` attributes [can only appear
6844   in valid locations][1.5at].
6845 * Native libraries linked from the local crate are [passed to
6846   the linker before native libraries from upstream crates][1.5nl].
6847 * Two rarely-used attributes, `#[no_debug]` and
6848   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6849 * Negation of unsigned integers, which has been a warning for
6850   several releases, [is now behind a feature gate and will
6851   generate errors][1.5nu].
6852 * The parser accidentally accepted visibility modifiers on
6853   enum variants, a bug [which has been fixed][1.5ev].
6854 * [A bug was fixed that allowed `use` statements to import unstable
6855   features][1.5use].
6856
6857 Language
6858 --------
6859
6860 * When evaluating expressions at compile-time that are not
6861   compile-time constants (const-evaluating expressions in non-const
6862   contexts), incorrect code such as overlong bitshifts and arithmetic
6863   overflow will [generate a warning instead of an error][1.5ce],
6864   delaying the error until runtime. This will allow the
6865   const-evaluator to be expanded in the future backwards-compatibly.
6866 * The `improper_ctypes` lint [no longer warns about using `isize` and
6867   `usize` in FFI][1.5ict].
6868
6869 Libraries
6870 ---------
6871
6872 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6873   invariant][1.5c].
6874 * `Default` is [implemented for mutable slices][1.5d].
6875 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6876 * There are now `From` conversions [between floating point
6877   types][1.5f] where the conversions are lossless.
6878 * There are now `From` conversions [between integer types][1.5i] where
6879   the conversions are lossless.
6880 * [`fs::Metadata` implements `Clone`][1.5fs].
6881 * The `parse` method [accepts a leading "+" when parsing
6882   integers][1.5pi].
6883 * [`AsMut` is implemented for `Vec`][1.5am].
6884 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6885   been optimized][1.5cf] and no longer rely on the default impl.
6886 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6887   `unsafe extern "C"` function types now [implement `Clone`,
6888   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6889   `fmt::Debug` for up to 12 arguments][1.5fp].
6890 * [Dropping `Vec`s is much faster in unoptimized builds when the
6891   element types don't implement `Drop`][1.5dv].
6892 * A bug that caused in incorrect behavior when [combining `VecDeque`
6893   with zero-sized types][1.5vdz] was resolved.
6894 * [`PartialOrd` for slices is faster][1.5po].
6895
6896 Miscellaneous
6897 -------------
6898
6899 * [Crate metadata size was reduced by 20%][1.5md].
6900 * [Improvements to code generation reduced the size of libcore by 3.3
6901   MB and rustc's memory usage by 18MB][1.5m].
6902 * [Improvements to deref translation increased performance in
6903   unoptimized builds][1.5dr].
6904 * Various errors in trait resolution [are deduplicated to only be
6905   reported once][1.5te].
6906 * Rust has preliminary [support for rumprun kernels][1.5rr].
6907 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6908
6909 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6910 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6911 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6912 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6913 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6914 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6915 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6916 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6917 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6918 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6919 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6920 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6921 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6922 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6923 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6924 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6925 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6926 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6927 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6928 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6929 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6930 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6931 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6932 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6933 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6934 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6935 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6936 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6937 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6938 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6939 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6940 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6941 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6942 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6943 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6944 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6945 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6946 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6947 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6948 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6949 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6950 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6951 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6952 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6953 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6954 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6955 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6956 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6957 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6958 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6959 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6960 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6961 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6962 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6963 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6964 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6965 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6966 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6967 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6968 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6969 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6970 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6971 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6972 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6973 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6974 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6975 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6976 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6977 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6978 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6979 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6980 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6981 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6982 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6983 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6984 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6985 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6986 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6987 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6988 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6989 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6990 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6991 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6992 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6993 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6994 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6995 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6996 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6997 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6998
6999 Version 1.4.0 (2015-10-29)
7000 ==========================
7001
7002 * ~1200 changes, numerous bugfixes
7003
7004 Highlights
7005 ----------
7006
7007 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7008   GNU) are now supported and recommended for use.
7009
7010 Breaking Changes
7011 ----------------
7012
7013 * [Several changes have been made to fix type soundness and improve
7014   the behavior of associated types][sound]. See [RFC 1214]. Although
7015   we have mostly introduced these changes as warnings this release, to
7016   become errors next release, there are still some scenarios that will
7017   see immediate breakage.
7018 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7019   line breaks in addition to `\n`][crlf].
7020 * [Loans of `'static` lifetime extend to the end of a function][stat].
7021 * [`str::parse` no longer introduces avoidable rounding error when
7022   parsing floating point numbers. Together with earlier changes to
7023   float formatting/output, "round trips" like f.to_string().parse()
7024   now preserve the value of f exactly. Additionally, leading plus
7025   signs are now accepted][fp3].
7026
7027
7028 Language
7029 --------
7030
7031 * `use` statements that import multiple items [can now rename
7032   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
7033 * [Binops work correctly on fat pointers][binfat].
7034 * `pub extern crate`, which does not behave as expected, [issues a
7035   warning][pec] until a better solution is found.
7036
7037 Libraries
7038 ---------
7039
7040 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
7041   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
7042   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
7043   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
7044   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
7045   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
7046   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
7047   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
7048   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
7049   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
7050   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
7051   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
7052   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
7053   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
7054   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
7055   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
7056   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
7057   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
7058   [`thread::sleep`].
7059 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
7060   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
7061   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
7062   `f64::from_str_radix`.
7063 * [Reverse-searching strings is faster with the 'two-way'
7064   algorithm][s].
7065 * [`std::io::copy` allows `?Sized` arguments][cc].
7066 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
7067   [override `count`, `nth` and `last` with an O(1)
7068   implementation][it].
7069 * [`Default` is implemented for arrays up to `[T; 32]`][d].
7070 * [`IntoRawFd` has been added to the Unix-specific prelude,
7071   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
7072   prelude][pr].
7073 * [`Extend<String>` and `FromIterator<String` are both implemented for
7074   `String`][es].
7075 * [`IntoIterator` is implemented for references to `Option` and
7076   `Result`][into2].
7077 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
7078   Copy`][ext] as part of [RFC 839]. This will cause type inference
7079   breakage in rare situations.
7080 * [`BinaryHeap` implements `Debug`][bh2].
7081 * [`Borrow` and `BorrowMut` are implemented for fixed-size
7082   arrays][bm].
7083 * [`extern fn`s with the "Rust" and "C" ABIs implement common
7084   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
7085 * [String comparison is faster][faststr].
7086 * `&mut T` where `T: std::fmt::Write` [also implements
7087   `std::fmt::Write`][mutw].
7088 * [A stable regression in `VecDeque::push_back` and other
7089   capacity-altering methods that caused panics for zero-sized types
7090   was fixed][vd].
7091 * [Function pointers implement traits for up to 12 parameters][fp2].
7092
7093 Miscellaneous
7094 -------------
7095
7096 * The compiler [no longer uses the 'morestack' feature to prevent
7097   stack overflow][mm]. Instead it uses guard pages and stack
7098   probes (though stack probes are not yet implemented on any platform
7099   but Windows).
7100 * [The compiler matches traits faster when projections are involved][p].
7101 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
7102   `usize`][ffi].
7103 * [Cargo now displays useful information about what its doing during
7104   `cargo update`][cu].
7105
7106 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
7107 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
7108 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
7109 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
7110 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
7111 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
7112 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
7113 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
7114 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
7115 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
7116 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
7117 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
7118 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
7119 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
7120 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
7121 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
7122 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
7123 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
7124 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7125 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7126 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7127 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7128 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
7129 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
7130 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
7131 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
7132 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
7133 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
7134 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
7135 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
7136 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
7137 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
7138 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
7139 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
7140 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
7141 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
7142 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
7143 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
7144 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
7145 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
7146 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
7147 [bh2]: https://github.com/rust-lang/rust/pull/28156
7148 [binfat]: https://github.com/rust-lang/rust/pull/28270
7149 [bm]: https://github.com/rust-lang/rust/pull/28197
7150 [cc]: https://github.com/rust-lang/rust/pull/27531
7151 [crlf]: https://github.com/rust-lang/rust/pull/28034
7152 [cu]: https://github.com/rust-lang/cargo/pull/1931
7153 [d]: https://github.com/rust-lang/rust/pull/27825
7154 [dep]: https://github.com/rust-lang/rust/pull/28339
7155 [es]: https://github.com/rust-lang/rust/pull/27956
7156 [ext]: https://github.com/rust-lang/rust/pull/28094
7157 [faststr]: https://github.com/rust-lang/rust/pull/28338
7158 [ffi]: https://github.com/rust-lang/rust/pull/28779
7159 [fp]: https://github.com/rust-lang/rust/pull/28268
7160 [fp2]: https://github.com/rust-lang/rust/pull/28560
7161 [fp3]: https://github.com/rust-lang/rust/pull/27307
7162 [i]: https://github.com/rust-lang/rust/pull/27451
7163 [into2]: https://github.com/rust-lang/rust/pull/28039
7164 [it]: https://github.com/rust-lang/rust/pull/27652
7165 [mm]: https://github.com/rust-lang/rust/pull/27338
7166 [mutw]: https://github.com/rust-lang/rust/pull/28368
7167 [sound]: https://github.com/rust-lang/rust/pull/27641
7168 [p]: https://github.com/rust-lang/rust/pull/27866
7169 [pec]: https://github.com/rust-lang/rust/pull/28486
7170 [pr]: https://github.com/rust-lang/rust/pull/27896
7171 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7172 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7173 [s]: https://github.com/rust-lang/rust/pull/27474
7174 [stab]: https://github.com/rust-lang/rust/pull/28339
7175 [stat]: https://github.com/rust-lang/rust/pull/28321
7176 [vd]: https://github.com/rust-lang/rust/pull/28494
7177
7178 Version 1.3.0 (2015-09-17)
7179 ==============================
7180
7181 * ~900 changes, numerous bugfixes
7182
7183 Highlights
7184 ----------
7185
7186 * The [new object lifetime defaults][nold] have been [turned
7187   on][nold2] after a cycle of warnings about the change. Now types
7188   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
7189   being interpreted as `&'a Box<Trait+'a>` to `&'a
7190   Box<Trait+'static>`.
7191 * [The Rustonomicon][nom] is a new book in the official documentation
7192   that dives into writing unsafe Rust.
7193 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
7194   timekeeping is employed by other std APIs, as well as out-of-tree
7195   time crates.
7196
7197 Breaking Changes
7198 ----------------
7199
7200 * The [new object lifetime defaults][nold] have been [turned
7201   on][nold2] after a cycle of warnings about the change.
7202 * There is a known [regression][lr] in how object lifetime elision is
7203   interpreted, the proper solution for which is undetermined.
7204 * The `#[prelude_import]` attribute, an internal implementation
7205   detail, was accidentally stabilized previously. [It has been put
7206   behind the `prelude_import` feature gate][pi]. This change is
7207   believed to break no existing code.
7208 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7209   [more sane for dynamically sized types][dst3]. Code that relied on
7210   the previous behavior is thought to be broken.
7211 * The `dropck` rules, which checks that destructors can't access
7212   destroyed values, [have been updated][dropck] to match the
7213   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
7214   cause some previously-compiling code to no longer build.
7215
7216 Language
7217 --------
7218
7219 * The [new object lifetime defaults][nold] have been [turned
7220   on][nold2] after a cycle of warnings about the change.
7221 * Semicolons may [now follow types and paths in
7222   macros](https://github.com/rust-lang/rust/pull/27000).
7223 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
7224   [more sane for dynamically sized types][dst3]. Code that relied on
7225   the previous behavior is not known to exist, and suspected to be
7226   broken.
7227 * `'static` variables [may now be recursive][st].
7228 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
7229   implementations correctly.
7230 * The `dropck` rules, which checks that destructors can't access
7231   destroyed values, [have been updated][dropck] to match the
7232   [RFC][dropckrfc].
7233
7234 Libraries
7235 ---------
7236
7237 * The [`Duration`] API, [has been stabilized][ds], as well as the
7238   `std::time` module, which presently contains only `Duration`.
7239 * `Box<str>` and `Box<[T]>` both implement `Clone`.
7240 * The owned C string, [`CString`], implements [`Borrow`] and the
7241   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
7242   these allow C strings to be borrowed and cloned in generic code.
7243 * [`CStr`] implements [`Debug`].
7244 * [`AtomicPtr`] implements [`Debug`].
7245 * [`Error`] trait objects [can be downcast to their concrete types][e]
7246   in many common configurations, using the [`is`], [`downcast`],
7247   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
7248   [`Any`] trait.
7249 * Searching for substrings now [employs the two-way algorithm][search]
7250   instead of doing a naive search. This gives major speedups to a
7251   number of methods, including [`contains`][sc], [`find`][sf],
7252   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
7253   [`ends_with`][sew] are also faster.
7254 * The performance of `PartialEq` for slices is [much faster][ps].
7255 * The [`Hash`] trait offers the default method, [`hash_slice`], which
7256   is overridden and optimized by the implementations for scalars.
7257 * The [`Hasher`] trait now has a number of specialized `write_*`
7258   methods for primitive types, for efficiency.
7259 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
7260   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
7261   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
7262   of [`std::error::Error::cause`][iec] also delegates to the inner
7263   error.
7264 * [`process::Child`][pc] gained the [`id`] method, which returns a
7265   `u32` representing the platform-specific process identifier.
7266 * The [`connect`] method on slices is deprecated, replaced by the new
7267   [`join`] method (note that both of these are on the *unstable*
7268   [`SliceConcatExt`] trait, but through the magic of the prelude are
7269   available to stable code anyway).
7270 * The [`Div`] operator is implemented for [`Wrapping`] types.
7271 * [`DerefMut` is implemented for `String`][dms].
7272 * Performance of SipHash (the default hasher for `HashMap`) is
7273   [better for long data][sh].
7274 * [`AtomicPtr`] implements [`Send`].
7275 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
7276   are now [specialized to use uninitialized buffers for increased
7277   performance][rte].
7278 * Lifetime parameters of foreign functions [are now resolved
7279   properly][f].
7280
7281 Misc
7282 ----
7283
7284 * Rust can now, with some coercion, [produce programs that run on
7285   Windows XP][xp], though XP is not considered a supported platform.
7286 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7287   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7288   recommended for use in 1.3, though should be fully-functional
7289   in the [64-bit 1.4 beta][b14].
7290 * On Fedora-based systems installation will [properly configure the
7291   dynamic linker][fl].
7292 * The compiler gained many new extended error descriptions, which can
7293   be accessed with the `--explain` flag.
7294 * The `dropck` pass, which checks that destructors can't access
7295   destroyed values, [has been rewritten][dropck]. This fixes some
7296   soundness holes, and as such will cause some previously-compiling
7297   code to no longer build.
7298 * `rustc` now uses [LLVM to write archive files where possible][ar].
7299   Eventually this will eliminate the compiler's dependency on the ar
7300   utility.
7301 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7302   supported FreeBSD on x86_64).
7303 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7304   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7305   more strict.
7306 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7307   will kill the process instead of leaking][nlp].
7308
7309 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7310 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7311 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7312 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7313 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7314 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7315 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7316 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7317 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7318 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7319 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7320 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7321 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7322 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7323 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7324 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7325 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7326 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7327 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7328 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7329 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7330 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7331 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7332 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7333 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7334 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7335 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7336 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7337 [ar]: https://github.com/rust-lang/rust/pull/26926
7338 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7339 [dms]: https://github.com/rust-lang/rust/pull/26241
7340 [dropck]: https://github.com/rust-lang/rust/pull/27261
7341 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7342 [ds]: https://github.com/rust-lang/rust/pull/26818
7343 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7344 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7345 [dst3]: https://github.com/rust-lang/rust/pull/27351
7346 [e]: https://github.com/rust-lang/rust/pull/24793
7347 [f]: https://github.com/rust-lang/rust/pull/26588
7348 [fb]: https://github.com/rust-lang/rust/pull/26959
7349 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7350 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7351 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7352 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7353 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7354 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7355 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7356 [lic]: https://github.com/rust-lang/rust/pull/26583
7357 [lnu]: https://github.com/rust-lang/rust/pull/27026
7358 [lr]: https://github.com/rust-lang/rust/issues/27248
7359 [lum]: https://github.com/rust-lang/rust/pull/26378
7360 [lur]: https://github.com/rust-lang/rust/pull/26783
7361 [nlp]: https://github.com/rust-lang/rust/pull/27176
7362 [nold2]: https://github.com/rust-lang/rust/pull/27045
7363 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7364 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7365 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7366 [pi]: https://github.com/rust-lang/rust/pull/26699
7367 [ps]: https://github.com/rust-lang/rust/pull/26884
7368 [rte]: https://github.com/rust-lang/rust/pull/26950
7369 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7370 [search]: https://github.com/rust-lang/rust/pull/26327
7371 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7372 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7373 [sh]: https://github.com/rust-lang/rust/pull/27280
7374 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7375 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7376 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7377 [st]: https://github.com/rust-lang/rust/pull/26630
7378 [win1]: https://github.com/rust-lang/rust/pull/26569
7379 [win2]: https://github.com/rust-lang/rust/pull/26741
7380 [win3]: https://github.com/rust-lang/rust/pull/26741
7381 [win4]: https://github.com/rust-lang/rust/pull/27210
7382 [xp]: https://github.com/rust-lang/rust/pull/26569
7383
7384 Version 1.2.0 (2015-08-07)
7385 ==========================
7386
7387 * ~1200 changes, numerous bugfixes
7388
7389 Highlights
7390 ----------
7391
7392 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7393   like `Rc` to contain types without a fixed size, arrays and trait
7394   objects, finally enabling use of `Rc<[T]>` and completing the
7395   implementation of DST.
7396 * [Parallel codegen][parcodegen] is now working again, which can
7397   substantially speed up large builds in debug mode; It also gets
7398   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7399   jobs). It's not enabled by default, but will be "in the near
7400   future". It can be activated with the `-C codegen-units=N` flag to
7401   `rustc`.
7402 * This is the first release with [experimental support for linking
7403   with the MSVC linker and lib C on Windows (instead of using the GNU
7404   variants via MinGW)][win]. It is yet recommended only for the most
7405   intrepid Rustaceans.
7406 * Benchmark compilations are showing a 30% improvement in
7407   bootstrapping over 1.1.
7408
7409 Breaking Changes
7410 ----------------
7411
7412 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7413   unicode case mapping, which is a previously-planned change in
7414   behavior and considered a bugfix.
7415 * [`mem::align_of`] now specifies [the *minimum alignment* for
7416   T][align], which is usually the alignment programs are interested
7417   in, and the same value reported by clang's
7418   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7419   break real code.
7420 * [The `#[packed]` attribute is no longer silently accepted by the
7421   compiler][packed]. This attribute did nothing and code that
7422   mentioned it likely did not work as intended.
7423 * Associated type defaults are [now behind the
7424   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7425   defaults *did not work*, but could be mentioned syntactically. As
7426   such this breakage has minimal impact.
7427
7428 Language
7429 --------
7430
7431 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7432   matching against dereferenceable values.
7433
7434 Libraries
7435 ---------
7436
7437 * The [`Extend`] trait, which grows a collection from an iterator, is
7438   implemented over iterators of references, for `String`, `Vec`,
7439   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7440   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7441 * The [`iter::once`] function returns an iterator that yields a single
7442   element, and [`iter::empty`] returns an iterator that yields no
7443   elements.
7444 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7445   over substring matches.
7446 * [`Cell`] and [`RefCell`] both implement `Eq`.
7447 * A number of methods for wrapping arithmetic are added to the
7448   integral types, [`wrapping_div`], [`wrapping_rem`],
7449   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7450   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7451   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7452   type.. It is illegal for the default arithmetic operations in Rust
7453   to overflow; the desire to wrap must be explicit.
7454 * The `{:#?}` formatting specifier [displays the alternate,
7455   pretty-printed][debugfmt] form of the `Debug` formatter. This
7456   feature was actually introduced prior to 1.0 with little
7457   fanfare.
7458 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7459   for writing data to formatted strings, similar to [`io::Write`].
7460 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7461   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7462   are used by code generators to emit implementations of [`Debug`].
7463 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7464   methods that convert case, following Unicode case mapping.
7465 * It is now easier to handle poisoned locks. The [`PoisonError`]
7466   type, returned by failing lock operations, exposes `into_inner`,
7467   `get_ref`, and `get_mut`, which all give access to the inner lock
7468   guard, and allow the poisoned lock to continue to operate. The
7469   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7470   poisoned lock without attempting to take the lock.
7471 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7472   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7473   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7474   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7475   `ChildStderr`.
7476 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7477   malformed input.
7478
7479 Misc
7480 ----
7481
7482 * `rustc` employs smarter heuristics for guessing at [typos].
7483 * `rustc` emits more efficient code for [no-op conversions between
7484   unsafe pointers][nop].
7485 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7486   resulting in faster compile times and smaller code.
7487
7488 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7489 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7490 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7491 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7492 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7493 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7494 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7495 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7496 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7497 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7498 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7499 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7500 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7501 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7502 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7503 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7504 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7505 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7506 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7507 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7508 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7509 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7510 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7511 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7512 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7513 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7514 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7515 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7516 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7517 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7518 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7519 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7520 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7521 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7522 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7523 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7524 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7525 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7526 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7527 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7528 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7529 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7530 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7531 [align]: https://github.com/rust-lang/rust/pull/25646
7532 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7533 [typos]: https://github.com/rust-lang/rust/pull/26087
7534 [nop]: https://github.com/rust-lang/rust/pull/26336
7535 [fat]: https://github.com/rust-lang/rust/pull/26411
7536 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7537 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7538 [packed]: https://github.com/rust-lang/rust/pull/25541
7539 [ad]: https://github.com/rust-lang/rust/pull/27382
7540 [win]: https://github.com/rust-lang/rust/pull/25350
7541
7542 Version 1.1.0 (2015-06-25)
7543 =========================
7544
7545 * ~850 changes, numerous bugfixes
7546
7547 Highlights
7548 ----------
7549
7550 * The [`std::fs` module has been expanded][fs] to expand the set of
7551   functionality exposed:
7552   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7553     don't incur a syscall on some platforms.
7554   * A `symlink_metadata` function has been added.
7555   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7556     access to all underlying information.
7557 * The compiler now contains extended explanations of many errors. When an error
7558   with an explanation occurs the compiler suggests using the `--explain` flag
7559   to read the explanation. Error explanations are also [available online][err-index].
7560 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7561   well as other work, the time to bootstrap the compiler decreased by
7562   32%.
7563
7564 Libraries
7565 ---------
7566
7567 * The [`str::split_whitespace`] method splits a string on unicode
7568   whitespace boundaries.
7569 * On both Windows and Unix, new extension traits provide conversion of
7570   I/O types to and from the underlying system handles. On Unix, these
7571   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7572   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7573   `TcpListener`, and `UpdSocket`. Further implementations for
7574   `std::process` will be stabilized later.
7575 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7576   Windows, symlinks can be created with
7577   `std::os::windows::symlink_dir` and
7578   `std::os::windows::symlink_file`.
7579 * The `mpsc::Receiver` type can now be converted into an iterator with
7580   `into_iter` on the [`IntoIterator`] trait.
7581 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7582   implementation of the [`From`] trait.
7583 * The `Debug` implementation for `RangeFull` [creates output that is
7584   more consistent with other implementations][rf].
7585 * [`Debug` is implemented for `File`][file].
7586 * The `Default` implementation for `Arc` [no longer requires `Sync +
7587   Send`][arc].
7588 * [The `Iterator` methods `count`, `nth`, and `last` have been
7589   overridden for slices to have O(1) performance instead of O(n)][si].
7590 * Incorrect handling of paths on Windows has been improved in both the
7591   compiler and the standard library.
7592 * [`AtomicPtr` gained a `Default` implementation][ap].
7593 * In accordance with Rust's policy on arithmetic overflow `abs` now
7594   [panics on overflow when debug assertions are enabled][abs].
7595 * The [`Cloned`] iterator, which was accidentally left unstable for
7596   1.0 [has been stabilized][c].
7597 * The [`Incoming`] iterator, which iterates over incoming TCP
7598   connections, and which was accidentally unnamable in 1.0, [is now
7599   properly exported][inc].
7600 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7601   `sift_up` or `sift_down` panic][bh].
7602 * The [`split_off`] method of `LinkedList` [no longer corrupts
7603   the list in certain scenarios][ll].
7604
7605 Misc
7606 ----
7607
7608 * Type checking performance [has improved notably][sk] with
7609   [multiple improvements][pre].
7610 * The compiler [suggests code changes][ch] for more errors.
7611 * rustc and it's build system have experimental support for [building
7612   toolchains against MUSL][m] instead of glibc on Linux.
7613 * The compiler defines the `target_env` cfg value, which is used for
7614   distinguishing toolchains that are otherwise for the same
7615   platform. Presently this is set to `gnu` for common GNU Linux
7616   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7617 * The [`cargo rustc`][crc] command invokes a build with custom flags
7618   to rustc.
7619 * [Android executables are always position independent][pie].
7620 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7621   with `Drop`][drop].
7622
7623 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7624 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7625 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7626 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7627 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7628 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7629 [rf]: https://github.com/rust-lang/rust/pull/24491
7630 [err-index]: https://doc.rust-lang.org/error-index.html
7631 [sk]: https://github.com/rust-lang/rust/pull/24615
7632 [pre]: https://github.com/rust-lang/rust/pull/25323
7633 [file]: https://github.com/rust-lang/rust/pull/24598
7634 [ch]: https://github.com/rust-lang/rust/pull/24683
7635 [arc]: https://github.com/rust-lang/rust/pull/24695
7636 [si]: https://github.com/rust-lang/rust/pull/24701
7637 [ap]: https://github.com/rust-lang/rust/pull/24834
7638 [m]: https://github.com/rust-lang/rust/pull/24777
7639 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7640 [crc]: https://github.com/rust-lang/cargo/pull/1568
7641 [pie]: https://github.com/rust-lang/rust/pull/24953
7642 [abs]: https://github.com/rust-lang/rust/pull/25441
7643 [c]: https://github.com/rust-lang/rust/pull/25496
7644 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7645 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7646 [inc]: https://github.com/rust-lang/rust/pull/25522
7647 [bh]: https://github.com/rust-lang/rust/pull/25856
7648 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7649 [ll]: https://github.com/rust-lang/rust/pull/26022
7650 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7651 [drop]: https://github.com/rust-lang/rust/pull/24935
7652
7653 Version 1.0.0 (2015-05-15)
7654 ========================
7655
7656 * ~1500 changes, numerous bugfixes
7657
7658 Highlights
7659 ----------
7660
7661 * The vast majority of the standard library is now `#[stable]`. It is
7662   no longer possible to use unstable features with a stable build of
7663   the compiler.
7664 * Many popular crates on [crates.io] now work on the stable release
7665   channel.
7666 * Arithmetic on basic integer types now [checks for overflow in debug
7667   builds][overflow].
7668
7669 Language
7670 --------
7671
7672 * Several [restrictions have been added to trait coherence][coh] in
7673   order to make it easier for upstream authors to change traits
7674   without breaking downstream code.
7675 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7676   improve error messages and macro behavior. For example, `0b1234` is
7677   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7678 * Trait bounds [are always invariant][inv], eliminating the need for
7679   the `PhantomFn` and `MarkerTrait` lang items, which have been
7680   removed.
7681 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7682   "foo" as bar` syntax has been replaced with `extern crate foo as
7683   bar`, and Cargo now automatically translates "-" in *package* names
7684   to underscore for the crate name.
7685 * [Lifetime shadowing is an error][lt].
7686 * [`Send` no longer implies `'static`][send-rfc].
7687 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7688   `MyType::default()`.
7689 * Primitive types [now have inherent methods][prim-inherent],
7690   obviating the need for extension traits like `SliceExt`.
7691 * Methods with `Self: Sized` in their `where` clause are [considered
7692   object-safe][self-sized], allowing many extension traits like
7693   `IteratorExt` to be merged into the traits they extended.
7694 * You can now [refer to associated types][assoc-where] whose
7695   corresponding trait bounds appear only in a `where` clause.
7696 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7697   like `Send` and `Sync` are now library-defined.
7698 * A [Reflect trait][reflect] was introduced, which means that
7699   downcasting via the `Any` trait is effectively limited to concrete
7700   types. This helps retain the potentially-important "parametricity"
7701   property: generic code cannot behave differently for different type
7702   arguments except in minor ways.
7703 * The `unsafe_destructor` feature is now deprecated in favor of the
7704   [new `dropck`][dropck]. This change is a major reduction in unsafe
7705   code.
7706
7707 Libraries
7708 ---------
7709
7710 * The `thread_local` module [has been renamed to `std::thread`][th].
7711 * The methods of `IteratorExt` [have been moved to the `Iterator`
7712   trait itself][ie].
7713 * Several traits that implement Rust's conventions for type
7714   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7715   [centralized in the `std::convert` module][con].
7716 * The `FromError` trait [was removed in favor of `From`][fe].
7717 * The basic sleep function [has moved to
7718   `std::thread::sleep_ms`][slp].
7719 * The `splitn` function now takes an `n` parameter that represents the
7720   number of items yielded by the returned iterator [instead of the
7721   number of 'splits'][spl].
7722 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7723 * [Derived implementations of `PartialOrd` now order enums according
7724   to their explicitly-assigned discriminants][po].
7725 * [Methods for searching strings are generic over `Pattern`s][pat],
7726   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7727   some others.
7728 * [In method resolution, object methods are resolved before inherent
7729   methods][meth].
7730 * [`String::from_str` has been deprecated in favor of the `From` impl,
7731   `String::from`][sf].
7732 * [`io::Error` implements `Sync`][ios].
7733 * [The `words` method on `&str` has been replaced with
7734   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7735   a word?'
7736 * The new path and IO modules are complete and `#[stable]`. This
7737   was the major library focus for this cycle.
7738 * The path API was [revised][path-normalize] to normalize `.`,
7739   adjusting the tradeoffs in favor of the most common usage.
7740 * A large number of remaining APIs in `std` were also stabilized
7741   during this cycle; about 75% of the non-deprecated API surface
7742   is now stable.
7743 * The new [string pattern API][string-pattern] landed, which makes
7744   the string slice API much more internally consistent and flexible.
7745 * A new set of [generic conversion traits][conversion] replaced
7746   many existing ad hoc traits.
7747 * Generic numeric traits were [completely removed][num-traits]. This
7748   was made possible thanks to inherent methods for primitive types,
7749   and the removal gives maximal flexibility for designing a numeric
7750   hierarchy in the future.
7751 * The `Fn` traits are now related via [inheritance][fn-inherit]
7752   and provide ergonomic [blanket implementations][fn-blanket].
7753 * The `Index` and `IndexMut` traits were changed to
7754   [take the index by value][index-value], enabling code like
7755   `hash_map["string"]` to work.
7756 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7757   `Copy` data is known to be `Clone` as well.
7758
7759 Misc
7760 ----
7761
7762 * Many errors now have extended explanations that can be accessed with
7763   the `--explain` flag to `rustc`.
7764 * Many new examples have been added to the standard library
7765   documentation.
7766 * rustdoc has received a number of improvements focused on completion
7767   and polish.
7768 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7769 * Much headway was made on ecosystem-wide CI, making it possible
7770   to [compare builds for breakage][ci-compare].
7771
7772
7773 [crates.io]: http://crates.io
7774 [clo]: https://github.com/rust-lang/rust/pull/24034
7775 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7776 [con]: https://github.com/rust-lang/rust/pull/23875
7777 [cr]: https://github.com/rust-lang/rust/pull/23419
7778 [fe]: https://github.com/rust-lang/rust/pull/23879
7779 [ie]: https://github.com/rust-lang/rust/pull/23300
7780 [inv]: https://github.com/rust-lang/rust/pull/23938
7781 [ios]: https://github.com/rust-lang/rust/pull/24133
7782 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7783 [lt]: https://github.com/rust-lang/rust/pull/24057
7784 [meth]: https://github.com/rust-lang/rust/pull/24056
7785 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7786 [po]: https://github.com/rust-lang/rust/pull/24270
7787 [sf]: https://github.com/rust-lang/rust/pull/24517
7788 [slp]: https://github.com/rust-lang/rust/pull/23949
7789 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7790 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7791 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7792 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7793 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7794 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7795 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7796 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7797 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7798 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7799 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7800 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7801 [reflect]: https://github.com/rust-lang/rust/pull/23712
7802 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7803 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7804 [index-value]: https://github.com/rust-lang/rust/pull/23601
7805 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7806 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7807 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7808 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7809 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7810 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7811
7812
7813 Version 1.0.0-alpha.2 (2015-02-20)
7814 =====================================
7815
7816 * ~1300 changes, numerous bugfixes
7817
7818 * Highlights
7819
7820     * The various I/O modules were [overhauled][io-rfc] to reduce
7821       unnecessary abstractions and provide better interoperation with
7822       the underlying platform. The old `io` module remains temporarily
7823       at `std::old_io`.
7824     * The standard library now [participates in feature gating][feat],
7825       so use of unstable libraries now requires a `#![feature(...)]`
7826       attribute. The impact of this change is [described on the
7827       forum][feat-forum]. [RFC][feat-rfc].
7828
7829 * Language
7830
7831     * `for` loops [now operate on the `IntoIterator` trait][into],
7832       which eliminates the need to call `.iter()`, etc. to iterate
7833       over collections. There are some new subtleties to remember
7834       though regarding what sort of iterators various types yield, in
7835       particular that `for foo in bar { }` yields values from a move
7836       iterator, destroying the original collection. [RFC][into-rfc].
7837     * Objects now have [default lifetime bounds][obj], so you don't
7838       have to write `Box<Trait+'static>` when you don't care about
7839       storing references. [RFC][obj-rfc].
7840     * In types that implement `Drop`, [lifetimes must outlive the
7841       value][drop]. This will soon make it possible to safely
7842       implement `Drop` for types where `#[unsafe_destructor]` is now
7843       required. Read the [gorgeous RFC][drop-rfc] for details.
7844     * The fully qualified <T as Trait>::X syntax lets you set the Self
7845       type for a trait method or associated type. [RFC][ufcs-rfc].
7846     * References to types that implement `Deref<U>` now [automatically
7847       coerce to references][deref] to the dereferenced type `U`,
7848       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7849       should eliminate many unsightly uses of `&*`, as when converting
7850       from references to vectors into references to
7851       slices. [RFC][deref-rfc].
7852     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7853       `|:|`) is obsolete and closure kind is inferred from context.
7854     * [`Self` is a keyword][Self].
7855
7856 * Libraries
7857
7858     * The `Show` and `String` formatting traits [have been
7859       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7860       their related purposes. Automatically getting a string
7861       conversion to use with `format!("{:?}", something_to_debug)` is
7862       now written `#[derive(Debug)]`.
7863     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7864       OsStr}`, provide strings in platform-specific encodings for easier
7865       interop with system APIs. [RFC][osstr-rfc].
7866     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7867       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7868       creating raw pointers.
7869
7870 * Tooling
7871
7872     * Certain long error messages of the form 'expected foo found bar'
7873       are now [split neatly across multiple
7874       lines][multiline]. Examples in the PR.
7875     * On Unix Rust can be [uninstalled][un] by running
7876       `/usr/local/lib/rustlib/uninstall.sh`.
7877     * The `#[rustc_on_unimplemented]` attribute, requiring the
7878       'on_unimplemented' feature, lets rustc [display custom error
7879       messages when a trait is expected to be implemented for a type
7880       but is not][onun].
7881
7882 * Misc
7883
7884     * Rust is tested against a [LALR grammar][lalr], which parses
7885       almost all the Rust files that rustc does.
7886
7887 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7888 [close]: https://github.com/rust-lang/rust/pull/21843
7889 [deref]: https://github.com/rust-lang/rust/pull/21351
7890 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7891 [drop]: https://github.com/rust-lang/rust/pull/21972
7892 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7893 [feat]: https://github.com/rust-lang/rust/pull/21248
7894 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7895 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7896 [fmt]: https://github.com/rust-lang/rust/pull/21457
7897 [into]: https://github.com/rust-lang/rust/pull/20790
7898 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7899 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7900 [lalr]: https://github.com/rust-lang/rust/pull/21452
7901 [multiline]: https://github.com/rust-lang/rust/pull/19870
7902 [obj]: https://github.com/rust-lang/rust/pull/22230
7903 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7904 [onun]: https://github.com/rust-lang/rust/pull/20889
7905 [osstr]: https://github.com/rust-lang/rust/pull/21488
7906 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7907 [Self]: https://github.com/rust-lang/rust/pull/22158
7908 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7909 [un]: https://github.com/rust-lang/rust/pull/22256
7910
7911
7912 Version 1.0.0-alpha (2015-01-09)
7913 ==================================
7914
7915   * ~2400 changes, numerous bugfixes
7916
7917   * Highlights
7918
7919     * The language itself is considered feature complete for 1.0,
7920       though there will be many usability improvements and bugfixes
7921       before the final release.
7922     * Nearly 50% of the public API surface of the standard library has
7923       been declared 'stable'. Those interfaces are unlikely to change
7924       before 1.0.
7925     * The long-running debate over integer types has been
7926       [settled][ints]: Rust will ship with types named `isize` and
7927       `usize`, rather than `int` and `uint`, for pointer-sized
7928       integers. Guidelines will be rolled out during the alpha cycle.
7929     * Most crates that are not `std` have been moved out of the Rust
7930       distribution into the Cargo ecosystem so they can evolve
7931       separately and don't need to be stabilized as quickly, including
7932       'time', 'getopts', 'num', 'regex', and 'term'.
7933     * Documentation continues to be expanded with more API coverage, more
7934       examples, and more in-depth explanations. The guides have been
7935       consolidated into [The Rust Programming Language][trpl].
7936     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7937     * All official Rust binary installers now come with [Cargo], the
7938       Rust package manager.
7939
7940 * Language
7941
7942     * Closures have been [completely redesigned][unboxed] to be
7943       implemented in terms of traits, can now be used as generic type
7944       bounds and thus monomorphized and inlined, or via an opaque
7945       pointer (boxed) as in the old system. The new system is often
7946       referred to as 'unboxed' closures.
7947     * Traits now support [associated types][assoc], allowing families
7948       of related types to be defined together and used generically in
7949       powerful ways.
7950     * Enum variants are [namespaced by their type names][enum].
7951     * [`where` clauses][where] provide a more versatile and attractive
7952       syntax for specifying generic bounds, though the previous syntax
7953       remains valid.
7954     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7955       numeric types.
7956     * Rust [no longer has a runtime][rt] of any description, and only
7957       supports OS threads, not green threads.
7958     * At long last, Rust has been overhauled for 'dynamically-sized
7959       types' ([DST]), which integrates 'fat pointers' (object types,
7960       arrays, and `str`) more deeply into the type system, making it
7961       more consistent.
7962     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7963       `..j` that produce range types and which, when combined with the
7964       `Index` operator and multidispatch, leads to a convenient slice
7965       notation, `[i..j]`.
7966     * The new range syntax revealed an ambiguity in the fixed-length
7967       array syntax, so now fixed length arrays [are written `[T;
7968       N]`][arrays].
7969     * The `Copy` trait is no longer implemented automatically. Unsafe
7970       pointers no longer implement `Sync` and `Send` so types
7971       containing them don't automatically either. `Sync` and `Send`
7972       are now 'unsafe traits' so one can "forcibly" implement them via
7973       `unsafe impl` if a type confirms to the requirements for them
7974       even though the internals do not (e.g. structs containing unsafe
7975       pointers like `Arc`). These changes are intended to prevent some
7976       footguns and are collectively known as [opt-in built-in
7977       traits][oibit] (though `Sync` and `Send` will soon become pure
7978       library types unknown to the compiler).
7979     * Operator traits now take their operands [by value][ops], and
7980       comparison traits can use multidispatch to compare one type
7981       against multiple other types, allowing e.g. `String` to be
7982       compared with `&str`.
7983     * `if let` and `while let` are no longer feature-gated.
7984     * Rust has adopted a more [uniform syntax for escaping unicode
7985       characters][unicode].
7986     * `macro_rules!` [has been declared stable][mac]. Though it is a
7987       flawed system it is sufficiently popular that it must be usable
7988       for 1.0. Effort has gone into [future-proofing][mac-future] it
7989       in ways that will allow other macro systems to be developed in
7990       parallel, and won't otherwise impact the evolution of the
7991       language.
7992     * The prelude has been [pared back significantly][prelude] such
7993       that it is the minimum necessary to support the most pervasive
7994       code patterns, and through [generalized where clauses][where]
7995       many of the prelude extension traits have been consolidated.
7996     * Rust's rudimentary reflection [has been removed][refl], as it
7997       incurred too much code generation for little benefit.
7998     * [Struct variants][structvars] are no longer feature-gated.
7999     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8000       known as 'higher-ranked trait bounds', this crucially allows
8001       unboxed closures to work.
8002     * Macros invocations surrounded by parens or square brackets and
8003       not terminated by a semicolon are [parsed as
8004       expressions][macros], which makes expressions like `vec![1i32,
8005       2, 3].len()` work as expected.
8006     * Trait objects now implement their traits automatically, and
8007       traits that can be coerced to objects now must be [object
8008       safe][objsafe].
8009     * Automatically deriving traits is now done with `#[derive(...)]`
8010       not `#[deriving(...)]` for [consistency with other naming
8011       conventions][derive].
8012     * Importing the containing module or enum at the same time as
8013       items or variants they contain is [now done with `self` instead
8014       of `mod`][self], as in use `foo::{self, bar}`
8015     * Glob imports are no longer feature-gated.
8016     * The `box` operator and `box` patterns have been feature-gated
8017       pending a redesign. For now unique boxes should be allocated
8018       like other containers, with `Box::new`.
8019
8020 * Libraries
8021
8022     * A [series][coll1] of [efforts][coll2] to establish
8023       [conventions][coll3] for collections types has resulted in API
8024       improvements throughout the standard library.
8025     * New [APIs for error handling][err] provide ergonomic interop
8026       between error types, and [new conventions][err-conv] describe
8027       more clearly the recommended error handling strategies in Rust.
8028     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8029       it is easier to discuss failure in the context of error handling
8030       without making clarifications as to whether you are referring to
8031       the 'fail' macro or failure more generally.
8032     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
8033       syscall when available.
8034     * The 'serialize' crate has been renamed 'rustc-serialize' and
8035       moved out of the distribution to Cargo. Although it is widely
8036       used now, it is expected to be superseded in the near future.
8037     * The `Show` formatter, typically implemented with
8038       `#[derive(Show)]` is [now requested with the `{:?}`
8039       specifier][show] and is intended for use by all types, for uses
8040       such as `println!` debugging. The new `String` formatter must be
8041       implemented by hand, uses the `{}` specifier, and is intended
8042       for full-fidelity conversions of things that can logically be
8043       represented as strings.
8044
8045 * Tooling
8046
8047     * [Flexible target specification][flex] allows rustc's code
8048       generation to be configured to support otherwise-unsupported
8049       platforms.
8050     * Rust comes with rust-gdb and rust-lldb scripts that launch their
8051       respective debuggers with Rust-appropriate pretty-printing.
8052     * The Windows installation of Rust is distributed with the
8053       MinGW components currently required to link binaries on that
8054       platform.
8055
8056 * Misc
8057
8058     * Nullable enum optimizations have been extended to more types so
8059       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
8060       space than the inner types themselves.
8061     * Work has begun on supporting AArch64.
8062
8063 [Cargo]: https://crates.io
8064 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
8065 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
8066 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
8067 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
8068 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
8069 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
8070 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
8071 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
8072 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
8073 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
8074 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
8075 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
8076 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
8077 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
8078 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
8079 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
8080 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
8081 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
8082 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
8083 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
8084 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
8085 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
8086 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
8087 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
8088 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
8089 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
8090 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
8091 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
8092 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
8093 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
8094 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
8095 [trpl]: https://doc.rust-lang.org/book/index.html
8096 [rbe]: http://rustbyexample.com/
8097
8098
8099 Version 0.12.0 (2014-10-09)
8100 =============================
8101
8102   * ~1900 changes, numerous bugfixes
8103
8104   * Highlights
8105
8106     * The introductory documentation (now called The Rust Guide) has
8107       been completely rewritten, as have a number of supplementary
8108       guides.
8109     * Rust's package manager, Cargo, continues to improve and is
8110       sometimes considered to be quite awesome.
8111     * Many API's in `std` have been reviewed and updated for
8112       consistency with the in-development Rust coding
8113       guidelines. The standard library documentation tracks
8114       stabilization progress.
8115     * Minor libraries have been moved out-of-tree to the rust-lang org
8116       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
8117       be installed with Cargo.
8118     * Lifetime elision allows lifetime annotations to be left off of
8119       function declarations in many common scenarios.
8120     * Rust now works on 64-bit Windows.
8121
8122   * Language
8123     * Indexing can be overloaded with the `Index` and `IndexMut`
8124       traits.
8125     * The `if let` construct takes a branch only if the `let` pattern
8126       matches, currently behind the 'if_let' feature gate.
8127     * 'where clauses', a more flexible syntax for specifying trait
8128       bounds that is more aesthetic, have been added for traits and
8129       free functions. Where clauses will in the future make it
8130       possible to constrain associated types, which would be
8131       impossible with the existing syntax.
8132     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
8133       the 'slicing_syntax' feature gate, and can be overloaded with
8134       the `Slice` or `SliceMut` traits.
8135     * The syntax for matching of sub-slices has been changed to use a
8136       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
8137       consistency with other uses of `..` and to future-proof
8138       potential additional uses of the syntax.
8139     * The syntax for matching inclusive ranges in patterns has changed
8140       from `0..3` to `0...4` to be consistent with the exclusive range
8141       syntax for slicing.
8142     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
8143       c]`) has been put behind the 'advanced_slice_patterns' feature
8144       gate and may be removed in the future.
8145     * Components of tuples and tuple structs can be extracted using
8146       the `value.0` syntax, currently behind the `tuple_indexing`
8147       feature gate.
8148     * The `#[crate_id]` attribute is no longer supported; versioning
8149       is handled by the package manager.
8150     * Renaming crate imports are now written `extern crate foo as bar`
8151       instead of `extern crate bar = foo`.
8152     * Renaming use statements are now written `use foo as bar` instead
8153       of `use bar = foo`.
8154     * `let` and `match` bindings and argument names in macros are now
8155       hygienic.
8156     * The new, more efficient, closure types ('unboxed closures') have
8157       been added under a feature gate, 'unboxed_closures'. These will
8158       soon replace the existing closure types, once higher-ranked
8159       trait lifetimes are added to the language.
8160     * `move` has been added as a keyword, for indicating closures
8161       that capture by value.
8162     * Mutation and assignment is no longer allowed in pattern guards.
8163     * Generic structs and enums can now have trait bounds.
8164     * The `Share` trait is now called `Sync` to free up the term
8165       'shared' to refer to 'shared reference' (the default reference
8166       type.
8167     * Dynamically-sized types have been mostly implemented,
8168       unifying the behavior of fat-pointer types with the rest of the
8169       type system.
8170     * As part of dynamically-sized types, the `Sized` trait has been
8171       introduced, which qualifying types implement by default, and
8172       which type parameters expect by default. To specify that a type
8173       parameter does not need to be sized, write `<Sized? T>`. Most
8174       types are `Sized`, notable exceptions being unsized arrays
8175       (`[T]`) and trait types.
8176     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
8177     * Lifetime bounds can now be applied to type parameters and object
8178       types.
8179     * The old, reference counted GC type, `Gc<T>` which was once
8180       denoted by the `@` sigil, has finally been removed. GC will be
8181       revisited in the future.
8182
8183   * Libraries
8184     * Library documentation has been improved for a number of modules.
8185     * Bit-vectors, collections::bitv has been modernized.
8186     * The url crate is deprecated in favor of
8187       http://github.com/servo/rust-url, which can be installed with
8188       Cargo.
8189     * Most I/O stream types can be cloned and subsequently closed from
8190       a different thread.
8191     * A `std::time::Duration` type has been added for use in I/O
8192       methods that rely on timers, as well as in the 'time' crate's
8193       `Timespec` arithmetic.
8194     * The runtime I/O abstraction layer that enabled the green thread
8195       scheduler to do non-thread-blocking I/O has been removed, along
8196       with the libuv-based implementation employed by the green thread
8197       scheduler. This will greatly simplify the future I/O work.
8198     * `collections::btree` has been rewritten to have a more
8199       idiomatic and efficient design.
8200
8201   * Tooling
8202     * rustdoc output now indicates the stability levels of API's.
8203     * The `--crate-name` flag can specify the name of the crate
8204       being compiled, like `#[crate_name]`.
8205     * The `-C metadata` specifies additional metadata to hash into
8206       symbol names, and `-C extra-filename` specifies additional
8207       information to put into the output filename, for use by the
8208       package manager for versioning.
8209     * debug info generation has continued to improve and should be
8210       more reliable under both gdb and lldb.
8211     * rustc has experimental support for compiling in parallel
8212       using the `-C codegen-units` flag.
8213     * rustc no longer encodes rpath information into binaries by
8214       default.
8215
8216   * Misc
8217     * Stack usage has been optimized with LLVM lifetime annotations.
8218     * Official Rust binaries on Linux are more compatible with older
8219       kernels and distributions, built on CentOS 5.10.
8220
8221
8222 Version 0.11.0 (2014-07-02)
8223 ==========================
8224
8225   * ~1700 changes, numerous bugfixes
8226
8227   * Language
8228     * ~[T] has been removed from the language. This type is superseded by
8229       the Vec<T> type.
8230     * ~str has been removed from the language. This type is superseded by
8231       the String type.
8232     * ~T has been removed from the language. This type is superseded by the
8233       Box<T> type.
8234     * @T has been removed from the language. This type is superseded by the
8235       standard library's std::gc::Gc<T> type.
8236     * Struct fields are now all private by default.
8237     * Vector indices and shift amounts are both required to be a `uint`
8238       instead of any integral type.
8239     * Byte character, byte string, and raw byte string literals are now all
8240       supported by prefixing the normal literal with a `b`.
8241     * Multiple ABIs are no longer allowed in an ABI string
8242     * The syntax for lifetimes on closures/procedures has been tweaked
8243       slightly: `<'a>|A, B|: 'b + K -> T`
8244     * Floating point modulus has been removed from the language; however it
8245       is still provided by a library implementation.
8246     * Private enum variants are now disallowed.
8247     * The `priv` keyword has been removed from the language.
8248     * A closure can no longer be invoked through a &-pointer.
8249     * The `use foo, bar, baz;` syntax has been removed from the language.
8250     * The transmute intrinsic no longer works on type parameters.
8251     * Statics now allow blocks/items in their definition.
8252     * Trait bounds are separated from objects with + instead of : now.
8253     * Objects can no longer be read while they are mutably borrowed.
8254     * The address of a static is now marked as insignificant unless the
8255       #[inline(never)] attribute is placed it.
8256     * The #[unsafe_destructor] attribute is now behind a feature gate.
8257     * Struct literals are no longer allowed in ambiguous positions such as
8258       if, while, match, and for..in.
8259     * Declaration of lang items and intrinsics are now feature-gated by
8260       default.
8261     * Integral literals no longer default to `int`, and floating point
8262       literals no longer default to `f64`. Literals must be suffixed with an
8263       appropriate type if inference cannot determine the type of the
8264       literal.
8265     * The Box<T> type is no longer implicitly borrowed to &mut T.
8266     * Procedures are now required to not capture borrowed references.
8267
8268   * Libraries
8269     * The standard library is now a "facade" over a number of underlying
8270       libraries. This means that development on the standard library should
8271       be speedier due to smaller crates, as well as a clearer line between
8272       all dependencies.
8273     * A new library, libcore, lives under the standard library's facade
8274       which is Rust's "0-assumption" library, suitable for embedded and
8275       kernel development for example.
8276     * A regex crate has been added to the standard distribution. This crate
8277       includes statically compiled regular expressions.
8278     * The unwrap/unwrap_err methods on Result require a Show bound for
8279       better error messages.
8280     * The return types of the std::comm primitives have been centralized
8281       around the Result type.
8282     * A number of I/O primitives have gained the ability to time out their
8283       operations.
8284     * A number of I/O primitives have gained the ability to close their
8285       reading/writing halves to cancel pending operations.
8286     * Reverse iterator methods have been removed in favor of `rev()` on
8287       their forward-iteration counterparts.
8288     * A bitflags! macro has been added to enable easy interop with C and
8289       management of bit flags.
8290     * A debug_assert! macro is now provided which is disabled when
8291       `--cfg ndebug` is passed to the compiler.
8292     * A graphviz crate has been added for creating .dot files.
8293     * The std::cast module has been migrated into std::mem.
8294     * The std::local_data api has been migrated from freestanding functions
8295       to being based on methods.
8296     * The Pod trait has been renamed to Copy.
8297     * jemalloc has been added as the default allocator for types.
8298     * The API for allocating memory has been changed to use proper alignment
8299       and sized deallocation
8300     * Connecting a TcpStream or binding a TcpListener is now based on a
8301       string address and a u16 port. This allows connecting to a hostname as
8302       opposed to an IP.
8303     * The Reader trait now contains a core method, read_at_least(), which
8304       correctly handles many repeated 0-length reads.
8305     * The process-spawning API is now centered around a builder-style
8306       Command struct.
8307     * The :? printing qualifier has been moved from the standard library to
8308       an external libdebug crate.
8309     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8310       have been renamed to Eq/Ord.
8311     * The select/plural methods have been removed from format!. The escapes
8312       for { and } have also changed from \{ and \} to {{ and }},
8313       respectively.
8314     * The TaskBuilder API has been re-worked to be a true builder, and
8315       extension traits for spawning native/green tasks have been added.
8316
8317   * Tooling
8318     * All breaking changes to the language or libraries now have their
8319       commit message annotated with `[breaking-change]` to allow for easy
8320       discovery of breaking changes.
8321     * The compiler will now try to suggest how to annotate lifetimes if a
8322       lifetime-related error occurs.
8323     * Debug info continues to be improved greatly with general bug fixes and
8324       better support for situations like link time optimization (LTO).
8325     * Usage of syntax extensions when cross-compiling has been fixed.
8326     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8327       -fdata-sections and --gc-sections has been enabled by default
8328     * The compiler is now stricter about where it will load module files
8329       from when a module is declared via `mod foo;`.
8330     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8331       Syntax extensions are now discovered via a "plugin registrar" type
8332       which will be extended in the future to other various plugins.
8333     * Lints have been restructured to allow for dynamically loadable lints.
8334     * A number of rustdoc improvements:
8335       * The HTML output has been visually redesigned.
8336       * Markdown is now powered by hoedown instead of sundown.
8337       * Searching heuristics have been greatly improved.
8338       * The search index has been reduced in size by a great amount.
8339       * Cross-crate documentation via `pub use` has been greatly improved.
8340       * Primitive types are now hyperlinked and documented.
8341     * Documentation has been moved from static.rust-lang.org/doc to
8342       doc.rust-lang.org
8343     * A new sandbox, play.rust-lang.org, is available for running and
8344       sharing rust code examples on-line.
8345     * Unused attributes are now more robustly warned about.
8346     * The dead_code lint now warns about unused struct fields.
8347     * Cross-compiling to iOS is now supported.
8348     * Cross-compiling to mipsel is now supported.
8349     * Stability attributes are now inherited by default and no longer apply
8350       to intra-crate usage, only inter-crate usage.
8351     * Error message related to non-exhaustive match expressions have been
8352       greatly improved.
8353
8354
8355 Version 0.10 (2014-04-03)
8356 =========================
8357
8358   * ~1500 changes, numerous bugfixes
8359
8360   * Language
8361     * A new RFC process is now in place for modifying the language.
8362     * Patterns with `@`-pointers have been removed from the language.
8363     * Patterns with unique vectors (`~[T]`) have been removed from the
8364       language.
8365     * Patterns with unique strings (`~str`) have been removed from the
8366       language.
8367     * `@str` has been removed from the language.
8368     * `@[T]` has been removed from the language.
8369     * `@self` has been removed from the language.
8370     * `@Trait` has been removed from the language.
8371     * Headers on `~` allocations which contain `@` boxes inside the type for
8372       reference counting have been removed.
8373     * The semantics around the lifetimes of temporary expressions have changed,
8374       see #3511 and #11585 for more information.
8375     * Cross-crate syntax extensions are now possible, but feature gated. See
8376       #11151 for more information. This includes both `macro_rules!` macros as
8377       well as syntax extensions such as `format!`.
8378     * New lint modes have been added, and older ones have been turned on to be
8379       warn-by-default.
8380       * Unnecessary parentheses
8381       * Uppercase statics
8382       * Camel Case types
8383       * Uppercase variables
8384       * Publicly visible private types
8385       * `#[deriving]` with raw pointers
8386     * Unsafe functions can no longer be coerced to closures.
8387     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8388     * The `#[simd]` attribute is now behind a feature gate.
8389     * Visibility is no longer allowed on `extern crate` statements, and
8390       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8391     * Trailing commas are now allowed in argument lists and tuple patterns.
8392     * The `do` keyword has been removed, it is now a reserved keyword.
8393     * Default type parameters have been implemented, but are feature gated.
8394     * Borrowed variables through captures in closures are now considered soundly.
8395     * `extern mod` is now `extern crate`
8396     * The `Freeze` trait has been removed.
8397     * The `Share` trait has been added for types that can be shared among
8398       threads.
8399     * Labels in macros are now hygienic.
8400     * Expression/statement macro invocations can be delimited with `{}` now.
8401     * Treatment of types allowed in `static mut` locations has been tweaked.
8402     * The `*` and `.` operators are now overloadable through the `Deref` and
8403       `DerefMut` traits.
8404     * `~Trait` and `proc` no longer have `Send` bounds by default.
8405     * Partial type hints are now supported with the `_` type marker.
8406     * An `Unsafe` type was introduced for interior mutability. It is now
8407       considered undefined to transmute from `&T` to `&mut T` without using the
8408       `Unsafe` type.
8409     * The #[linkage] attribute was implemented for extern statics/functions.
8410     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8411     * `Pod` was renamed to `Copy`.
8412
8413   * Libraries
8414     * The `libextra` library has been removed. It has now been decomposed into
8415       component libraries with smaller and more focused nuggets of
8416       functionality. The full list of libraries can be found on the
8417       documentation index page.
8418     * std: `std::condition` has been removed. All I/O errors are now propagated
8419       through the `Result` type. In order to assist with error handling, a
8420       `try!` macro for unwrapping errors with an early return and a lint for
8421       unused results has been added. See #12039 for more information.
8422     * std: The `vec` module has been renamed to `slice`.
8423     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8424       This will become the only growable vector in the future.
8425     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8426       are now found at `std::io::BufferedReader` instead of
8427       `std::io::buffered::BufferedReader`.
8428     * std: `print` and `println` are no longer in the prelude, the `print!` and
8429       `println!` macros are intended to be used instead.
8430     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8431       attempts to statically prevent cycles.
8432     * std: The standard distribution is adopting the policy of pushing failure
8433       to the user rather than failing in libraries. Many functions (such as
8434       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8435     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8436       deriving mode: `#[deriving(Show)]`.
8437     * std: `ToStr` is now implemented for all types implementing `Show`.
8438     * std: The formatting trait methods now take `&self` instead of `&T`
8439     * std: The `invert()` method on iterators has been renamed to `rev()`
8440     * std: `std::num` has seen a reduction in the genericity of its traits,
8441       consolidating functionality into a few core traits.
8442     * std: Backtraces are now printed on task failure if the environment
8443       variable `RUST_BACKTRACE` is present.
8444     * std: Naming conventions for iterators have been standardized. More details
8445       can be found on the wiki's style guide.
8446     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8447       still implement the function.
8448     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8449     * std: `assert_approx_eq!` has been removed
8450     * std: The `e` and `E` formatting specifiers for floats have been added to
8451       print them in exponential notation.
8452     * std: The `Times` trait has been removed
8453     * std: Indications of variance and opting out of builtin bounds is done
8454       through marker types in `std::kinds::marker` now
8455     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8456       `#[deriving(Hash)]` is now possible.
8457     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8458     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8459     * std: `Chan::new` is now `channel()`.
8460     * std: A new synchronous channel type has been implemented.
8461     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8462     * std: `hashmap` and `trie` have been moved to `libcollections`
8463     * std: `run` has been rolled into `io::process`
8464     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8465     * std: The equality and comparison traits have seen some reorganization.
8466     * std: `rand` has moved to `librand`.
8467     * std: `to_{lower,upper}case` has been implemented for `char`.
8468     * std: Logging has been moved to `liblog`.
8469     * collections: `HashMap` has been rewritten for higher performance and less
8470       memory usage.
8471     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8472       it can be booted manually. The runtime guide has more information and
8473       examples.
8474     * native: All I/O functionality except signals has been implemented.
8475     * green: Task spawning with `libgreen` has been optimized with stack caching
8476       and various trimming of code.
8477     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8478     * sync: The `extra::sync` module has been updated to modern rust (and moved
8479       to the `sync` library), tweaking and improving various interfaces while
8480       dropping redundant functionality.
8481     * sync: A new `Barrier` type has been added to the `sync` library.
8482     * sync: An efficient mutex for native and green tasks has been implemented.
8483     * serialize: The `base64` module has seen some improvement. It treats
8484       newlines better, has non-string error values, and has seen general
8485       cleanup.
8486     * fourcc: A `fourcc!` macro was introduced
8487     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8488       hexadecimal literal.
8489
8490   * Tooling
8491     * `rustpkg` has been deprecated and removed from the main repository. Its
8492       replacement, `cargo`, is under development.
8493     * Nightly builds of rust are now available
8494     * The memory usage of rustc has been improved many times throughout this
8495       release cycle.
8496     * The build process supports disabling rpath support for the rustc binary
8497       itself.
8498     * Code generation has improved in some cases, giving more information to the
8499       LLVM optimization passes to enable more extensive optimizations.
8500     * Debuginfo compatibility with lldb on OSX has been restored.
8501     * The master branch is now gated on an android bot, making building for
8502       android much more reliable.
8503     * Output flags have been centralized into one `--emit` flag.
8504     * Crate type flags have been centralized into one `--crate-type` flag.
8505     * Codegen flags have been consolidated behind a `-C` flag.
8506     * Linking against outdated crates now has improved error messages.
8507     * Error messages with lifetimes will often suggest how to annotate the
8508       function to fix the error.
8509     * Many more types are documented in the standard library, and new guides
8510       were written.
8511     * Many `rustdoc` improvements:
8512       * code blocks are syntax highlighted.
8513       * render standalone markdown files.
8514       * the --test flag tests all code blocks by default.
8515       * exported macros are displayed.
8516       * re-exported types have their documentation inlined at the location of the
8517         first re-export.
8518       * search works across crates that have been rendered to the same output
8519         directory.
8520
8521
8522 Version 0.9 (2014-01-09)
8523 ==========================
8524
8525    * ~1800 changes, numerous bugfixes
8526
8527    * Language
8528       * The `float` type has been removed. Use `f32` or `f64` instead.
8529       * A new facility for enabling experimental features (feature gating) has
8530         been added, using the crate-level `#[feature(foo)]` attribute.
8531       * Managed boxes (@) are now behind a feature gate
8532         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8533         standard library's `Gc` or `Rc` types instead.
8534       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8535       * Jumping back to the top of a loop is now done with `continue` instead of
8536         `loop`.
8537       * Strings can no longer be mutated through index assignment.
8538       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8539         hash delimiters, as in `r###"foo"###`.
8540       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8541         called once.
8542       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8543       * `@fn`s have been removed.
8544       * `do` only works with procs in order to make it obvious what the cost
8545         of `do` is.
8546       * Single-element tuple-like structs can no longer be dereferenced to
8547         obtain the inner value. A more comprehensive solution for overloading
8548         the dereference operator will be provided in the future.
8549       * The `#[link(...)]` attribute has been replaced with
8550         `#[crate_id = "name#vers"]`.
8551       * Empty `impl`s must be terminated with empty braces and may not be
8552         terminated with a semicolon.
8553       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8554         no longer has any special meaning.
8555       * The old `fmt!` string formatting macro has been removed.
8556       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8557         `print!` and `println!`.
8558       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8559       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8560         `extern mod foo = "bar"` instead.
8561       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8562       * Macros can have attributes.
8563       * Macros can expand to items with attributes.
8564       * Macros can expand to multiple items.
8565       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8566       * Comments may be nested.
8567       * Values automatically coerce to trait objects they implement, without
8568         an explicit `as`.
8569       * Enum discriminants are no longer an entire word but as small as needed to
8570         contain all the variants. The `repr` attribute can be used to override
8571         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8572         `#[repr(C)]` to match C enums.
8573       * Non-string literals are not allowed in attributes (they never worked).
8574       * The FFI now supports variadic functions.
8575       * Octal numeric literals, as in `0o7777`.
8576       * The `concat!` syntax extension performs compile-time string concatenation.
8577       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8578         removed as Rust no longer uses segmented stacks.
8579       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8580       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8581         not `*`; ignoring remaining fields of a struct is also done with `..`,
8582         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8583       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8584       * `rustc` supports the "system" calling convention, which defaults to the
8585         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8586         "C" elsewhere.
8587       * The `type_overflow` lint (default: warn) checks literals for overflow.
8588       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8589       * The `attribute_usage` lint (default: warn) warns about unknown
8590         attributes.
8591       * The `unknown_features` lint (default: warn) warns about unknown
8592         feature gates.
8593       * The `dead_code` lint (default: warn) checks for dead code.
8594       * Rust libraries can be linked statically to one another
8595       * `#[link_args]` is behind the `link_args` feature gate.
8596       * Native libraries are now linked with `#[link(name = "foo")]`
8597       * Native libraries can be statically linked to a rust crate
8598         (`#[link(name = "foo", kind = "static")]`).
8599       * Native OS X frameworks are now officially supported
8600         (`#[link(name = "foo", kind = "framework")]`).
8601       * The `#[thread_local]` attribute creates thread-local (not task-local)
8602         variables. Currently behind the `thread_local` feature gate.
8603       * The `return` keyword may be used in closures.
8604       * Types that can be copied via a memcpy implement the `Pod` kind.
8605       * The `cfg` attribute can now be used on struct fields and enum variants.
8606
8607    * Libraries
8608       * std: The `option` and `result` API's have been overhauled to make them
8609         simpler, more consistent, and more composable.
8610       * std: The entire `std::io` module has been replaced with one that is
8611         more comprehensive and that properly interfaces with the underlying
8612         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8613         implemented.
8614       * std: `io::util` contains a number of useful implementations of
8615         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8616         `ZeroReader`, `TeeReader`.
8617       * std: The reference counted pointer type `extra::rc` moved into std.
8618       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8619         just a wrapper around it).
8620       * std: The `Either` type has been removed.
8621       * std: `fmt::Default` can be implemented for any type to provide default
8622         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8623       * std: The `rand` API continues to be tweaked.
8624       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8625         on failure in gdb, is now named `rust_fail`.
8626       * std: The `each_key` and `each_value` methods on `HashMap` have been
8627         replaced by the `keys` and `values` iterators.
8628       * std: Functions dealing with type size and alignment have moved from the
8629         `sys` module to the `mem` module.
8630       * std: The `path` module was written and API changed.
8631       * std: `str::from_utf8` has been changed to cast instead of allocate.
8632       * std: `starts_with` and `ends_with` methods added to vectors via the
8633         `ImmutableEqVector` trait, which is in the prelude.
8634       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8635         if the index is out of bounds.
8636       * std: Task failure no longer propagates between tasks, as the model was
8637         complex, expensive, and incompatible with thread-based tasks.
8638       * std: The `Any` type can be used for dynamic typing.
8639       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8640         `task::try`.
8641       * std: Methods that produce iterators generally do not have an `_iter`
8642         suffix now.
8643       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8644         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8645       * std: `util::ignore` renamed to `prelude::drop`.
8646       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8647         trait.
8648       * std: `vec::raw` has seen a lot of cleanup and API changes.
8649       * std: The standard library no longer includes any C++ code, and very
8650         minimal C, eliminating the dependency on libstdc++.
8651       * std: Runtime scheduling and I/O functionality has been factored out into
8652         extensible interfaces and is now implemented by two different crates:
8653         libnative, for native threading and I/O; and libgreen, for green threading
8654         and I/O. This paves the way for using the standard library in more limited
8655         embedded environments.
8656       * std: The `comm` module has been rewritten to be much faster, have a
8657         simpler, more consistent API, and to work for both native and green
8658         threading.
8659       * std: All libuv dependencies have been moved into the rustuv crate.
8660       * native: New implementations of runtime scheduling on top of OS threads.
8661       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8662         and other I/O.
8663       * green: The green thread scheduler and message passing types are almost
8664         entirely lock-free.
8665       * extra: The `flatpipes` module had bitrotted and was removed.
8666       * extra: All crypto functions have been removed and Rust now has a policy of
8667         not reimplementing crypto in the standard library. In the future crypto
8668         will be provided by external crates with bindings to established libraries.
8669       * extra: `c_vec` has been modernized.
8670       * extra: The `sort` module has been removed. Use the `sort` method on
8671         mutable slices.
8672
8673    * Tooling
8674       * The `rust` and `rusti` commands have been removed, due to lack of
8675         maintenance.
8676       * `rustdoc` was completely rewritten.
8677       * `rustdoc` can test code examples in documentation.
8678       * `rustpkg` can test packages with the argument, 'test'.
8679       * `rustpkg` supports arbitrary dependencies, including C libraries.
8680       * `rustc`'s support for generating debug info is improved again.
8681       * `rustc` has better error reporting for unbalanced delimiters.
8682       * `rustc`'s JIT support was removed due to bitrot.
8683       * Executables and static libraries can be built with LTO (-Z lto)
8684       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8685         build tools.
8686
8687
8688 Version 0.8 (2013-09-26)
8689 ============================
8690
8691    * ~2200 changes, numerous bugfixes
8692
8693    * Language
8694       * The `for` loop syntax has changed to work with the `Iterator` trait.
8695       * At long last, unwinding works on Windows.
8696       * Default methods are ready for use.
8697       * Many trait inheritance bugs fixed.
8698       * Owned and borrowed trait objects work more reliably.
8699       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8700       * rustc can omit emission of code for the `debug!` macro if it is passed
8701         `--cfg ndebug`
8702       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8703         for foo.rs, then foo/mod.rs, and will generate an error when both are
8704         present.
8705       * Strings no longer contain trailing nulls. The new `std::c_str` module
8706         provides new mechanisms for converting to C strings.
8707       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8708       * The FFI has been overhauled such that foreign functions are called directly,
8709         instead of through a stack-switching wrapper.
8710       * Calling a foreign function must be done through a Rust function with the
8711         `#[fixed_stack_segment]` attribute.
8712       * The `externfn!` macro can be used to declare both a foreign function and
8713         a `#[fixed_stack_segment]` wrapper at once.
8714       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8715       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8716       * `priv` is disallowed everywhere except for struct fields and enum variants.
8717       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8718       * `ref` bindings in irrefutable patterns work correctly now.
8719       * `char` is now prevented from containing invalid code points.
8720       * Casting to `bool` is no longer allowed.
8721       * `\0` is now accepted as an escape in chars and strings.
8722       * `yield` is a reserved keyword.
8723       * `typeof` is a reserved keyword.
8724       * Crates may be imported by URL with `extern mod foo = "url";`.
8725       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8726       * Static vectors can be initialized with repeating elements,
8727         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8728       * Static structs can be initialized with functional record update,
8729         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8730       * `cfg!` can be used to conditionally execute code based on the crate
8731         configuration, similarly to `#[cfg(...)]`.
8732       * The `unnecessary_qualification` lint detects unneeded module
8733         prefixes (default: allow).
8734       * Arithmetic operations have been implemented on the SIMD types in
8735         `std::unstable::simd`.
8736       * Exchange allocation headers were removed, reducing memory usage.
8737       * `format!` implements a completely new, extensible, and higher-performance
8738         string formatting system. It will replace `fmt!`.
8739       * `print!` and `println!` write formatted strings (using the `format!`
8740         extension) to stdout.
8741       * `write!` and `writeln!` write formatted strings (using the `format!`
8742         extension) to the new Writers in `std::rt::io`.
8743       * The library section in which a function or static is placed may
8744         be specified with `#[link_section = "..."]`.
8745       * The `proto!` syntax extension for defining bounded message protocols
8746         was removed.
8747       * `macro_rules!` is hygienic for `let` declarations.
8748       * The `#[export_name]` attribute specifies the name of a symbol.
8749       * `unreachable!` can be used to indicate unreachable code, and fails
8750         if executed.
8751
8752    * Libraries
8753       * std: Transitioned to the new runtime, written in Rust.
8754       * std: Added an experimental I/O library, `rt::io`, based on the new
8755         runtime.
8756       * std: A new generic `range` function was added to the prelude, replacing
8757         `uint::range` and friends.
8758       * std: `range_rev` no longer exists. Since range is an iterator it can be
8759         reversed with `range(lo, hi).invert()`.
8760       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8761         renamed to `unwrap_or`.
8762       * std: The `iterator` module was renamed to `iter`.
8763       * std: Integral types now support the `checked_add`, `checked_sub`, and
8764         `checked_mul` operations for detecting overflow.
8765       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8766         consistency.
8767       * std: Methods are standardizing on conventions for casting methods:
8768         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8769         and cheap casts.
8770       * std: The `CString` type in `c_str` provides new ways to convert to and
8771         from C strings.
8772       * std: `DoubleEndedIterator` can yield elements in two directions.
8773       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8774         two splices.
8775       * std: `str::from_bytes` renamed to `str::from_utf8`.
8776       * std: `pop_opt` and `shift_opt` methods added to vectors.
8777       * std: The task-local data interface no longer uses @, and keys are
8778         no longer function pointers.
8779       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8780       * std: Added `SharedPort` to `comm`.
8781       * std: `Eq` has a default method for `ne`; only `eq` is required
8782         in implementations.
8783       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8784         is required in implementations.
8785       * std: `is_utf8` performance is improved, impacting many string functions.
8786       * std: `os::MemoryMap` provides cross-platform mmap.
8787       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8788         are not 'in-bounds' are considered undefined.
8789       * std: Many freestanding functions in `vec` removed in favor of methods.
8790       * std: Many freestanding functions on scalar types removed in favor of
8791         methods.
8792       * std: Many options to task builders were removed since they don't make
8793         sense in the new scheduler design.
8794       * std: More containers implement `FromIterator` so can be created by the
8795         `collect` method.
8796       * std: More complete atomic types in `unstable::atomics`.
8797       * std: `comm::PortSet` removed.
8798       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8799         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8800         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8801         default implementations.
8802       * std: Various `from_str` functions were removed in favor of a generic
8803         `from_str` which is available in the prelude.
8804       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8805       * extra: `dlist`, the doubly-linked list was modernized.
8806       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8807       * extra: Added `glob` module, replacing `std::os::glob`.
8808       * extra: `rope` was removed.
8809       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8810       * extra: `net`, and `timer` were removed. The experimental replacements
8811         are `std::rt::io::net` and `std::rt::io::timer`.
8812       * extra: Iterators implemented for `SmallIntMap`.
8813       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8814       * extra: `SmallIntSet` removed. Use `BitvSet`.
8815       * extra: Performance of JSON parsing greatly improved.
8816       * extra: `semver` updated to SemVer 2.0.0.
8817       * extra: `term` handles more terminals correctly.
8818       * extra: `dbg` module removed.
8819       * extra: `par` module removed.
8820       * extra: `future` was cleaned up, with some method renames.
8821       * extra: Most free functions in `getopts` were converted to methods.
8822
8823    * Other
8824       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8825       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8826         similarly to gcc's `--march` flag.
8827       * rustc's performance compiling small crates is much better.
8828       * rustpkg has received many improvements.
8829       * rustpkg supports git tags as package IDs.
8830       * rustpkg builds into target-specific directories so it can be used for
8831         cross-compiling.
8832       * The number of concurrent test tasks is controlled by the environment
8833         variable RUST_TEST_TASKS.
8834       * The test harness can now report metrics for benchmarks.
8835       * All tools have man pages.
8836       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8837       * The runtime uses jemalloc for allocations.
8838       * Segmented stacks are temporarily disabled as part of the transition to
8839         the new runtime. Stack overflows are possible!
8840       * A new documentation backend, rustdoc_ng, is available for use. It is
8841         still invoked through the normal `rustdoc` command.
8842
8843
8844 Version 0.7 (2013-07-03)
8845 =======================
8846
8847    * ~2000 changes, numerous bugfixes
8848
8849    * Language
8850       * `impl`s no longer accept a visibility qualifier. Put them on methods
8851         instead.
8852       * The borrow checker has been rewritten with flow-sensitivity, fixing
8853         many bugs and inconveniences.
8854       * The `self` parameter no longer implicitly means `&'self self`,
8855         and can be explicitly marked with a lifetime.
8856       * Overloadable compound operators (`+=`, etc.) have been temporarily
8857         removed due to bugs.
8858       * The `for` loop protocol now requires `for`-iterators to return `bool`
8859         so they compose better.
8860       * The `Durable` trait is replaced with the `'static` bounds.
8861       * Trait default methods work more often.
8862       * Structs with the `#[packed]` attribute have byte alignment and
8863         no padding between fields.
8864       * Type parameters bound by `Copy` must now be copied explicitly with
8865         the `copy` keyword.
8866       * It is now illegal to move out of a dereferenced unsafe pointer.
8867       * `Option<~T>` is now represented as a nullable pointer.
8868       * `@mut` does dynamic borrow checks correctly.
8869       * The `main` function is only detected at the topmost level of the crate.
8870         The `#[main]` attribute is still valid anywhere.
8871       * Struct fields may no longer be mutable. Use inherited mutability.
8872       * The `#[no_send]` attribute makes a type that would otherwise be
8873         `Send`, not.
8874       * The `#[no_freeze]` attribute makes a type that would otherwise be
8875         `Freeze`, not.
8876       * Unbounded recursion will abort the process after reaching the limit
8877         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8878       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8879         are never implicitly copyable.
8880       * `#[static_assert]` makes compile-time assertions about static bools.
8881       * At long last, 'argument modes' no longer exist.
8882       * The rarely used `use mod` statement no longer exists.
8883
8884    * Syntax extensions
8885       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8886         argument list.
8887       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8888         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8889         `#[deriving(...)]`.
8890       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8891         and unsuffixed integer literals.
8892
8893    * Libraries
8894       * The `core` crate was renamed to `std`.
8895       * The `std` crate was renamed to `extra`.
8896       * More and improved documentation.
8897       * std: `iterator` module for external iterator objects.
8898       * Many old-style (internal, higher-order function) iterators replaced by
8899         implementations of `Iterator`.
8900       * std: Many old internal vector and string iterators,
8901         incl. `any`, `all`. removed.
8902       * std: The `finalize` method of `Drop` renamed to `drop`.
8903       * std: The `drop` method now takes `&mut self` instead of `&self`.
8904       * std: The prelude no longer re-exports any modules, only types and traits.
8905       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8906         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8907       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8908         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8909       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8910         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8911       * std: Many types implement `Clone`.
8912       * std: `path` type renamed to `Path`.
8913       * std: `mut` module and `Mut` type removed.
8914       * std: Many standalone functions removed in favor of methods and iterators
8915         in `vec`, `str`. In the future methods will also work as functions.
8916       * std: `reinterpret_cast` removed. Use `transmute`.
8917       * std: ascii string handling in `std::ascii`.
8918       * std: `Rand` is implemented for ~/@.
8919       * std: `run` module for spawning processes overhauled.
8920       * std: Various atomic types added to `unstable::atomic`.
8921       * std: Various types implement `Zero`.
8922       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8923       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8924       * std: Added `os::mkdir_recursive`.
8925       * std: Added `os::glob` function performs filesystems globs.
8926       * std: `FuzzyEq` renamed to `ApproxEq`.
8927       * std: `Map` now defines `pop` and `swap` methods.
8928       * std: `Cell` constructors converted to static methods.
8929       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8930       * extra: `flate` module moved from `std` to `extra`.
8931       * extra: `fileinput` module for iterating over a series of files.
8932       * extra: `Complex` number type and `complex` module.
8933       * extra: `Rational` number type and `rational` module.
8934       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8935       * extra: `term` uses terminfo now, is more correct.
8936       * extra: `arc` functions converted to methods.
8937       * extra: Implementation of fixed output size variations of SHA-2.
8938
8939    * Tooling
8940       * `unused_variables` lint mode for unused variables (default: warn).
8941       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8942         (default: warn).
8943       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8944         (default: warn).
8945       * `dead_assignment` lint mode for unread variables (default: warn).
8946       * `unnecessary_allocation` lint mode detects some heap allocations that are
8947         immediately borrowed so could be written without allocating (default: warn).
8948       * `missing_doc` lint mode (default: allow).
8949       * `unreachable_code` lint mode (default: warn).
8950       * The `rusti` command has been rewritten and a number of bugs addressed.
8951       * rustc outputs in color on more terminals.
8952       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8953       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8954       * Compiling with `-g` will make the binary record information about
8955         dynamic borrowcheck failures for debugging.
8956       * rustdoc has a nicer stylesheet.
8957       * Various improvements to rustdoc.
8958       * Improvements to rustpkg (see the detailed release notes).
8959
8960
8961 Version 0.6 (2013-04-03)
8962 ========================
8963
8964    * ~2100 changes, numerous bugfixes
8965
8966    * Syntax changes
8967       * The self type parameter in traits is now spelled `Self`
8968       * The `self` parameter in trait and impl methods must now be explicitly
8969         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8970       * Static methods no longer require the `static` keyword and instead
8971         are distinguished by the lack of a `self` parameter
8972       * Replaced the `Durable` trait with the `'static` lifetime
8973       * The old closure type syntax with the trailing sigil has been
8974         removed in favor of the more consistent leading sigil
8975       * `super` is a keyword, and may be prefixed to paths
8976       * Trait bounds are separated with `+` instead of whitespace
8977       * Traits are implemented with `impl Trait for Type`
8978         instead of `impl Type: Trait`
8979       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8980       * The `export` keyword has finally been removed
8981       * The `move` keyword has been removed (see "Semantic changes")
8982       * The interior mutability qualifier on vectors, `[mut T]`, has been
8983         removed. Use `&mut [T]`, etc.
8984       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8985       * `fail` is no longer a keyword. Use `fail!()`
8986       * `assert` is no longer a keyword. Use `assert!()`
8987       * `log` is no longer a keyword. use `debug!`, etc.
8988       * 1-tuples may be represented as `(T,)`
8989       * Struct fields may no longer be `mut`. Use inherited mutability,
8990         `@mut T`, `core::mut` or `core::cell`
8991       * `extern mod { ... }` is no longer valid syntax for foreign
8992         function modules. Use extern blocks: `extern { ... }`
8993       * Newtype enums removed. Use tuple-structs.
8994       * Trait implementations no longer support visibility modifiers
8995       * Pattern matching over vectors improved and expanded
8996       * `const` renamed to `static` to correspond to lifetime name,
8997         and make room for future `static mut` unsafe mutable globals.
8998       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8999       * `Clone` implementations can be automatically generated with
9000         `#[deriving(Clone)]`
9001       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9002         instead of `foo as Bar`.
9003       * Fixed length vector types are now written as `[int, .. 3]`
9004         instead of `[int * 3]`.
9005       * Fixed length vector types can express the length as a constant
9006         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9007
9008    * Semantic changes
9009       * Types with owned pointers or custom destructors move by default,
9010         eliminating the `move` keyword
9011       * All foreign functions are considered unsafe
9012       * &mut is now unaliasable
9013       * Writes to borrowed @mut pointers are prevented dynamically
9014       * () has size 0
9015       * The name of the main function can be customized using #[main]
9016       * The default type of an inferred closure is &fn instead of @fn
9017       * `use` statements may no longer be "chained" - they cannot import
9018         identifiers imported by previous `use` statements
9019       * `use` statements are crate relative, importing from the "top"
9020         of the crate by default. Paths may be prefixed with `super::`
9021         or `self::` to change the search behavior.
9022       * Method visibility is inherited from the implementation declaration
9023       * Structural records have been removed
9024       * Many more types can be used in static items, including enums
9025         'static-lifetime pointers and vectors
9026       * Pattern matching over vectors improved and expanded
9027       * Typechecking of closure types has been overhauled to
9028         improve inference and eliminate unsoundness
9029       * Macros leave scope at the end of modules, unless that module is
9030         tagged with #[macro_escape]
9031
9032    * Libraries
9033       * Added big integers to `std::bigint`
9034       * Removed `core::oldcomm` module
9035       * Added pipe-based `core::comm` module
9036       * Numeric traits have been reorganized under `core::num`
9037       * `vec::slice` finally returns a slice
9038       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
9039       * Containers reorganized around traits in `core::container`
9040       * `core::dvec` removed, `~[T]` is a drop-in replacement
9041       * `core::send_map` renamed to `core::hashmap`
9042       * `std::map` removed; replaced with `core::hashmap`
9043       * `std::treemap` reimplemented as an owned balanced tree
9044       * `std::deque` and `std::smallintmap` reimplemented as owned containers
9045       * `core::trie` added as a fast ordered map for integer keys
9046       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
9047       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
9048         overload the comparison operators, whereas `TotalOrd` is used
9049         by certain container types
9050
9051    * Other
9052       * Replaced the 'cargo' package manager with 'rustpkg'
9053       * Added all-purpose 'rust' tool
9054       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
9055       * rustc now *attempts* to offer spelling suggestions
9056       * Improved support for ARM and Android
9057       * Preliminary MIPS backend
9058       * Improved foreign function ABI implementation for x86, x86_64
9059       * Various memory usage improvements
9060       * Rust code may be embedded in foreign code under limited circumstances
9061       * Inline assembler supported by new asm!() syntax extension.
9062
9063
9064 Version 0.5 (2012-12-21)
9065 ===========================
9066
9067    * ~900 changes, numerous bugfixes
9068
9069    * Syntax changes
9070       * Removed `<-` move operator
9071       * Completed the transition from the `#fmt` extension syntax to `fmt!`
9072       * Removed old fixed length vector syntax - `[T]/N`
9073       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
9074       * Macros may now expand to items and statements
9075       * `a.b()` is always parsed as a method call, never as a field projection
9076       * `Eq` and `IterBytes` implementations can be automatically generated
9077         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
9078       * Removed the special crate language for `.rc` files
9079       * Function arguments may consist of any irrefutable pattern
9080
9081    * Semantic changes
9082       * `&` and `~` pointers may point to objects
9083       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
9084       * Enum variants may be structs
9085       * Destructors can be added to all nominal types with the Drop trait
9086       * Structs and nullary enum variants may be constants
9087       * Values that cannot be implicitly copied are now automatically moved
9088         without writing `move` explicitly
9089       * `&T` may now be coerced to `*T`
9090       * Coercions happen in `let` statements as well as function calls
9091       * `use` statements now take crate-relative paths
9092       * The module and type namespaces have been merged so that static
9093         method names can be resolved under the trait in which they are
9094         declared
9095
9096    * Improved support for language features
9097       * Trait inheritance works in many scenarios
9098       * More support for explicit self arguments in methods - `self`, `&self`
9099         `@self`, and `~self` all generally work as expected
9100       * Static methods work in more situations
9101       * Experimental: Traits may declare default methods for the implementations
9102         to use
9103
9104    * Libraries
9105       * New condition handling system in `core::condition`
9106       * Timsort added to `std::sort`
9107       * New priority queue, `std::priority_queue`
9108       * Pipes for serializable types, `std::flatpipes'
9109       * Serialization overhauled to be trait-based
9110       * Expanded `getopts` definitions
9111       * Moved futures to `std`
9112       * More functions are pure now
9113       * `core::comm` renamed to `oldcomm`. Still deprecated
9114       * `rustdoc` and `cargo` are libraries now
9115
9116    * Misc
9117       * Added a preliminary REPL, `rusti`
9118       * License changed from MIT to dual MIT/APL2
9119
9120
9121 Version 0.4 (2012-10-15)
9122 ==========================
9123
9124    * ~2000 changes, numerous bugfixes
9125
9126    * Syntax
9127       * All keywords are now strict and may not be used as identifiers anywhere
9128       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
9129         'of', 'with', 'to', 'class'.
9130       * Classes are replaced with simpler structs
9131       * Explicit method self types
9132       * `ret` became `return` and `alt` became `match`
9133       * `import` is now `use`; `use is now `extern mod`
9134       * `extern mod { ... }` is now `extern { ... }`
9135       * `use mod` is the recommended way to import modules
9136       * `pub` and `priv` replace deprecated export lists
9137       * The syntax of `match` pattern arms now uses fat arrow (=>)
9138       * `main` no longer accepts an args vector; use `os::args` instead
9139
9140    * Semantics
9141       * Trait implementations are now coherent, ala Haskell typeclasses
9142       * Trait methods may be static
9143       * Argument modes are deprecated
9144       * Borrowed pointers are much more mature and recommended for use
9145       * Strings and vectors in the static region are stored in constant memory
9146       * Typestate was removed
9147       * Resolution rewritten to be more reliable
9148       * Support for 'dual-mode' data structures (freezing and thawing)
9149
9150    * Libraries
9151       * Most binary operators can now be overloaded via the traits in
9152         `core::ops'
9153       * `std::net::url` for representing URLs
9154       * Sendable hash maps in `core::send_map`
9155       * `core::task' gained a (currently unsafe) task-local storage API
9156
9157    * Concurrency
9158       * An efficient new intertask communication primitive called the pipe,
9159         along with a number of higher-level channel types, in `core::pipes`
9160       * `std::arc`, an atomically reference counted, immutable, shared memory
9161         type
9162       * `std::sync`, various exotic synchronization tools based on arcs and pipes
9163       * Futures are now based on pipes and sendable
9164       * More robust linked task failure
9165       * Improved task builder API
9166
9167    * Other
9168       * Improved error reporting
9169       * Preliminary JIT support
9170       * Preliminary work on precise GC
9171       * Extensive architectural improvements to rustc
9172       * Begun a transition away from buggy C++-based reflection (shape) code to
9173         Rust-based (visitor) code
9174       * All hash functions and tables converted to secure, randomized SipHash
9175
9176
9177 Version 0.3  (2012-07-12)
9178 ========================
9179
9180    * ~1900 changes, numerous bugfixes
9181
9182    * New coding conveniences
9183       * Integer-literal suffix inference
9184       * Per-item control over warnings, errors
9185       * #[cfg(windows)] and #[cfg(unix)] attributes
9186       * Documentation comments
9187       * More compact closure syntax
9188       * 'do' expressions for treating higher-order functions as
9189         control structures
9190       * *-patterns (wildcard extended to all constructor fields)
9191
9192    * Semantic cleanup
9193       * Name resolution pass and exhaustiveness checker rewritten
9194       * Region pointers and borrow checking supersede alias
9195         analysis
9196       * Init-ness checking is now provided by a region-based liveness
9197         pass instead of the typestate pass; same for last-use analysis
9198       * Extensive work on region pointers
9199
9200    * Experimental new language features
9201       * Slices and fixed-size, interior-allocated vectors
9202       * #!-comments for lang versioning, shell execution
9203       * Destructors and iface implementation for classes;
9204         type-parameterized classes and class methods
9205       * 'const' type kind for types that can be used to implement
9206         shared-memory concurrency patterns
9207
9208    * Type reflection
9209
9210    * Removal of various obsolete features
9211       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
9212                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
9213
9214       * Constructs: do-while loops ('do' repurposed), fn binding,
9215                     resources (replaced by destructors)
9216
9217    * Compiler reorganization
9218       * Syntax-layer of compiler split into separate crate
9219       * Clang (from LLVM project) integrated into build
9220       * Typechecker split into sub-modules
9221
9222    * New library code
9223       * New time functions
9224       * Extension methods for many built-in types
9225       * Arc: atomic-refcount read-only / exclusive-use shared cells
9226       * Par: parallel map and search routines
9227       * Extensive work on libuv interface
9228       * Much vector code moved to libraries
9229       * Syntax extensions: #line, #col, #file, #mod, #stringify,
9230         #include, #include_str, #include_bin
9231
9232    * Tool improvements
9233       * Cargo automatically resolves dependencies
9234
9235
9236 Version 0.2  (2012-03-29)
9237 =========================
9238
9239    * >1500 changes, numerous bugfixes
9240
9241    * New docs and doc tooling
9242
9243    * New port: FreeBSD x86_64
9244
9245    * Compilation model enhancements
9246       * Generics now specialized, multiply instantiated
9247       * Functions now inlined across separate crates
9248
9249    * Scheduling, stack and threading fixes
9250       * Noticeably improved message-passing performance
9251       * Explicit schedulers
9252       * Callbacks from C
9253       * Helgrind clean
9254
9255    * Experimental new language features
9256       * Operator overloading
9257       * Region pointers
9258       * Classes
9259
9260    * Various language extensions
9261       * C-callback function types: 'crust fn ...'
9262       * Infinite-loop construct: 'loop { ... }'
9263       * Shorten 'mutable' to 'mut'
9264       * Required mutable-local qualifier: 'let mut ...'
9265       * Basic glob-exporting: 'export foo::*;'
9266       * Alt now exhaustive, 'alt check' for runtime-checked
9267       * Block-function form of 'for' loop, with 'break' and 'ret'.
9268
9269    * New library code
9270       * AST quasi-quote syntax extension
9271       * Revived libuv interface
9272       * New modules: core::{future, iter}, std::arena
9273       * Merged per-platform std::{os*, fs*} to core::{libc, os}
9274       * Extensive cleanup, regularization in libstd, libcore
9275
9276
9277 Version 0.1  (2012-01-20)
9278 ===============================
9279
9280    * Most language features work, including:
9281       * Unique pointers, unique closures, move semantics
9282       * Interface-constrained generics
9283       * Static interface dispatch
9284       * Stack growth
9285       * Multithread task scheduling
9286       * Typestate predicates
9287       * Failure unwinding, destructors
9288       * Pattern matching and destructuring assignment
9289       * Lightweight block-lambda syntax
9290       * Preliminary macro-by-example
9291
9292    * Compiler works with the following configurations:
9293       * Linux: x86 and x86_64 hosts and targets
9294       * macOS: x86 and x86_64 hosts and targets
9295       * Windows: x86 hosts and targets
9296
9297    * Cross compilation / multi-target configuration supported.
9298
9299    * Preliminary API-documentation and package-management tools included.
9300
9301 Known issues:
9302
9303    * Documentation is incomplete.
9304
9305    * Performance is below intended target.
9306
9307    * Standard library APIs are subject to extensive change, reorganization.
9308
9309    * Language-level versioning is not yet operational - future code will
9310      break unexpectedly.